v1.10.0

What's Changed

• Add the opensea tools command for searching, listing, and inspecting registered AI agent tools (ERC-8257). New search, get, and list subcommands wrap the [Beta] tool registry API, with matching OpenSeaCLI SDK methods (client.tools.search, client.tools.get, client.tools.list) and RegisteredToolResponse / ToolSearchPaginatedResponse / ToolListPaginatedResponse type re-exports sourced from @opensea/api-types.
• Consumes @opensea/api-types@0.4.4.

Full Changelog: ProjectOpenSea/opensea-devtools@cli-v1.9.0...cli-v1.10.0

v1.9.0

What's Changed

Expose the two new token endpoints from @opensea/api-types 0.4.3.

New CLI subcommands

• opensea tokens holders <chain> <address> [--limit] [--next] [--sort-by] [--sort-direction] — paginated token holders with aggregate distribution health (STRONG | HEALTHY | CONCERNING | BAD).
• opensea tokens liquidity-pools <chain> <address> [--limit] — liquidity pools with pool type, USD reserves, bonding-curve progress, graduation flag.

SDK additions (@opensea/cli programmatic API)

• OpenSeaCLI.tokens.holders(chain, address, options?)
• OpenSeaCLI.tokens.liquidityPools(chain, address, options?)
• New type re-exports: TokenHoldersResponse, TokenLiquidityPoolsResponse.

Also bumps @opensea/api-types dependency to 0.4.3.

Full Changelog: ProjectOpenSea/opensea-devtools@cli-v1.8.0...cli-v1.9.0

v1.8.0

What's Changed

Minor

• Source response types from @opensea/api-types (#341). EventAsset, AssetEvent, Token, TokenDetails, TokenStats, TokenSocials, ChainInfo, ChainListResponse, TokenBalance, Search*, SwapQuote, and SwapQuoteResponse are now aliases for their api-types counterparts. Field shapes match what the live API returns; a few types gain fields the spec already documented (TokenDetails.status, TokenBalance.{status,base_token_liquidity_usd,quote_token_liquidity_usd}, SwapQuote.{price_impact,swap_provider,costs,route_errors}).

  Migration: Most consumers won't need any changes. The one notable case is AssetEvent, which is now OrderEvent | SaleEvent | TransferEvent — code that reads arbitrary fields off an event will need to narrow on event_type first:

  // Before
  const seller = event.seller as string;
  
  // After
  if (event.event_type === "sale") {
    const seller = event.seller; // typed as string
  }

• Switch --format toon to server-side TOON encoding (#326). The client-side encoder (src/toon.ts and formatToon) is gone now that os2-core supports TOON encoding server-side via Accept: text/markdown. --format toon still works — it just triggers a getAsMarkdown call instead of running a 338-line encoder client-side. Note: formatToon is no longer exported from @opensea/cli.

Patch

• Bumped @opensea/api-types dependency to 0.4.2 (#343 — adds named exports for BuildOfferResponse, CancelRequest, CancelResponse, PartialParameters).

Full Changelog: ProjectOpenSea/opensea-devtools@cli-v1.7.0...cli-v1.8.0

v1.7.0

What's Changed

Surface the 22 new endpoints added in @opensea/api-types@0.4.0 as CLI commands.

New subcommands on existing verbs:

• opensea accounts portfolio | portfolio-history | offers | offers-received | listings | favorites | collections
• opensea collections batch | offer-aggregates | holders | floor-prices
• opensea nfts batch | owners | analytics
• opensea tokens batch | price-history | ohlcv | activity
• opensea listings actions
• opensea drops deploy | deploy-receipt

New top-level domain:

• opensea assets transfer — build transactions to transfer NFTs or tokens between wallets

SDK class methods mirroring the same surface added to OpenSeaCLI. New readJsonBodyOption helper wraps --body <path> reads with friendly error messages instead of raw Node stack traces. Pure additive on the API surface.

Full Changelog: ProjectOpenSea/opensea-devtools@cli-v1.6.0...cli-v1.7.0

v1.6.0

What's Changed

Surfaces the new endpoints introduced in @opensea/api-types@0.3.0 and aligns with deprecation removals.

Removed

• OrdersResponse and SimpleAccount re-exports from src/types/api.ts (schemas no longer exist upstream).

Added

• offers all and listings all accept --maker <address> to filter by order maker.
• New commands:
  • listings sweep — bulk-buy items from a collection with any payment token (--collection, --max-items, --max-price-per-item, --buyer, --payment-chain, --payment-token, --recipient).
  • offers by-nft <collection> <token-id> — all offers for a specific NFT.
  • transactions receipt --request <file> — fetch transaction status (request body via JSON file).
• New SDK helpers: OpenSeaCLI.transactions: TransactionsAPI, SwapsAPI.executeMulti(request) for POST /swap/execute.

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

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