OpenSea Collection Data

Query OpenSea collection data: floor price, listings, offers, and traits for any NFT collection.

What you get

• floor — collection floor/stats
• listings — current listings for a collection
• offers — current offers on a collection
• traits — trait rarity breakdown

All four actions are live. No OpenSea API key or paid tier on your side — you pay per call instead.

Pricing

$0.01 USDC per call on Base (eip155:8453), x402 v2. Recipient: 0x7861db4efc14a1ed5dd8c96c528a3796560f1393. Facilitator: x402-agent-pay.com. Registered onchain as ERC-8257 tool 728 on the Base ToolRegistry.

Manifest & discovery

GET /.well-known/ai-tool/opensea-collection-data.json
GET /.well-known/x402.json
GET /openapi.json

How to call

POST to /api with a JSON body matching the manifest's inputs schema:

curl -i -X POST https://opensea-data-x402.fly.dev/api \
  -H 'Content-Type: application/json' \
  -d '{"collection": "boredapeyachtclub", "action": "floor"}'

An unpaid call returns 402 with a PAYMENT-REQUIRED header containing the x402 v2 challenge. Sign it (EIP-3009 USDC authorization) and retry with the X-PAYMENT header. Or let the SDK do it:

PRIVATE_KEY=0x... RPC_URL=https://mainnet.base.org npx @opensea/tool-sdk pay \
  https://opensea-data-x402.fly.dev/api \
  --body '{"collection": "boredapeyachtclub", "action": "floor"}'

Response codes

• 200 — success (JSON body matching outputs schema)
• 402 — payment required (attach x402 payment)
• 404 in body — unknown collection slug
• 429 — upstream rate limit, retry shortly

Built with @opensea/tool-sdk · Creator: 0xfbc0eb7811d477e55261d956df39f0046e192240 · Royal Agentic Enterprises