Opensea ApiSAFE

Bankr Skills equip builders with plug-and-play tools to build more powerful agents.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
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

```bash
# 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 t

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

declared (6 observation(s))

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.