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>"
| Parameter | Description |
|---|---|
includeMarketplacesquery · 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. |
chainpath · 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. |
addresspath · 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.
| Field | Type | Description |
|---|---|---|
name | string | null | The collection's name. null when the source has none on file. |
symbol | string | null | The collection's on-chain symbol. |
contractType | string | null | "ERC721" or "ERC1155" — the source's own classifier. null when undetermined. |
verified | boolean | null | true 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". |
possibleSpam | boolean | null | true when the source flags this contract as likely spam; null when it has not flagged either way. |
floorPrice | number | null | The lowest current listing price, in floorPriceCurrency units. null when nothing is currently listed. |
floorPriceUsd | number | null | The same floor price converted to USD. null when nothing is currently listed. |
floorPriceCurrency | string | null | The currency floorPrice is denominated in, e.g. "ETH". null when nothing is currently listed. |
floorPriceMarketplace | string | null | The 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. |
itemCount | integer | null | How many NFTs the collection holds. A real 0 (a contract with no NFT minted) stays 0; null means the source stated no count. |
ownerCount | integer | null | How 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. |
transferCount | integer | null | How many transfers the collection has seen in its lifetime, mints included. null means the source stated no count. |
lastSalePrice | number | null | What 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. |
lastSalePriceUsd | number | null | The same sale in USD at the time it happened. null when there was no sale in the last 90 days. |
lastSaleCurrency | string | null | The token the last sale was paid in, e.g. "ETH". null when there was no sale in the last 90 days. |
lastSaleAt | string | null | When the last sale happened (its block time), ISO 8601 UTC. null when there was no sale in the last 90 days. |
marketplaces | object[] | null | Only 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[].marketplaceId | string | null | The marketplace, e.g. opensea, blur, magiceden. |
marketplaces[].marketplace | string | null | Its display name, e.g. OpenSea. |
marketplaces[].floorPrice | number | null | The cheapest listing there, in currency. |
marketplaces[].volume24h | number | null | 24h volume there, in currency. 0 is a real reading. |
marketplaces[].currency | string | null | The chain's native coin the figures are in, e.g. ETH. |
marketplaces[].url | string | null | The collection's page on that marketplace. |
marketplaces[].updatedAt | string | When 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