NFTs API
The marketplace sales of an NFT collection
One NFT collection's marketplace sales, newest first — token ids, price and currency, marketplace, seller and buyer — with a cursor for the next page.
/api/external/nft-analysis/nft-collection-trades/{chain}/{address}What it returns
One collection's marketplace sales, 100 per page, newest first: the token ids sold, the price in the currency paid, the marketplace, the seller and the buyer. Keep passing nextCursor back as cursor until it is null.
Chains
- BNB Chain BNB
- Ethereum ETH
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-trades/BNB/<address>"
| Parameter | Description |
|---|---|
cursorquery · 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). |
chainpath · string · required | ETH or BNB. BASE, SOL, STABLE, RHC and ARC return 400: no wired source lists a collection's sales there. CELO, ARB, OP and SCROLL return 400 here. |
addresspath · string · required | The NFT collection's contract address. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
contract | string | The collection contract, lowercase. |
sales | object[] | This page's sales, newest first. An empty first page means no marketplace sale is known. |
sales[].at | string | null | When the sale was mined, ISO-8601 UTC. |
sales[].blockNumber | integer | null | The block the sale was mined in. |
sales[].txHash | string | null | The transaction hash. |
sales[].marketplace | string | null | The marketplace the sale went through, e.g. opensea, blur. |
sales[].seller | string | null | The selling wallet, lowercase. |
sales[].buyer | string | null | The buying wallet, lowercase. |
sales[].tokenIds | string[] | The token ids sold in this sale, in decimal, at least one. |
sales[].price | string | null | The price paid, an exact decimal string in priceCurrency. |
sales[].priceCurrency | string | null | The symbol of the currency paid (ETH, WETH, WBNB), or its name when it has no symbol (Blur Pool). |
sales[].priceCurrencyAddress | string | null | The contract of the currency paid, lowercase; null when paid in the chain's native coin. |
nextCursor | string | null | Pass 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