opensea
Query NFT data, trade on the Seaport marketplace, and swap ERC20 tokens across Ethereum, Base, Arbitrum, Optimism, Polygon, and more.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/dfinzer/opensea-skillOpenSea API
Query NFT data, trade on the Seaport marketplace, and swap ERC20 tokens across Ethereum, Base, Arbitrum, Optimism, Polygon, and more.
Quick start
- Set
OPENSEA_API_KEYin your environment - Preferred: Use the
openseaCLI (@opensea/cli) for all queries and operations - Alternatively, use the shell scripts in
scripts/or the MCP server
export OPENSEA_API_KEY="your-api-key"
# Install the CLI globally (or use npx)
npm install -g @opensea/cli
# Get collection info
opensea collections get boredapeyachtclub
# Get floor price and volume stats
opensea collections stats boredapeyachtclub
# Get NFT details
opensea nfts get ethereum 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d 1234
# Get best listings for a collection
opensea listings best boredapeyachtclub --limit 5
# Search across OpenSea
opensea search "cool cats"
# Get trending tokens
opensea tokens trending --limit 5
# Get a swap quote
opensea swaps quote \
--from-chain base --from-address 0x0000000000000000000000000000000000000000 \
--to-chain base --to-address 0xTokenAddress \
--quantity 0.02 --address 0xYourWallet
Task guide
Recommended: Use the
openseaCLI (@opensea/cli) as your primary tool. It covers all the operations below with a consistent interface, structured output, and built-in pagination. Install withnpm install -g @opensea/clior usenpx @opensea/cli. The shell scripts inscripts/remain available as alternatives.
Token swaps
OpenSea's API includes a cross-chain DEX aggregator for swapping ERC20 tokens with optimal routing across all supported chains.
| Task | CLI Command | Alternative |
|---|---|---|
| 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_token_swap_quote (MCP) or opensea-swap.sh |
| Get trending tokens | opensea tokens trending [--chains <chains>] [--limit <n>] | get_trending_tokens (MCP) |
| Get top tokens by volume | opensea tokens top [--chains <chains>] [--limit <n>] | get_top_tokens (MCP) |
| Get token details | opensea tokens get <chain> <address> | get_tokens (MCP) |
| Search tokens | opensea search <query> --types token | search_tokens (MCP) |
| Check token balances | get_token_balances (MCP) | — |
Reading NFT data
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-dfinzer-opensea-skill": {
"enabled": true,
"auto_update": true
}
}
}