v10.1.0

What's Changed

Minor Changes

• Add missing API wrapper methods for full OpenAPI spec coverage:
  • getNFTCollection() -- get the collection an NFT belongs to
  • getNFTMetadata() -- get raw NFT metadata (name, description, image, traits)
  • Expose fulfillPrivateOrder() as a public method on OpenSeaSDK

Full Changelog: ProjectOpenSea/opensea-devtools@sdk-v10.0.0...sdk-v10.1.0

v10.0.0

@opensea/sdk v10.0.0

Viem Support

• New @opensea/sdk/viem subpath export with native PublicClient/WalletClient support
• Provider abstraction types: OpenSeaSigner, OpenSeaProvider, ContractCaller, OpenSeaWallet

Breaking Changes

• OrderSide.LISTING value changed from "ask" to "listing"
• OrderSide.OFFER value changed from "bid" to "offer"
• BigNumberish type replaced with Amount (string | number | bigint)
• Overrides type replaced with Record<string, unknown>
• provider public property removed from OpenSeaSDK class
• estimateGas utility function removed
• TypeChain dependency removed
• ethers.FetchRequest replaced with native fetch()

New Utilities

• ZERO_ADDRESS and MAX_UINT256 exported from constants
• checksumAddress, parseUnits, parseEther utilities

Full Changelog: v9.0.0...v10.0.0

v9.0.0

What's Changed

Package renamed: opensea-js -> @opensea/sdk

The npm package has been renamed from opensea-js to @opensea/sdk. The API is completely unchanged.

npm uninstall opensea-js
npm install @opensea/sdk

Update your imports:

// Before
import { OpenSeaSDK, Chain } from "opensea-js";

// After
import { OpenSeaSDK, Chain } from "@opensea/sdk";

The old opensea-js package is deprecated and will show a migration notice on install.

Full Changelog: ProjectOpenSea/opensea-devtools@sdk-v8.1.0...sdk-v9.0.0

v8.1.0

What's Changed

• DropsAPI: New class with methods for upcoming drops, drop details, and minting
• CollectionsAPI: New trending and top methods for discovering collections
• AccountsAPI: New resolve method for ENS/address/username lookup
• Chain codegen: Replace hardcoded chain IDs with codegen from OpenSea REST API
• Bug fix: Blast chain ID corrected from 238 (testnet) to 81457 (mainnet)

Full Changelog: ProjectOpenSea/opensea-devtools@sdk-v8.0.20...sdk-v8.1.0

v8.0.20

What's Changed

• fix(developerDocs): incorrect MatchOrders event payload in SDK events… by @jeffbrownn in #1941
• fix: harden Retry-After parsing, fix and audit all docs by @ryanio in #1944
• fix(malformed): Retry-After header parsing by @farquadars in #1942
• feat: add criteria field to BuildOfferResponse type by @ryanio in #1943
• docs: update all documentation to latest API methods by @ryanio in #1945

New Contributors

• @farquadars made their first contribution in #1942
• @jeffbrownn made their first contribution in #1941

Full Changelog: v8.0.19...v8.0.20

v8.0.19

What's Changed

• feat: add postListing/postOffer API methods, deprecate legacy order endpoints by @ryanio in #1936

Deps

• chore(deps): upgrade dependencies by @ryanio in #1933
• chore(deps): upgrade ESLint 8 → 10 (flat config) and chai 4 → 6 by @ryanio in #1934
• chore(deps): bump @opensea/seaport-js to ^4.0.7 by @ryanio in #1937

Full Changelog: v8.0.18...v8.0.19

v8.0.18

What's Changed

• fix(orders): fix nullish coalescing on toString in getNFTItems by @Viktohblake and @ryanio in #1928
• fix: add ORDER event type to AssetEventType enum by @MuhammadMinhaj and @ryanio in #1929
• Update documentation to match current SDK state by @ryanio in #1919
• chore: bump version to 8.0.18 by @ryanio in #1930

Deps

• chore(deps): update dependency @types/node to v24.11.0 by @renovate[bot] in #1920
• chore(deps): update node.js to v24.14.0 by @renovate[bot] in #1921
• chore(deps): update dependency sinon to v21.0.2 by @renovate[bot] in #1923
• chore(deps): update dependency @types/node to v24.12.0 by @renovate[bot] in #1924
• chore(deps): update dependency nyc to v18 by @renovate[bot] in #1925
• chore(deps): upgrade mocha 10 → 11 by @ryanio in #1932

Full Changelog: v8.0.17...v8.0.18

v8.0.17

What's Changed

• Add Search API endpoint by @ryanio in #1918

Full Changelog: v8.0.16...v8.0.17

v8.0.16

What's Changed

• Add Token API endpoints by @ryanio in #1915
• Add numeric trait support for collection offers by @ryanio in #1914
• Change OrderStatus enum values to uppercase by @ryanio in #1903
• Fix incorrect OrderSide in createCollectionOffer price validation by @ryanio in #1916

Docs fixes

• Fix API reference examples to use correct camelCase properties by @ryanio in #1917
• fix: correct return type for getOrderByHash by @pineapplepeak in #1912
• fix(docs): correct anchor link for Chain enum by @evshank in #1906
• Fix examples using getOrder with orderHash -> use getOrderByHash in OpenSea SDK docs by @meelon-dev in #1910
• use asset object in createListing by @binarycryptodev in #1905

New Contributors

• @binarycryptodev made their first contribution in #1905
• @evshank made their first contribution in #1906
• @meelon-dev made their first contribution in #1910
• @pineapplepeak made their first contribution in #1912

Full Changelog: v8.0.15...v8.0.16

v8.0.15

What's Changed

Features

• feat(api): add pricing_currencies support and auto-resolve payment tokens by @ryanio in #1895

Bug Fixes

• Fix handleSDKEvents declaration by @CryptAm in #1872
• fix(api): preserve falsy query params in URL serialization by @ryanio in #1875
• fix: clean up MegaETH chain support by @ryanio in #1896
• fix(orders): accept tokenId in eth_price validation by @ryanio in #1897

Docs & Typos

• Fix typo: this methods -> this method in approveOrder JSDoc by @Zentex1337 in #1887
• Fix grammar in TransactionConfirmed JSDoc comment by @Zentex1337 in #1886
• Fix FAQ table of contents heading mismatch by @Zentex1337 in #1885
• docs: add limit range to getCollections API reference by @ryanio in #1898
• docs: add API key security note to API reference by @ryanio in #1899
• Update advanced-use-cases.md with a note about what SignedZone is by @0x4tl4nt in #1877

New Contributors

• @CryptAm made their first contribution in #1872
• @Zentex1337 made their first contribution in #1887
• @0x4tl4nt made their first contribution in #1877

Full Changelog: v8.0.14...v8.0.15