Skip to content

v10.4.0

Choose a tag to compare

@ryanio ryanio released this 07 May 22:51
· 43 commits to main since this release

What's Changed

Aligns @opensea/sdk with the API surface introduced in @opensea/api-types@0.3.0 (os2-core#40171 + #40190).

Removed (breaking)

The underlying GET endpoints were deleted upstream — these methods would return 404 against the new API:

Method Why Replacement
getOrder, getOrders, postOrder already @deprecated; backing path deleted getBest{Offer,Listing} / getAll{Offers,Listings} / post{Offer,Listing}
getNFTOffers(contract, tokenId) endpoint deleted getOffersByNFT(slug, tokenId) (new)
getNFTListings(contract, tokenId) no per-NFT all-listings endpoint exists getBestListing(slug, tokenId) for one, or getAllListings(slug) + filter

Behavior changes

  • postListing / postOffer now read the bare Listing / Offer response (the upstream order wrapper field was removed).
  • OpenSeaSDK.createOffer returns Promise<Offer> (was Promise<OrderV2>).
  • OpenSeaSDK.createListing returns Promise<Listing> (was Promise<OrderV2>).
  • createBulkListings / createBulkOffers return BulkOrderResult<Listing> / BulkOrderResult<Offer>. BulkOrderResult is now generic in the success type.

New methods

  • getOffersByNFT(slug, identifier, limit?, next?) — all offers for one NFT.
  • sweepCollection(request) — bulk-buy with any payment token (incl. cross-chain).
  • executeSwap(request) — multi-asset companion to getSwapQuote.
  • getTransactionReceipt(request) — fetch tx status.
  • New TransactionsAPI sub-client.

Cleanup

  • Helpers getOrdersAPIPath, serializeOrdersQueryOptions, deserializeOrder removed.
  • Types OrderAPIOptions, OrdersQueryOptions, OrdersQueryResponse, OrdersPostQueryResponse, ListingPostQueryResponse, OfferPostQueryResponse, SerializedOrderV2, GetOrdersResponse removed.
  • IntervalStat.{volume_diff, volume_change, sales_diff, average_price} and Stats.{market_cap, average_price} removed.

Full Changelog: v10.3.1...v10.4.0