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.

GET/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>"
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 NFT collection sales brief: recent sales and price range
FieldTypeDescription
contractstringThe collection contract, lowercase.
saleCountintegerSales on the page. 0 on an empty page.
buyerCountintegerDistinct known buyers among them.
sellerCountintegerDistinct known sellers among them.
newestAtstring | nullWhen the newest sale on the page was mined, ISO-8601 UTC. Null on an empty page, or when no sale has a time.
oldestAtstring | nullWhen the oldest sale on the page was mined, ISO-8601 UTC. Null on an empty page, or when no sale has a time.
marketplacesobject[]The sales on the page per marketplace, the most first; at most 10 marketplaces.
marketplaces[].marketplacestring | nullThe marketplace the sale went through, e.g. opensea, blur.
marketplaces[].salesintegerSales on the page through it.
currenciesobject[]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[].priceCurrencystring | nullThe symbol of the currency paid (ETH, WETH, WBNB), or its name when it has no symbol (Blur Pool).
currencies[].priceCurrencyAddressstring | nullThe contract of the currency paid, lowercase; null when paid in the chain's native coin.
currencies[].salesintegerSales on the page paid in it.
currencies[].lowestPricestring | nullThe lowest price paid in it on the page, an exact decimal string. Null when no sale in it has a price.
currencies[].highestPricestring | nullThe highest price paid in it on the page, an exact decimal string. Null when no sale in it has a price.
salesobject[]The page's 25 newest sales, newest first, each exactly as nft-collection-trades lists it.
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, 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