opensea-api
API key for all OpenSea services (REST API, CLI, SDK, and MCP server)
Install / Use
npx skills add BankrBot/skills --skill opensea-apiInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of opensea-api
opensea-api scores 90/100 on our quality scale, 1392nd of 4,698 Development & Engineering skills we index (top 30%).
Its SKILL.md is 21 KB long, well organised into 61 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.
With 1,201 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so opensea-api is actively maintained.
- Our last check on 2026-10-30 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
opensea-api compared with similar skills
All 4 of these similar skills score higher than opensea-api; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| opensea-api (this skill)by BankrBot | 90 | 1.2k | 54d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install opensea-api?
- Run
npx skills add BankrBot/skills --skill opensea-api. The install tabs above show the steps for each supported agent. - Which AI agents does opensea-api work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is opensea-api safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is opensea-api still maintained?
- The repository was last updated about 2 months ago, so opensea-api is actively maintained.
Skill content
View source on GitHubname: opensea-api description: 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. homepage: https://github.com/ProjectOpenSea/opensea-skill repository: https://github.com/ProjectOpenSea/opensea-skill license: MIT env: OPENSEA_API_KEY: description: API key for all OpenSea services (REST API, CLI, SDK, and MCP server) required: true obtain: https://docs.opensea.io/reference/api-keys#instant-api-key-for-agents dependencies:
- node >= 18.0.0
- curl
- jq (recommended)
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
# Get floor price and volume stats
opensea collections stats boredapeyachtclub
# Get NFT details
opensea nfts get ethereum 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d 1234
# Search across OpenSea
opensea search "cool cats"
# Get trending tokens
opensea tokens trending --limit 5
Task guide
Recommended: Use the
openseaCLI (@opensea/cli) as your primary tool. Install withnpm install -g @opensea/clior usenpx @opensea/cli. The shell scripts inscripts/remain available as alternatives.
Reading NFT data
| Task | CLI Command | Alternative |
|------|------------|-------------|
| Get collection details | opensea collections get <slug> | opensea-collection.sh <slug> |
| Get collection stats | opensea collections stats <slug> | opensea-collection-stats.sh <slug> |
| Get trending collections | opensea collections trending [--timeframe <tf>] [--chains <chains>] | opensea-collections-trending.sh [timeframe] [limit] [chains] [category] |
| Get top collections | opensea collections top [--sort-by <field>] [--chains <chains>] | opensea-collections-top.sh [sort_by] [limit] [chains] [category] |
| List NFTs in collection | opensea nfts list-by-collection <slug> [--limit <n>] [--traits <json>] | opensea-collection-nfts.sh <slug> [limit] [next] |
| Get single NFT | opensea nfts get <chain> <contract> <token_id> | opensea-nft.sh <chain> <contract> <token_id> |
| List NFTs by wallet | opensea nfts list-by-account <chain> <address> [--limit <n>] | opensea-account-nfts.sh <chain> <address> [limit] |
| List NFTs by contract | opensea nfts list-by-contract <chain> <contract> [--limit <n>] | |
| Get collection traits | opensea collections traits <slug> | |
| Get contract details | opensea nfts contract <chain> <address> | |
| Refresh NFT metadata | opensea nfts refresh <chain> <contract> <token_id> | |
Reading token data
| Task | CLI Command | Alternative |
|------|------------|-------------|
| 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) |
| List token groups | opensea token-groups list [--limit <n>] [--next <cursor>] | opensea-token-groups.sh [limit] [cursor] |
| Get token group by slug | opensea token-groups get <slug> | opensea-token-group.sh <slug> |
| Search tokens | opensea search <query> --types token | search_tokens (MCP) |
| Check token balances | get_token_balances (MCP) | |
| Request instant API key | opensea auth request-key | opensea-auth-request-key.sh |
Marketplace queries (read-only)
| Task | CLI Command | Alternative |
|------|------------|-------------|
| Get best listings for collection | opensea listings best <slug> [--limit <n>] [--traits <json>] | opensea-best-listing.sh <slug> <token_id> |
| Get best listing for specific NFT | opensea listings best-for-nft <slug> <token_id> | opensea-best-listing.sh <slug> <token_id> |
| Get best offer for NFT | opensea offers best-for-nft <slug> <token_id> | opensea-best-offer.sh <slug> <token_id> |
| List all collection listings | opensea listings all <slug> [--limit <n>] | opensea-listings-collection.sh <slug> [limit] |
| List all collection offers | opensea offers all <slug> [--limit <n>] | opensea-offers-collection.sh <slug> [limit] |
| Get collection offers | opensea offers collection <slug> [--limit <n>] | opensea-offers-collection.sh <slug> [limit] |
| Get trait offers | opensea offers traits <slug> --type <type> --value <value> | |
| Get order by hash | | opensea-order.sh <chain> <order_hash> |
Server-side trait filtering
Three collection-scoped endpoints accept a traits query parameter for server-side filtering:
| Endpoint | CLI | SDK |
|---|---|---|
| List NFTs in collection | opensea nfts list-by-collection <slug> --traits <json> | client.nfts.listByCollection(slug, { traits }) |
| Best listings for collection | opensea listings best <slug> --traits <json> | client.listings.best(slug, { traits }) |
| Events for collection | opensea events by-collection <slug> --traits <json> | client.events.byCollection(slug, { traits }) |
--traits takes a JSON-encoded array of { "traitType": string, "value": string } objects. Multiple entries are AND-combined:
opensea nfts list-by-collection doodles-official \
--traits '[{"traitType":"Background","value":"Red"}]'
Always prefer server-side filtering over client-side: paginating the unfiltered set wastes rate-limit budget.
Search
| 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 |
Events and monitoring
| Task | CLI Command | Alternative |
|------|------------|-------------|
| List recent events | opensea events list [--event-type <type>] [--limit <n>] | |
| Get collection events | opensea events by-collection <slug> [--event-type <type>] [--traits <json>] | opensea-events-collection.sh <slug> [event_type] [limit] |
| Get events for specific NFT | opensea events by-nft <chain> <contract> <token_id> | |
| Get events for account | opensea events by-account <address> | |
| Stream real-time events | | opensea-stream-collection.sh <slug> (requires websocat) |
Event types: sale, transfer, mint, listing, offer, trait_offer, collection_offer
Drops & minting
| Task | CLI Command | Alternative |
|------|------------|-------------|
| List drops (featured/upcoming/recent) | opensea drops list [--type <type>] [--chains <chains>] | opensea-drops.sh [type] [limit] [chains] |
| Get drop details and stages | opensea drops get <slug> | opensea-drop.sh <slug> |
| Build mint transaction | opensea drops mint <slug> --minter <address> [--quantity <n>] | opensea-drop-mint.sh <slug> <minter> [quantity] |
| Deploy a new SeaDrop contract | | deploy_seadrop_contract (MCP) |
| Check deployment status | | get_deploy_receipt (MCP) |
Accounts
| Task | CLI Command | Alternative |
|------|------------|-------------|
| Get account details | opensea accounts get <address> | |
| Resolve ENS/username/address | opensea accounts resolve <identifier> | opensea-resolve-account.sh <identifier> |
Generic requests
| Task | Script |
|------|--------|
| Any GET endpoint | opensea-get.sh <path> [query] |
| Any POST endpoint | opensea-post.sh <path> <json_body> |
OpenSea CLI (@opensea/cli)
The OpenSea CLI is the recommended way for AI agents to interact with OpenSea.
Installation
npm install -g @opensea/cli
# Or use without installing
npx @opensea/cli collections get mfers
Authentication
export OPENSEA_API_KEY="your-api-key"
opensea collections get mfers
CLI Commands
| Command | Description |
|---|---|
| collections | Get, list, stats, and traits for NFT collections |
| nfts | Get, list, refresh metadata, and contract details for NFTs |
| listings | Get all, best, or best-for-nft listings |
| offers | Get all, collection, best-for-nft, and trait offers |
| events | List marketplace events (sales, transfers, mints, etc.) |
| search | Search collections, NFTs, tokens, and accounts |
| tokens | Get trending tokens, top tokens, and token details |
| accounts | Get account details |
Global options: --api-key, --chain (default: ethereum), --format (json/table/toon), --base-url, --timeout, --verbose
Output Formats
- JSON (default): Structured output for agents and scripts
- Table: Human-readable tabular output (
--format table) - TOON: Token-Oriented Object Notation, uses ~40% fewer tokens than JSON. Ideal for LLM/AI agent context windows (
--format toon)
Pagination
All list commands support cursor-based pagination with --limit and --next:
opensea collections list --limit 5
opensea collections list --limit 5 --next "LXBrPTEwMDA..."
Programmatic SDK
import { OpenSeaCLI, OpenSeaAPIError } from "@opensea/cli"
const client = new OpenSeaCLI({ apiKey: process.env.OPENSEA_API_KEY })
const collection = await client.collections.get("mfers")
const { nfts } = await client.nfts.listByCollection("mfers", { limit: 5 })
const { listings } = await client.listings.best("mfers", { limit: 10 })
const results = await client.search.query("mfers", { limit: 5 })
OpenSea MCP Server
The OpenSea MCP server provides direct LLM integration.
Setup:
{
"mcpServers": {
"opensea": {
"url": "https://mcp.opensea.io/mcp",
"headers": {
"X-API-KEY": "<OPENSEA_API_KEY>"
}
}
}
}
NFT Tools
| MCP Tool | Purpose |
|----------|---------|
| search_collections | Search NFT collections |
| search_items | Search individual NFTs |
| get_collections | Get detailed collection info (supports auto-resolve) |
| get_items | Get detailed NFT info (supports auto-resolve) |
| get_nft_balances | List NFTs owned by wallet |
| get_trending_collections | Trending NFT collections |
| get_top_collections | Top collections by volume |
| get_activity | Trading activity for collections/items |
Token Tools
| MCP Tool | Purpose | |----------|---------| | `search_
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
