NFTs API

The NFTs in a collection

Every NFT of one collection, 50 per page: token id, name, image, traits and (ERC-721) holder, with a cursor for the next page.

GET/api/external/nft-analysis/nft-collection-items/{chain}/{address}

What it returns

The NFTs of one collection, 50 per page: each one's token id, name, image, description, traits and — for an ERC-721 — the wallet holding it. Keep passing nextCursor back as cursor until it is null. The order is stable from page to page but is not numeric by token id, and differs by chain. On SOL the walk ends after 200 pages (10000 NFTs).

Chains

  • Solana SOL
  • BNB Chain BNB
  • Ethereum ETH
  • Base BASE
  • Robinhood Chain RHC

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/nft-analysis/nft-collection-items/SOL/<address>"
Parameters
ParameterDescription
cursor

query · string · optional

An opaque cursor from a previous response's nextCursor, for the next page. It only pages the chain and collection it was issued for; an empty one, or one over 2048 characters, is a 400 (enforced after the API-key gate).
chain

path · string · required

ETH, BNB, BASE, RHC or SOL. STABLE and ARC return 400: no wired source lists a collection's NFTs there. CELO, ARB, OP and SCROLL return 400 here.
address

path · string · required

The NFT collection's contract address; on SOL, the collection's own address (its collection NFT mint).

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of The NFTs in a collection
FieldTypeDescription
contractstringThe collection contract, lowercase; on SOL the collection address as sent.
itemsobject[]This page's NFTs. An empty first page means no NFT of this collection is known — a contract that is not an NFT answers the same. An address with no contract at all 404s.
items[].tokenIdstringThe token id, in decimal. On SOL, the NFT's own address: its mint, or a compressed NFT's asset id.
items[].standardstring | null"ERC721" or "ERC1155". null when undetermined, and on SOL, where neither applies.
items[].collectionNamestring | nullThe collection's on-chain name.
items[].collectionSymbolstring | nullThe collection's on-chain symbol.
items[].namestring | nullThe NFT's name, from its metadata. null when its metadata is unknown.
items[].descriptionstring | nullThe NFT's description, from its metadata.
items[].imagestring | nullThe NFT's image as its metadata declares it — often an ipfs:// URI.
items[].animationUrlstring | nullThe NFT's animation or media URL, from its metadata.
items[].externalUrlstring | nullThe external link its metadata declares.
items[].attributesobject[] | nullThe traits its metadata declares, in order. null when the metadata has no trait list (or none could be read); [] when it declares an empty one.
items[].attributes[].traitTypestring | nullThe trait's name.
items[].attributes[].valuestring | nullThe trait's value, as a string — numbers and booleans included.
items[].ownerstring | nullThe wallet holding it, lowercase, as the chain records it — ERC-721 only. null for an ERC-1155, whose units can be spread over many wallets, and when the holder is unknown. On SOL, the holder as sent, for an NFT one wallet holds.
items[].possibleSpamboolean | nullWhether the collection is flagged as likely spam. null when not assessed.
nextCursorstring | nullPass back as cursor for the next page. null on the last page.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key