⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
opensea
API key for all OpenSea services
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
// README
OpenSea Skills
Read-only mirror. This package is developed in a private monorepo and mirrored to ProjectOpenSea/opensea-skill when a version is released, so the public code can trail the internal main branch by weeks.
Pull requests opened on the mirror cannot be merged there. They are read, and a fix worth taking is recreated in the monorepo. Because a fix that has landed internally is not public until the next release, filing an issue before writing a patch is the quickest way to find out whether a bug is already fixed.
Agent Skills for interacting with OpenSea: query NFT and token data, trade on the Seaport marketplace, swap ERC20 tokens, and build AI agent tools with onchain gating.
This repository follows the Agent Skills specification.
Decision tree
Pick the right skill in one question:
Want to use OpenSea?
├── Query NFT/token data, search, collection stats ──────── opensea-api
├── Buy/sell NFTs (listings, offers, fulfillment) ───────── opensea-marketplace
├── Swap ERC20 tokens (DEX aggregator) ──────────────────── opensea-swaps
├── Set up wallet signing for transactions ──────────────── opensea-wallet
└── Build/register/gate AI agent tools (ERC-8257) ───────── opensea-tool-sdk
Skills
opensea-api
Query NFT and token data through the OpenSea CLI, SDK, MCP server, or shell scripts. Covers collections, NFTs, tokens, search, drops, events, account lookups, and wallet-scoped operations.
- Auth:
OPENSEA_API_KEY - Setup: Get a key at opensea.io/settings/developer or instantly via API
- Entry point:
opensea-api/SKILL.md
opensea-marketplace
Buy and sell NFTs on the Seaport protocol. Create listings and offers, fulfill orders, cross-chain purchases, and sweep multiple listings.
- Auth:
OPENSEA_API_KEY+ wallet provider credentials - Entry point:
opensea-marketplace/SKILL.md
opensea-swaps
Swap ERC20 tokens across supported chains via OpenSea's DEX aggregator. Get quotes, check balances, and execute swaps.
- Auth:
OPENSEA_API_KEY+ wallet provider credentials (for execution) - Entry point:
opensea-swaps/SKILL.md
opensea-wallet
Set up and configure wallet signing providers for OpenSea transactions. Supports Privy, Turnkey, Fireblocks, Bankr, and local private keys.
- Entry point:
opensea-wallet/SKILL.md
opensea-tool-sdk
Build, register, and gate AI-callable tool endpoints using the OpenSea Tool Registry (ERC-8257) on Base. Supports x402 pay-per-call and NFT-gated access.
- Auth: Wallet credentials for onchain registration
- Entry point:
opensea-tool-sdk/SKILL.md
Less-obvious routing
The tree above covers the common cases. These edge cases catch the easy-to-misroute ones:
| Scenario | Skill |
|---|---|
| Authenticate an agent for wallet-scoped REST or MCP | opensea-api |
| Browse and mint NFT drops | opensea-api |
| Stream real-time marketplace events (WebSocket) | opensea-api |
| Cross-chain NFT purchase (pay from a different chain) | opensea-marketplace |
| Sweep multiple listings in one transaction | opensea-marketplace |
| Check token balances for a wallet | opensea-swaps |
| Configure wallet signing policies (caps, allowlists) | opensea-wallet |
| Gate a tool with NFT ownership or x402 payments | opensea-tool-sdk |
Installation
All three paths install the router SKILL.md plus all five sub-skills:
# Auto-installs all five skills (recommended)
npx skills add ProjectOpenSea/opensea-skill --yes
# ClawHub (single slug, all skills bundled)
clawhub install opensea
# Manual (Claude Code / Cursor / Codex)
git clone https://github.com/ProjectOpenSea/opensea-skill.git ~/.claude/skills/opensea
After install, the consuming agent reads SKILL.md (the router), which directs it to the relevant sub-skill based on the task.
Official Links
Specification
These skills follow the Agent Skills specification.
Publishing (maintainer notes)
Repo layout
The root SKILL.md is a thin router that directs agents to the correct sub-skill. This ensures a single install (npx skills add or clawhub install) delivers all five skills with intelligent routing.
ClawHub
Register one slug (opensea) and publish via clawhub skill publish .. The installed layout:
opensea/
├── SKILL.md # router; agent registers this
├── opensea-api/SKILL.md
├── opensea-marketplace/SKILL.md
├── opensea-swaps/SKILL.md
├── opensea-wallet/SKILL.md
└── opensea-tool-sdk/SKILL.md
Do not publish five separate ClawHub slugs.
npx skills add behavior
The vercel-labs/skills CLI discovers both root SKILL.md and skills/ subdirectories. With the router at root, npx skills add ProjectOpenSea/opensea-skill installs the router plus all sub-skills as a single directory tree. Verify this with --dry-run after any structural changes.
Security
Found a vulnerability? Report it through OpenSea's Bugcrowd program at https://bugcrowd.com/engagements/opensea rather than opening a public issue. See SECURITY.md.
License
MIT
// HOW IT'S BUILT
KEY FILES