NFT Data

Structured NFT collection and market data for AI agents, delivered as an ERC-8257 OpenSea Agent Tool.

What it does

Given an OpenSea collection slug, NFT Data returns collection metadata, contract addresses, floor price, 24-hour / 7-day / 30-day / lifetime sales and volume, and owner statistics — sourced directly from OpenSea API v2.

Human users can check any collection for free at nftdata.app.

AI agents call the paid API programmatically using either x402 v2 or MPP evm/charge:

POST https://www.nftdata.app/api/get-collection-data

OpenSea Agent Tool

Field	Value
Tool ID	778
Network	Base (chain ID 8453)
Registry contract	`0x265bb2dbfc0a8165c9a1941eb1372f349bad2cf1`
Registry page	https://opensea.io/tools/erc8257/base/778
Action	`get_collection_data`
Payment	OpenSea Tool #778: x402 v2 on Base mainnet (USDC). The public API additionally supports x402 v2 on Solana mainnet and MPP evm/charge on Base mainnet. Price: $0.002 per successful request.
Manifest	https://www.nftdata.app/.well-known/ai-tool/nft-data.json

Farcaster Mini App

NFT Data is available as a Farcaster Mini App. Open it inside Warpcast or any Farcaster client to look up NFT collection statistics without leaving the app.

Mini App URL: https://farcaster.xyz/miniapps/xGfhsTicjUjY/nft-data

Poncho

NFT Data is also available through Poncho, providing another discovery point for AI agents to find and try the service.

Try NFT Data on Poncho: https://tryponcho.com/m/nftdata.app

Public Paid API

Endpoint: https://www.nftdata.app/api/get-collection-data

POST https://www.nftdata.app/api/get-collection-data
Content-Type: application/json

The endpoint accepts valid payment credentials through either x402 v2 or MPP evm/charge. Requests without a valid payment credential receive HTTP 402. See x402 Payment and MPP Payment below.

x402 Payment

The endpoint accepts 0.002 USDC per successful call via x402 v2 (exact scheme) on Base mainnet or Solana mainnet. Use whichever network your client supports.

Base mainnet (EVM)

