v1.5.0

What's Changed

New opensea wallet command group for inspecting and provisioning wallets with hardening as the default path.

New commands

• opensea wallet info — provider-aware posture readout. Calls the wallet adapter's getWalletInfo() and prints a structured JSON block to stdout plus loud warnings to stderr when hardening gaps are detected: missing Privy owner_id, missing policy IDs, Turnkey API user that's in the root quorum, etc. For Fireblocks and Bankr (no role/scope introspection endpoints), prints a static reminder to verify at the console.
• opensea wallet create — Privy-only. Calls POST /v1/wallets with optional --owner-public-key so a new wallet starts hardened from creation. Narrow mutation surface: creates new resources only, cannot touch existing wallets.
• opensea wallet generate-auth-key — pure-local P-256 keypair generation via node:crypto, no API calls. Outputs PKCS8/SPKI base64 — register the public key with Privy as additional_signer or owner; set the private key as PRIVY_AUTH_SIGNING_KEY (additional_signer) or keep it off the agent host (owner).

Pairs with @opensea/wallet-adapters@0.3.0, which adds the getWalletInfo() adapter API and optional PRIVY_AUTH_SIGNING_KEY support.

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

v1.4.2

What's Changed

Re-export BankrAdapter and BankrConfig from @opensea/wallet-adapters (#245). The swaps execute command description now lists Bankr alongside Privy, Turnkey, and Fireblocks. createWalletFromEnv() already auto-detected Bankr when BANKR_API_KEY is set; this just makes the named adapter directly importable from @opensea/cli.

Bumps @opensea/wallet-adapters to ^0.2.1 (which adds the BankrAdapter).

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

v1.4.1

What's Changed

Cross-chain fulfillment types are now sourced from @opensea/api-types instead of being hand-rolled in src/types/api.ts. Type names align with the canonical OpenAPI schema names (#242):

• CrossChainFulfillmentTransaction → SwapTransactionResponse
• CrossChainFulfillmentDataResponse → CrossChainFulfillmentResponse

The listings cross-chain-fulfill command behavior is unchanged.

Full Changelog: ProjectOpenSea/opensea-devtools@cli-v1.4.0...cli-v1.4.1

v1.4.0

What's Changed

Cross-chain fulfillment

New listings cross-chain-fulfill subcommand for buying NFTs using tokens from a different chain (e.g., USDC on Base → ETH mainnet NFT). Supports sweeping multiple listings via comma-separated hashes.

opensea listings cross-chain-fulfill \
  --hashes <hash1>,<hash2> \
  --listing-chain ethereum \
  --protocol-address 0x... \
  --fulfiller 0x... \
  --payment-chain base \
  --payment-token <usdc-address> \
  [--recipient 0x...]

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

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