All operations use the OpenSea CLI (@opensea/cli). Install with npm install -g @opensea/cli or use npx @opensea/cli.

Reading NFT Data

These operations correspond to the NFT Endpoints.

Task	CLI Command
Get collection details	`opensea collections get <slug>`
Get collection stats (floor price, volume)	`opensea collections stats <slug>`
Get collection traits	`opensea collections traits <slug>`
List NFTs in collection	`opensea nfts list-by-collection <slug> [--limit <n>]`
Get single NFT	`opensea nfts get <chain> <contract> <token_id>`
List NFTs by wallet	`opensea nfts list-by-account <chain> <address> [--limit <n>]`
List NFTs by contract	`opensea nfts list-by-contract <chain> <contract> [--limit <n>]`
Get contract details	`opensea nfts contract <chain> <address>`
Refresh NFT metadata	`opensea nfts refresh <chain> <contract> <token_id>`

Examples

# Get collection details
opensea collections get pudgypenguins

# Get floor price and volume stats
opensea collections stats boredapeyachtclub

# Get a specific NFT
opensea nfts get ethereum 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d 1234

# List NFTs owned by a wallet
opensea nfts list-by-account ethereum 0x1234...abcd --limit 10

Marketplace Queries

These operations correspond to the Marketplace Endpoints.

Task	CLI Command
Get best listings for collection	`opensea listings best <slug> [--limit <n>]`
Get best listing for specific NFT	`opensea listings best-for-nft <slug> <token_id>`
Get all listings for collection	`opensea listings all <slug> [--limit <n>]`
Get best offer for NFT	`opensea offers best-for-nft <slug> <token_id>`
Get all offers for collection	`opensea offers all <slug> [--limit <n>]`
Get collection offers	`opensea offers collection <slug> [--limit <n>]`
Get trait offers	`opensea offers traits <slug> --type <type> --value <value>`

Examples

# Get the 5 cheapest listings
opensea listings best azuki --limit 5

# Get the best offer on a specific NFT
opensea offers best-for-nft boredapeyachtclub 1234

# Get all collection-level offers
opensea offers collection pudgypenguins --limit 10

Marketplace Actions

These operations return transaction data for on-chain execution. See the Marketplace Endpoints for full API details.

Task	Shell Script
Get fulfillment data (buy NFT)	`opensea-fulfill-listing.sh <chain> <order_hash> <buyer>`
Get fulfillment data (accept offer)	`opensea-fulfill-offer.sh <chain> <order_hash> <seller> <contract> <token_id>`
Generic POST request	`opensea-post.sh <path> <json_body>`

Buying an NFT

Find the NFT and check its listing:

opensea listings best-for-nft cool-cats-nft 1234

Get the order hash from the response, then get fulfillment data:

./scripts/opensea-fulfill-listing.sh ethereum 0x_order_hash 0x_your_wallet

The response contains transaction data (to, value, input_data) to execute on-chain.

Accepting an Offer

Check offers on your NFT:

opensea offers best-for-nft cool-cats-nft 1234

Get fulfillment data for the offer:

./scripts/opensea-fulfill-offer.sh ethereum 0x_offer_hash 0x_your_wallet 0x_nft_contract 1234

Execute the returned transaction data on-chain.

Creating Listings and Offers

Creating new listings and offers requires wallet signatures via the Seaport protocol. Use opensea-post.sh with the Seaport order structure. See the Seaport documentation for details on order construction.

Token Swaps

These operations correspond to the Token Endpoints.

OpenSea's API includes a cross-chain DEX aggregator for swapping ERC20 tokens with optimal routing.

Task	CLI Command
Get swap quote with calldata	`opensea swaps quote --from-chain <chain> --from-address <addr> --to-chain <chain> --to-address <addr> --quantity <qty> --address <wallet>`
Get trending tokens	`opensea tokens trending [--chains <chains>] [--limit <n>]`
Get top tokens by volume	`opensea tokens top [--chains <chains>] [--limit <n>]`
Get token details	`opensea tokens get <chain> <address>`

Examples

# Get a swap quote (ETH to a token on Base)
opensea swaps quote \
  --from-chain base --from-address 0x0000000000000000000000000000000000000000 \
  --to-chain base --to-address 0xTokenAddress \
  --quantity 0.02 --address 0xYourWallet

# Get trending tokens
opensea tokens trending --limit 5

# Get top tokens by 24h volume on Base
opensea tokens top --chains base --limit 10

The swap quote response includes:

swapQuote: Price info, fees, and slippage impact
swap.actions[0].transactionSubmissionData: Ready-to-use calldata (to, data, value) for on-chain execution

Search

These operations correspond to the Search Endpoints.

Task	CLI Command
Search collections	`opensea search <query> --types collection`
Search NFTs	`opensea search <query> --types nft`
Search tokens	`opensea search <query> --types token`
Search accounts	`opensea search <query> --types account`
Search multiple types	`opensea search <query> --types collection,nft,token`
Search on specific chain	`opensea search <query> --chains base,ethereum`

Examples

# Search for collections
opensea search "cool cats" --types collection

# Search for tokens on Base
opensea search "usdc" --types token --chains base

Events and Monitoring

These operations correspond to the Analytics Endpoints.

Task	CLI Command
List recent events	`opensea events list [--event-type <type>] [--limit <n>]`
Get collection events	`opensea events by-collection <slug> [--event-type <type>]`
Get events for specific NFT	`opensea events by-nft <chain> <contract> <token_id>`
Get events for account	`opensea events by-account <address>`

Event types: sale, transfer, mint, listing, offer, trait_offer, collection_offer

Examples

# Get recent sales for a collection
opensea events by-collection boredapeyachtclub --event-type sale --limit 10

# Get all events for a specific NFT
opensea events by-nft ethereum 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d 1234

Accounts

Task	CLI Command
Get account details	`opensea accounts get <address>`