Tokens API

Raw NFT/ERC-1155 collection transfer events

Every transfer of an NFT or semi-fungible collection in a window — identity moves, not decimalized token amounts. The collection-scoped sibling of transfers, which only covers fungible ERC-20 tokens.

GET/api/external/token-analysis/collection-transfers/{chain}/{mint}

What it returns

The raw transfer events behind an NFT (ERC-721) or semi-fungible (ERC-1155) collection contract — every identity move, not a decimalized token amount. tokenId is always present; quantity is null for an ERC-721 row (a non-fungible move is always exactly one, which is not a quantity to report) and populated for an ERC-1155 row. A contract is one standard or the other, never both — this resource tries ERC-721 first and falls through to ERC-1155 only when the first has nothing at all.

Chains

  • BNB Chain BNB
  • Ethereum ETH
  • Stable STABLE
  • Base BASE
  • Robinhood Chain RHC

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/token-analysis/collection-transfers/BNB/<mint>?from=<from>&to=<to>&limit=<limit>"
Parameters
ParameterDescription
from

query · integer · required

Window start, Unix SECONDS. Inclusive.
to

query · integer · required

Window end, Unix SECONDS. Inclusive.
limit

query · integer · required

Most transfers to return, newest-first within the window. Capped at 50 (enforced after the API-key gate; see above).
chain

path · string · required

The chain the collection contract lives on. Served on BNB, ETH, BASE, STABLE, RHC; SOL and ARC return 400 — no wired source reports raw collection transfers there. CELO, ARB, OP and SCROLL return 400 here.
mint

path · string · required

The NFT/ERC-1155 collection contract address (EVM only).

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of Raw NFT/ERC-1155 collection transfer events
FieldType
transfersobject[]
transfers[].atnumber
transfers[].fromstring | null
transfers[].tostring | null
transfers[].tokenIdstring | null
transfers[].quantitynumber | null
transfers[].txHashstring | null
coveredFromnumber | null
truncatedboolean

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