skills.rest
surfingalien
surfingalienCOMMUNITY
Explore all skills by this author →
GitHub

opensea-api

Query NFT metadata, collections, listings, offers, and events via the OpenSea REST and Stream APIs.

1|Updated May 6, 2026
Search Tags:#api#blockchain#marketplace#rest api#web3#nft#opensea
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill opensea-api-surfingalien
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: opensea-api
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/opensea-api
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill opensea-api-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Accessing NFT marketplace data requires learning OpenSea's API surface, handling authentication, rate limits, and pagination. This Skill provides ready-to-use endpoint patterns and shell scripts for fetching NFT data without writing integration code from scratch. ## Core Features & Use Cases - NFT & Collection Queries: Fetch NFT metadata, traits, ownership, collection stats, and floor prices across Ethereum, Polygon, Base, and other chains. - Market Activity Tracking: Retrieve listings, offers, and events (sales, transfers) with helper scripts for monitoring collections in real time. - Stream API Integration: Subscribe to live WebSocket events like item.listed and item.sold using JavaScript or Python SDKs. - Use Case: A developer building an NFT analytics dashboard uses the collection_stats.sh script to pull floor price and 24h volume, then monitors sales with monitor_collection.sh. ## Quick Start Set the OPENSEA_API_KEY environment variable and ask the assistant to fetch the stats and floor price for the boredapeyachtclub collection.

Frequently Asked Questions about opensea-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch NFT metadata from the OpenSea API?▼

Call the GET /api/v2/chain/{chain}/contract/{address}/nfts/{token_id} endpoint with your API key in the X-API-KEY header. The included fetch_nft.sh script wraps this call with chain validation and rate-limit retries.

How do I get an OpenSea API key?▼

Create a developer account at the OpenSea Developer Portal and generate a key, then set it as the OPENSEA_API_KEY environment variable. Free tier keys allow 4 GET requests per second.

Which blockchains does the OpenSea API support?▼

The API supports Ethereum, Polygon (matic), Arbitrum, Optimism, Base, Avalanche, Blast, Zora, and Solana. Specify the chain name in the request path when querying NFTs or accounts.

How do I handle OpenSea API rate limits?▼

The API allows 4 GET and 2 POST requests per second per key. On HTTP 429 responses, retry with exponential backoff as shown in the helper scripts, or use the Stream API instead of polling for real-time data.

Can I monitor NFT sales in real time with OpenSea?▼

Yes, use the Stream API via @opensea/stream-js for JavaScript or opensea-stream for Python to subscribe to events like item.sold and item.listed. Alternatively, the monitor_collection.sh script polls the events endpoint at a set interval.

Related Skills

Explore More Software Engineering Skills→
ragnarokhaaragnarokhaa
4

gif-search

Searches and downloads GIFs from the Tenor API by query and format.

Community
Basic
datagridSolutiondatagridSolution

NFT Portfolio Skill

Aggregate NFT portfolio valuations and P&L across multiple chains and marketplaces.

Official
Advanced
XSpoonAiXSpoonAi
17

nft-market-analysis

Analyze NFT marketplace data across OpenSea, Blur, and Magic Eden.

Official
Intermediate
afel6afel6

solana

Query Solana blockchain data with USD pricing via JSON-RPC and CoinGecko.

Community
Intermediate