Developers · Token API

NFT, collection, market, and metadata data as OpenAPI.

The SuperRare Token API exposes a machine-readable OpenAPI schema for NFT search, token detail, collection search, event history, media and metadata helpers, user profiles, token prices, and Merkle proof utilities.

Open schema ↗Use through rare CLI

NFT endpoints

Query NFTs by full-text search, creator, owner, contract, collection, chain, market state, price, currency, media type, tags, and sort order. Detail and event endpoints use the universal token ID format: chainId-contractAddress-tokenId.

GET /v1/nfts

Search, filter, sort, and paginate NFT results with owner, creator, listing, auction, offer, price, media, and tag filters.

GET /v1/nfts/{universalTokenId}

Fetch a single NFT with creator, owner, metadata, market state, last sale, attributes, and creation timestamp.

GET /v1/nfts/{universalTokenId}/events

Fetch paginated token event history filtered by event type and sort order.

Collections

GET /v1/collections

Search and list collections by text, owner, chain, pagination, and sort order.

GET /v1/collections/{id}

Fetch collection metadata, owner, stats, attributes, chain IDs, and timestamps.

GET /v1/collections/{id}/events

Read events across all NFTs in a collection.

POST /v1/collections/import

Validate an ERC-721 contract on-chain and register it for indexing.

Metadata and media

Use metadata endpoints to initiate uploads, complete multipart media uploads, derive media metadata, and pin token metadata JSON to IPFS.

POST /v1/nfts/metadata/media/uploads
POST /v1/nfts/metadata/media/uploads/complete
POST /v1/nfts/metadata/media/generate
POST /v1/nfts/metadata

Merkle roots and proofs

POST /v1/merkle-roots/nfts

Generate and store an NFT token-list Merkle root.

POST /v1/merkle-roots/nfts/proof

Resolve a token proof from a stored token root.

POST /v1/merkle-roots/addresses

Generate and store an address Merkle root from JSON or multipart input.

POST /v1/merkle-roots/addresses/proof

Generate an address proof from a stored root.

Users and token prices

GET /v1/users/{address}

Fetch a user profile by Ethereum address, including username, full name, and profile stats.

GET /v1/tokens/price/{symbol}

Fetch the current USD price for symbols such as rare, eth, or usdc.

Schema-first integration

The API document is OpenAPI 3.0. Use it directly, generate typed clients, or consume it indirectly through @rareprotocol/rare-cli, which uses the same API for search, metadata, media upload, and Merkle helper flows.

curl -L https://api.superrare.com/doc
openapi-typescript https://api.superrare.com/doc -o rare-api.d.ts