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.

GET/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>"
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 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.
address

path · 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.

Response fields of The marketplace sales of an NFT collection
FieldTypeDescription
contractstringThe collection contract, lowercase.
salesobject[]This page's sales, newest first. An empty first page means no marketplace sale is known.
sales[].atstring | nullWhen the sale was mined, ISO-8601 UTC.
sales[].blockNumberinteger | nullThe block the sale was mined in.
sales[].txHashstring | nullThe transaction hash.
sales[].marketplacestring | nullThe marketplace the sale went through, e.g. opensea, blur.
sales[].sellerstring | nullThe selling wallet, lowercase.
sales[].buyerstring | nullThe buying wallet, lowercase.
sales[].tokenIdsstring[]The token ids sold in this sale, in decimal, at least one.
sales[].pricestring | nullThe price paid, an exact decimal string in priceCurrency.
sales[].priceCurrencystring | nullThe symbol of the currency paid (ETH, WETH, WBNB), or its name when it has no symbol (Blur Pool).
sales[].priceCurrencyAddressstring | nullThe contract of the currency paid, lowercase; null when paid in the chain's native coin.
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