NFTs API

What an NFT collection is, its floor price, its size and its last sale

An NFT collection's identity (name, symbol, verified or flagged as possible spam), its cheapest current listing, how many NFTs, holders and transfers it has, and its last sale in the past 90 days.

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

Chains

  • BNB Chain BNB
  • Ethereum ETH
  • Base BASE

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/BNB/<address>"
Parameters
ParameterDescription
includeMarketplaces

query · boolean · optional

Whether to add marketplaces: the floor price and 24h volume on each marketplace listing the collection. Off by default: it is up to two more upstream calls.
chain

path · string · required

BNB, ETH and BASE only; SOL, STABLE, RHC and ARC all return 400. STABLE and RHC, because this source's NFT product does not index them at all. SOL, because this source answers Solana NFT questions through a separate product this deployment cannot currently reach (confirmed live). ARC, because this source has no EVM coverage for it. CELO, ARB, OP and SCROLL return 400 here.
address

path · string · required

The NFT collection's contract address (NOT a token mint, and NOT one specific NFT within the collection).

Response fields

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

Response fields of What an NFT collection is, its floor price, its size and its last sale
FieldTypeDescription
namestring | nullThe collection's name. null when the source has none on file.
symbolstring | nullThe collection's on-chain symbol.
contractTypestring | null"ERC721" or "ERC1155" — the source's own classifier. null when undetermined.
verifiedboolean | nulltrue when the source has independently verified this as a real, catalogued collection; null otherwise. Never false — the source does not publish a negative verification, only "verified" or "not looked at".
possibleSpamboolean | nulltrue when the source flags this contract as likely spam; null when it has not flagged either way.
floorPricenumber | nullThe lowest current listing price, in floorPriceCurrency units. null when nothing is currently listed.
floorPriceUsdnumber | nullThe same floor price converted to USD. null when nothing is currently listed.
floorPriceCurrencystring | nullThe currency floorPrice is denominated in, e.g. "ETH". null when nothing is currently listed.
floorPriceMarketplacestring | nullThe marketplace the floor price was observed on, e.g. "opensea" — a downstream venue this collection trades on, not a data source. null when nothing is currently listed.
itemCountinteger | nullHow many NFTs the collection holds. A real 0 (a contract with no NFT minted) stays 0; null means the source stated no count.
ownerCountinteger | nullHow many addresses hold one of this collection today — the same figure nft-collection-holders publishes, from the same count, not a second opinion on it. null means the source stated no count.
transferCountinteger | nullHow many transfers the collection has seen in its lifetime, mints included. null means the source stated no count.
lastSalePricenumber | nullWhat the most recent sale in the last 90 days paid, in lastSaleCurrency units. null when the collection had no sale in that window — the window does not reach further back.
lastSalePriceUsdnumber | nullThe same sale in USD at the time it happened. null when there was no sale in the last 90 days.
lastSaleCurrencystring | nullThe token the last sale was paid in, e.g. "ETH". null when there was no sale in the last 90 days.
lastSaleAtstring | nullWhen the last sale happened (its block time), ISO 8601 UTC. null when there was no sale in the last 90 days.
marketplacesobject[] | nullOnly with includeMarketplaces=true, absent otherwise. The floor price and 24h volume on each marketplace that reported within the last 7 days, largest 24h volume first; a marketplace that stopped reporting is left out rather than shown with an old floor. Empty when the collection is listed but no marketplace reported in that window; null when no marketplace listing of the collection is known.
marketplaces[].marketplaceIdstring | nullThe marketplace, e.g. opensea, blur, magiceden.
marketplaces[].marketplacestring | nullIts display name, e.g. OpenSea.
marketplaces[].floorPricenumber | nullThe cheapest listing there, in currency.
marketplaces[].volume24hnumber | null24h volume there, in currency. 0 is a real reading.
marketplaces[].currencystring | nullThe chain's native coin the figures are in, e.g. ETH.
marketplaces[].urlstring | nullThe collection's page on that marketplace.
marketplaces[].updatedAtstringWhen the marketplace last reported (ISO 8601).

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