Global Options

Option	Description
`--api-key <key>`	OpenSea API key (or set `OPENSEA_API_KEY` env var)
`--chain <chain>`	Default chain (default: `ethereum`)
`--format <format>`	Output format: `json`, `table`, or `toon` (default: `json`)
`--base-url <url>`	API base URL override (for testing against staging or proxies)
`--timeout <ms>`	Request timeout in milliseconds (default: `30000`)
`--verbose`	Log request and response info to stderr
`--fields <fields>`	Comma-separated list of fields to include in output
`--max-lines <n>`	Maximum number of output lines

Collections

opensea collections get <slug>
opensea collections list [--chain <chain>] [--order-by <field>] [--creator <username>] [--include-hidden] [--limit <n>] [--next <cursor>]
opensea collections stats <slug>
opensea collections traits <slug>

Subcommand	Description
`get <slug>`	Get details for a single collection
`list`	List collections with optional filters
`stats <slug>`	Get floor price, volume, and other stats
`traits <slug>`	Get all traits and their values

--order-by values: created_date, one_day_change, seven_day_volume, seven_day_change, num_owners, market_cap

NFTs

opensea nfts get <chain> <contract> <token-id>
opensea nfts list-by-collection <slug> [--limit <n>] [--next <cursor>]
opensea nfts list-by-contract <chain> <contract> [--limit <n>] [--next <cursor>]
opensea nfts list-by-account <chain> <address> [--limit <n>] [--next <cursor>]
opensea nfts refresh <chain> <contract> <token-id>
opensea nfts contract <chain> <address>

Subcommand	Description
`get`	Get a specific NFT by chain, contract address, and token ID
`list-by-collection`	List NFTs in a collection
`list-by-contract`	List NFTs by contract address
`list-by-account`	List NFTs owned by an account
`refresh`	Refresh metadata for a specific NFT
`contract`	Get contract details

Listings

opensea listings all <collection> [--limit <n>] [--next <cursor>]
opensea listings best <collection> [--limit <n>] [--next <cursor>]
opensea listings best-for-nft <collection> <token-id>

Subcommand	Description
`all`	Get all listings for a collection
`best`	Get the best (cheapest) listings for a collection
`best-for-nft`	Get the best listing for a specific NFT

Offers

opensea offers all <collection> [--limit <n>] [--next <cursor>]
opensea offers collection <collection> [--limit <n>] [--next <cursor>]
opensea offers best-for-nft <collection> <token-id>
opensea offers traits <collection> --type <type> --value <value> [--limit <n>] [--next <cursor>]

Subcommand	Description
`all`	Get all offers for a collection
`collection`	Get collection-level offers
`best-for-nft`	Get the best offer for a specific NFT
`traits`	Get trait-based offers (requires `--type` and `--value`)

Events

opensea events list [--event-type <type>] [--after <timestamp>] [--before <timestamp>] [--chain <chain>] [--limit <n>] [--next <cursor>]
opensea events by-account <address> [--event-type <type>] [--chain <chain>] [--limit <n>] [--next <cursor>]
opensea events by-collection <slug> [--event-type <type>] [--limit <n>] [--next <cursor>]
opensea events by-nft <chain> <contract> <token-id> [--event-type <type>] [--limit <n>] [--next <cursor>]

Subcommand	Description
`list`	List recent events across all collections
`by-account`	Get events for a specific account
`by-collection`	Get events for a specific collection
`by-nft`	Get events for a specific NFT

Event types: sale, transfer, mint, listing, offer, trait_offer, collection_offer (see Event Types)

Search

opensea search <query> [--types <types>] [--chains <chains>] [--limit <n>]

Option	Description
`<query>`	Search query string
`--types`	Filter by type (comma-separated): `collection`, `nft`, `token`, `account`
`--chains`	Filter by chains (comma-separated)
`--limit`	Number of results (default: `20`, max: `50`)

The search command does not support cursor-based pagination.

Tokens

opensea tokens trending [--chains <chains>] [--limit <n>] [--next <cursor>]
opensea tokens top [--chains <chains>] [--limit <n>] [--next <cursor>]
opensea tokens get <chain> <address>

Subcommand	Description
`trending`	Get trending tokens, optionally filtered by chain
`top`	Get top tokens by 24-hour volume
`get`	Get details for a specific token by chain and address

Swaps

opensea swaps quote --from-chain <chain> --from-address <address> --to-chain <chain> --to-address <address> --quantity <quantity> --address <address> [--slippage <slippage>] [--recipient <recipient>]

Option	Description
`--from-chain`	Source chain
`--from-address`	Source token contract address
`--to-chain`	Destination chain
`--to-address`	Destination token contract address
`--quantity`	Amount to swap (in token base units)
`--address`	Wallet address performing the swap
`--slippage`	Slippage tolerance (e.g. `0.01` for 1%)
`--recipient`	Recipient address (if different from `--address`)

Accounts

opensea accounts get <address>

Returns account details for the given wallet address.

Health

opensea health

Checks API connectivity and authentication status. Reports whether the API is reachable, the API key is valid, and whether you are being rate limited.

Exit Codes

Code	Meaning
`0`	Success
`1`	API error (non-429)
`2`	Authentication error (missing API key)
`3`	Rate limited (HTTP 429)