NFTs API
NFT collection sales brief: recent sales and price range
A collection's 25 newest sales plus the lowest and highest price per currency, marketplaces, buyers and sellers.
/api/external/nft-analysis/nft-collection-trades-brief/{chain}/{address}What it returns
The brief of nft-collection-trades; prefer it unless you need every sale on the page. The same chain, collection and cursor. It lists the page's 25 newest sales, each exactly as nft-collection-trades lists it, and over the whole page counts the sales, buyers and sellers, gives the time span, the sales per marketplace, and per payment currency the sales and the lowest and highest price paid. nextCursor is the full page's: it continues after the page's last sale, listed or not.
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-brief/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. |
saleCount | integer | Sales on the page. 0 on an empty page. |
buyerCount | integer | Distinct known buyers among them. |
sellerCount | integer | Distinct known sellers among them. |
newestAt | string | null | When the newest sale on the page was mined, ISO-8601 UTC. Null on an empty page, or when no sale has a time. |
oldestAt | string | null | When the oldest sale on the page was mined, ISO-8601 UTC. Null on an empty page, or when no sale has a time. |
marketplaces | object[] | The sales on the page per marketplace, the most first; at most 10 marketplaces. |
marketplaces[].marketplace | string | null | The marketplace the sale went through, e.g. opensea, blur. |
marketplaces[].sales | integer | Sales on the page through it. |
currencies | object[] | The sales on the page per payment currency, the most first, at most 10 currencies, with the price range paid in it. Prices in different currencies are not comparable, so each has its own. |
currencies[].priceCurrency | string | null | The symbol of the currency paid (ETH, WETH, WBNB), or its name when it has no symbol (Blur Pool). |
currencies[].priceCurrencyAddress | string | null | The contract of the currency paid, lowercase; null when paid in the chain's native coin. |
currencies[].sales | integer | Sales on the page paid in it. |
currencies[].lowestPrice | string | null | The lowest price paid in it on the page, an exact decimal string. Null when no sale in it has a price. |
currencies[].highestPrice | string | null | The highest price paid in it on the page, an exact decimal string. Null when no sale in it has a price. |
sales | object[] | The page's 25 newest sales, newest first, each exactly as nft-collection-trades lists it. |
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, which starts after the page's last sale, listed or not. 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