Skip to content

v0.3.0

Latest

Choose a tag to compare

@ryanio ryanio released this 07 May 22:49

What's Changed

Sync of the OpenSea OpenAPI spec — bundles two os2-core PRs and four new endpoints picked up since the last release.

Removed (os2-core#40171)

  • GET /api/v2/orders/{chain}/{protocol}/offers — use GET /api/v2/offers/collection/{slug}/all (or /nfts/{identifier} for per-NFT)
  • GET /api/v2/orders/{chain}/{protocol}/listings — use GET /api/v2/listings/collection/{slug}/all (or /nfts/{identifier}/best for per-NFT)
  • order wrapper field from POST /orders/{chain}/{protocol}/{offers,listings} responses — endpoints now return bare Offer / Listing
  • Criteria.trait (singular) — use Criteria.traits[]
  • IntervalStat.{volume_diff, volume_change, sales_diff, average_price} (always returned 0)
  • Total.{market_cap, average_price} (always returned 0)
  • Schemas: OrdersResponse, CreateOfferResponse, CreateListingResponse, SimpleOrderV2Serializer, V1ProtocolData, SimpleAccount. Named re-exports for OrdersResponse, CreateOfferResponse, CreateListingResponse, V1ProtocolData, and SimpleAccount removed from src/index.ts.

Added (os2-core#40190)

  • Optional maker query param on GET /api/v2/offers/collection/{slug}/all and GET /api/v2/listings/collection/{slug}/all

New endpoints

  • POST /api/v2/listings/sweep — bulk-buy from a collection. Types: SweepCollectionRequest, SweepCollectionResponse.
  • GET /api/v2/offers/collection/{slug}/nfts/{identifier} — all offers for one NFT.
  • POST /api/v2/swap/execute — multi-asset companion to /swap/quote. Types: SwapExecuteRequest, SwapExecuteResponse, SwapQuoteInput.
  • POST /api/v2/transactions/receipt — fetch transaction status. Types: TransactionReceiptRequest, TransactionReceiptResponse.

Downstream impact

@opensea/sdk@10.4.0 and @opensea/cli@1.6.0 (released alongside) drop the methods backed by the removed endpoints, fix POST shapes, and surface the four new endpoints. Migration paths are documented in their changelogs.

Full Changelog: ProjectOpenSea/opensea-devtools@api-types-v0.2.3...api-types-v0.3.0