Query OpenSea marketplace data via the official CLI, MCP server, or shell scripts. Get floor prices, collection stats, NFT details, token data, trending collections, drops, events, and search across Ethereum, Base, Arbitrum, Polygon, and more. Read-only operations; for trading use opensea-marketplace, for token swaps use opensea-swaps.
SkillScore100Maintained
Automatic
◆Coding pack
Last verified 8/15/2026
What it changes
Passed 22 of 22 test cases with the skill, and 3 of 22 without it.
Without skill14%
With skill100%
Checks it passed that the model alone missed
The response includes the --traits flag.
The response identifies the --format toon flag.
The response specifies opensea token-groups list.
and 25 more in the full report
19 fixed3 passed either way0 still failing0 broke
Pass-rate lift
+86 pp
Tokens
+286%
Agent turns
0%
Response time
-66%
Model gemini-3.6-flashMeasured 8/15/2026v122 of 22 cases passed with skill
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 19 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 19
Prompt
I want to retrieve upcoming NFT drops ordered chronologically using the OpenSea MCP server. Which MCP tool provides this, and what parameter is used for cursor pagination?
What was checked, without and with the skill
Checked
Without skill
With skill
The response identifies get_upcoming_drops as the MCP tool.
Missed
Passed
The response identifies after as the pagination cursor parameter.
Missed
Passed
case-21 · gemini-3.6-flash · 8/15/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md499 lines28 filesincludes scripts
OpenSea API
Query NFT and token data, browse drops, stream events, and search across Ethereum, Base, Arbitrum, Optimism, Polygon, and more.
When to use this skill (scope_in)
Use opensea-api for read-only operations:
Collection details, stats, traits, trending, and top collections
NFT details, ownership, metadata refresh
Token details, trending tokens, top tokens, token groups
Search across collections, NFTs, tokens, and accounts
Reading marketplace listings, offers, and orders (not executing them)
Events and activity monitoring (including real-time WebSocket streams)
Drops and mint eligibility
Account lookups and ENS resolution
When NOT to use this skill (scope_out, handoff)
Need
Use instead
Buy/sell NFTs (fulfill listings or offers)
opensea-marketplace
Create new listings or offers
opensea-marketplace
Cross-chain NFT purchases
opensea-marketplace
Swap ERC20 tokens
opensea-swaps
Set up wallet signing providers
opensea-wallet
Build/register/gate AI agent tools
opensea-tool-sdk
Quick start
# Get an instant free-tier API key (no signup needed)
export OPENSEA_API_KEY=$(curl -s -X POST https://api.opensea.io/api/v2/auth/keys | jq -r '.api_key')
# Install the CLI globally (or use npx)
npm install -g @opensea/cli
# Get collection info
opensea collections get boredapeyachtclub