Field	Value
Network	Base (`eip155:8453`)
Token	USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`)
Amount	`2000` atomic units (0.002 USDC)
Scheme	`exact`
Recipient	`0x344143199642E87320785823C20c2dF107D17534`

Solana mainnet (SVM)

Field	Value
Network	Solana mainnet (`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`)
Token	USDC (`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`)
Amount	`2000` atomic units (0.002 USDC)
Scheme	`exact`
Recipient	`8MdycJfWSD8KxL8n2kSzEU9Ryuo1EuJALkq8ezrK9i3m`

The 402 response uses the x402 v2 format -- payment requirements for both networks are encoded in the PAYMENT-REQUIRED response header. The endpoint also exposes the official Bazaar discovery extension under extensions.bazaar, which describes the POST JSON input schema and an example response. Bazaar-compatible x402 clients can discover this endpoint through that extension.

To call this tool from an OpenSea-compatible agent, reference it by its on-chain coordinates:

8453,0x265bb2dbfc0a8165c9a1941eb1372f349bad2cf1,778

MPP Payment

The endpoint also accepts payment via MPP (Machine Payments Protocol) using the evm/charge method.

Field	Value
Protocol	MPP `evm/charge`
Network	Base mainnet (`eip155:8453`)
Token	USDC on Base mainnet
Amount	`2000` atomic units (0.002 USDC, 6-decimal token)

Payment flow:

An initial request without a valid MPP credential receives HTTP 402 Payment Required. The response includes an MPP challenge in the WWW-Authenticate header.
A compatible client resolves the challenge and retries with Authorization: Payment <mpp evm credential>.
A successful 200 response includes the MPP-Receipt header confirming settlement.

The endpoint also accepts Payment-Authorization: Payment <credential> as a fallback for proxy configurations that preserve the application Authorization header separately.

The payment credential is bound to the challenge. MPP and x402 payment credentials are mutually exclusive for a single request -- a request may carry one or the other, not both.

Settlement is attempted only after collection data has been retrieved successfully. Requests that fail input validation (HTTP 400) or encounter an upstream data error do not proceed to settlement.

Input

{
  "collection": "milady"
}

collection is the OpenSea collection slug — the unique identifier visible in the collection's URL, for example milady from opensea.io/collection/milady or basedpunks from opensea.io/collection/basedpunks.

Validation: the slug must be lowercase alphanumeric and may contain hyphens or underscores. Uppercase letters, spaces, and special characters are rejected with HTTP 400.

Response Schema

A successful HTTP 200 response contains the following 20 fields:

Field	Type	Description
`name`	`string`	Collection display name
`slug`	`string`	Collection slug
`contracts`	`array`	NFT contract addresses and their chains
`floor_price`	`number`	Current floor price
`floor_price_currency`	`string`	Currency symbol for the floor price
`one_day_sales`	`number`	Sales count in the last 24 hours
`one_day_volume`	`number`	Trading volume in the last 24 hours
`one_day_volume_currency`	`string \| null`	Currency symbol for 24-hour volume; null if not reported
`seven_day_sales`	`number \| null`	Sales count in the last 7 days; null if not reported
`seven_day_volume`	`number \| null`	Trading volume in the last 7 days; null if not reported
`seven_day_volume_currency`	`string \| null`	Currency symbol for 7-day volume; null if not reported
`thirty_day_sales`	`number \| null`	Sales count in the last 30 days; null if not reported
`thirty_day_volume`	`number \| null`	Trading volume in the last 30 days; null if not reported
`thirty_day_volume_currency`	`string \| null`	Currency symbol for 30-day volume; null if not reported
`total_sales`	`number`	Lifetime sales count
`total_volume`	`number`	Lifetime trading volume
`total_volume_currency`	`string \| null`	Currency symbol for lifetime volume; null if not reported
`num_owners`	`number`	Current unique owner count
`total_supply`	`number \| null`	Total NFTs in the collection; null if not reported
`created_date`	`string \| null`	ISO 8601 creation date; null if not reported

Currency values (floor_price_currency, *_volume_currency) are returned directly from OpenSea and vary by collection and network. Examples include ETH, WETH, USDC, APE, RON, HYPE, and others. Do not assume all volume is ETH.

Verified Production Collections

The OpenSea API supports 30 networks. The table below lists production-tested examples across a subset of those networks.

Network	Slug	Contract
Base	`basedpunks`	`0xcb28749c24af4797808364d71d71539bc01e76d4`
Base	`gribbits`	`0x38b7446dd746a98a101ec0bf1a0717784c4dc69f`
Ink	`rekt-ink`	`0x25aa78ab6785a4b0aeff5c170998992fd958d43d`
Ink	`prtscn-ink`	`0x3ea71c6abde8a1b3cf6e5683761a7378b4e9e448`
Robinhood Chain	`quotrons404`	`0x027aca2794e44f24950d81227dcd516ffbb49d6e`
Robinhood Chain	`rare-friends-genesis`	`0x116eaa62241751e0c98da43d458600c6c17cd361`
HyperEVM	`hypurr-hyperevm`	`0x9125e2d6827a00b0f8330d6ef7bef07730bac685`
HyperEVM	`hypio`	`0x63eb9d77d083ca10c304e28d5191321977fd0bfb`
HyperEVM	`rekt-wolves-hype`	`0x822c4f30414299e003ef39e9aba49d8f8d4445ba`
Arc	`akarii`	`0xbea22653119f73716905919708a612332bf98e3f`
Ronin	`axie-land`	`0x8c811e3c958e190f5ec15fb376533a3398620500`
Ronin	`moki-collection`	`0x47b5a7c2e4f07772696bbf8c8c32fe2b9eabd550`
ApeChain	`gimboznft`	`0x81c9ce55e8214fd0f5181fd3d38f52fd8c33ec38`
ApeChain	`gobs-on-ape`	`0xbebaa24108d6a03c7331464270b95278bbbe6ff7`
Ethereum	`azuki`	`0xed5af388653567af2f388e6224dc7c4b3241c544`
Ethereum	`pudgypenguins`	`0xbd3531da5cf5857e7cfaa92426877b022e612cf8`
Solana	`claynosaurz`	`6mszaj17KSfVqADrQj3o4W3zoLMTykgmV37W4QadCczK`
Solana	`mad-lads`	`J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w`

These examples have been tested in production and are not representative of all 30 supported networks.

Multichain Collection Examples

NFT Data supports collection lookups across 30 networks. The following examples demonstrate collection discovery across five different networks.

Network	Collection	Explore
Arc	AKARII	www.nftdata.app/?collection=akarii
Solana	Mad Lads	www.nftdata.app/?collection=mad-lads
Ethereum	Azuki	www.nftdata.app/?collection=azuki
Base	OK Computers	www.nftdata.app/?collection=okcomputers
Ink	Templars of the Storm	www.nftdata.app/?collection=templars-of-the-storm

Security and Read-Only Scope

NFT Data is strictly read-only. It does not:

require a user wallet or private key
sign transactions
purchase, sell, list, offer on, or transfer NFTs
perform any on-chain write operations

The OpenSea API key is held server-side and is never exposed to callers or included in any response.

Cache

Responses are cached in-memory for 60 seconds per worker instance. The API runs on Vercel's Node.js runtime — multiple isolated instances may be active simultaneously, so cache hits are best-effort within a single warm instance, not globally shared. Cold instances always fetch from the OpenSea API.

HTTP Status Codes

Status	Meaning
`200`	Success — response body contains collection data
`400`	Invalid request — malformed slug, missing field, or OpenSea rejected the input
`402`	Payment required — no valid x402 or MPP payment credential supplied
`404`	Collection not found — slug does not match any OpenSea collection
`429`	Rate limited — OpenSea upstream rate limit hit; `Retry-After` header forwarded if present
`500`	Unexpected server error
`502`	Upstream error — OpenSea API returned a 5xx or unexpected response

Environment Variables

Variable	Required	Description
`OPENSEA_API_KEY`	Yes	OpenSea API v2 key. Used server-side only; never exposed to callers.
`TOOL_ENDPOINT`	No	Override the manifest endpoint URL. Defaults to `https://www.nftdata.app/api/get-collection-data`.

