v1.3.0

What's Changed

Minor release with two changes.

Server-side trait filtering (patch)

New --traits <json> flag on three collection-scoped commands:

opensea nfts list-by-collection doodles-official \
  --traits '[{"traitType":"Background","value":"Red"}]'

opensea listings best doodles-official \
  --traits '[{"traitType":"Clothes","value":"Smoking Jacket"}]'

opensea events by-collection doodles-official --event-type sale \
  --traits '[{"traitType":"Background","value":"Red"},{"traitType":"Eyes","value":"Laser"}]'

• Multiple entries are AND-combined server-side.
• 400 if a single trait matches more than 1000 items.
• Programmatic SDK methods (client.nfts.listByCollection, client.listings.best, client.events.byCollection) accept a structured TraitFilter[] array.

Wallet-adapters refactor (minor)

Wallet adapter implementations (Privy, Turnkey, Fireblocks, PrivateKey) now come from the shared @opensea/wallet-adapters package. ~1200 lines of duplicated code removed. The CLI re-exports all wallet types and adapters from @opensea/wallet-adapters alongside the CLI-specific chain resolution utilities (CHAIN_IDS, resolveChainId).

Full Changelog: ProjectOpenSea/opensea-devtools@cli-v1.2.0...cli-v1.3.0

v1.2.0

What's Changed

Add token-groups and auth commands.

• New opensea token-groups list [--limit <n>] [--next <cursor>] command.
• New opensea token-groups get <slug> command.
• New opensea auth request-key command — works without --api-key / OPENSEA_API_KEY since the endpoint is unauthenticated. Useful for bootstrapping a key.

Full Changelog: ProjectOpenSea/opensea-devtools@cli-v1.1.0...cli-v1.2.0

v1.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@cli-v1.0.1...cli-v1.1.0

v1.0.1

What's Changed

• Fix --version to report the correct package version (was showing 0.0.0)
• Auto-convert decimal quantities in swap commands (e.g. 0.001 ETH is converted to smallest units automatically)
• Move quantity resolution logic to SDK layer

Full Changelog: ProjectOpenSea/opensea-devtools@cli-v1.0.0...cli-v1.0.1

v1.0.0

What's Changed

CLI v1.0.0

• Multi-provider wallet adapters: Privy (default), Turnkey, Fireblocks, and Private Key support for signing and executing transactions
• Token swaps: quote and execute commands with --wallet-provider flag and auto-detection
• Drops command: Browse upcoming drops, get drop details, mint NFTs
• Collections trending/top: Discover trending and top collections by volume
• Accounts resolve: ENS/address/username resolution
• Chain codegen: 27+ chains auto-generated from OpenSea REST API
• SDK exports: WalletAdapter, SwapsAPI, createWalletFromEnv available for programmatic use

Full Changelog: ProjectOpenSea/opensea-devtools@cli-v0.4.2...cli-v1.0.0

v0.4.2

What's Changed

• feat: add User-Agent header to all HTTP requests (DIS-41) by @ckorhonen in #34
• feat: add exit code 3 for rate limiting (DIS-146) by @ckorhonen in #36
• feat: add --fields and --max-lines global CLI options (DIS-145) by @ckorhonen in #38
• feat: add opensea health diagnostic command (DIS-144) by @ckorhonen in #35
• feat: add retry with exponential backoff in client.ts (DIS-143) by @ckorhonen in #37
• chore: bump version to 0.4.2 for npm publish by @ckorhonen in #42

New Contributors

• @ckorhonen made their first contribution in #34

Full Changelog: v0.4.1...v0.4.2

v0.4.1

What's Changed

• feat: replace GraphQL search with REST API search endpoint by @ryanio in #33
• docs: update Global Options to match real CLI by @binarycryptodev in #32

New Contributors

• @binarycryptodev made their first contribution in #32

Full Changelog: v0.4.0...v0.4.1

v0.4.0

What's Changed

• fix: pagination docs table formatting by @ryanio in #29
• feat: add TOON output format for LLM-efficient data serialization by @CodySearsOS in #30

Full Changelog: v0.3.0...v0.4.0

v0.3.0

What's Changed

• docs: restructure README into concise overview with docs/ reference pages by @ryanio in #26
• Make pagination consistent (use next cursor everywhere) by @ryanio in #27
• feat: add error handling, validation, timeout, and verbose mode by @ryanio in #28

Full Changelog: v0.2.1...v0.3.0

v0.2.1

What's Changed

• Rename package to @opensea/cli with stub redirect by @ryanio in #24
• chore: bump version to 0.2.1 by @ryanio in #25

Full Changelog: v0.1.6...v0.2.1