SkillAgentSearch skills...

opensea-api

API key for all OpenSea services (REST API, CLI, SDK, and MCP server)

Install / Use

npx skills add BankrBot/skills --skill opensea-api

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

90/100

Supported Platforms

Universal

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.

Substance
30/30
Structure
20/20
Description
12/15
Adoption
13/20
Freshness
15/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
opensea-api (this skill)by BankrBot901.2k54d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.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.

name: 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 opensea CLI (@opensea/cli) as your primary tool. Install with npm install -g @opensea/cli or use npx @opensea/cli. The shell scripts in scripts/ 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

View on GitHub
GitHub Stars1.2k
CategoryDevelopment
Updated1mo ago
Forks629

Languages

JavaScript

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium
opensea-api — Universal Skill: Install & Safety Check | SkillAgent