Manifest

The ERC-8257 AI tool manifest is served at:

https://www.nftdata.app/.well-known/ai-tool/nft-data.json

It describes the tool action, input/output schema, pricing, and creator address for agent and registry discovery. The manifest is generated from src/manifest.ts using @opensea/tool-sdk.

OpenSea Tool Registry

Tool ID: 778
Network: Base
Registry page: https://opensea.io/tools/erc8257/base/778
Registry contract: 0x265bb2dbfc0a8165c9a1941eb1372f349bad2cf1

Project Structure

api/
  get-collection-data.ts   # Paid Vercel Edge function (x402-gated)
  well-known/
    [slug].ts              # Serves the ERC-8257 manifest
src/
  handler.ts               # Tool handler, input/output schemas, error mapping
  manifest.ts              # ERC-8257 manifest definition
  opensea.ts               # OpenSea API v2 client and in-memory cache
public/
  index.html               # Static website frontend
  openapi.json             # OpenAPI 3.1 discovery document for x402scan
  .well-known/x402         # x402 compatibility discovery document
  nft-data-icon.svg        # Tool icon (256×256)
  nft-data-banner.svg      # Featured banner (1200×400)
  favicon.svg              # Favicon (32×32)
vercel.json                # Build config and /.well-known/ai-tool/* rewrite
tsconfig.json              # TypeScript config (NodeNext, strict)
package.json               # Dependencies and scripts

Setup / Development

Requirements: Node.js ≥ 18, Vercel CLI

# Install dependencies
npm install

# Set environment variables
cp env.example .env
# Edit .env and add your OPENSEA_API_KEY

# Run locally
npm run dev          # vercel dev — serves API routes and static files

# Type-check
npm run build

# Validate the ERC-8257 manifest
npm run validate-manifest

Links and Discovery

License

MIT

Navigation Menu

Repository navigation

About

Repository files navigation

NFT Data

What it does

OpenSea Agent Tool

Farcaster Mini App

Poncho

Public Paid API

x402 Payment

MPP Payment

Input

Response Schema

Verified Production Collections

Multichain Collection Examples

Security and Read-Only Scope

Cache

HTTP Status Codes

Environment Variables

Manifest

OpenSea Tool Registry

Project Structure

Setup / Development

Links and Discovery

License

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
api		api
public		public
src		src
test		test
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
env.example		env.example
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
tsconfig.test.json		tsconfig.test.json
vercel.json		vercel.json

Latest commit

History

Folders and files

Repository files navigation

NFT Data

What it does

OpenSea Agent Tool

Farcaster Mini App

Poncho

Public Paid API

x402 Payment

MPP Payment

Input

Response Schema

Verified Production Collections

Multichain Collection Examples

Security and Read-Only Scope

Cache

HTTP Status Codes

Environment Variables

Manifest

OpenSea Tool Registry

Project Structure

Setup / Development

Links and Discovery

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages