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— useGET /api/v2/offers/collection/{slug}/all(or/nfts/{identifier}for per-NFT)GET /api/v2/orders/{chain}/{protocol}/listings— useGET /api/v2/listings/collection/{slug}/all(or/nfts/{identifier}/bestfor per-NFT)orderwrapper field fromPOST /orders/{chain}/{protocol}/{offers,listings}responses — endpoints now return bareOffer/ListingCriteria.trait(singular) — useCriteria.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 forOrdersResponse,CreateOfferResponse,CreateListingResponse,V1ProtocolData, andSimpleAccountremoved fromsrc/index.ts.
Added (os2-core#40190)
- Optional
makerquery param onGET /api/v2/offers/collection/{slug}/allandGET /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