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.
/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>"
| Parameter | Description |
|---|---|
fromquery · integer · required | Window start, Unix SECONDS. Inclusive. |
toquery · integer · required | Window end, Unix SECONDS. Inclusive. |
limitquery · integer · required | Most transfers to return, newest-first within the window. Capped at 50 (enforced after the API-key gate; see above). |
chainpath · 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. |
mintpath · 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.
| Field | Type |
|---|---|
transfers | object[] |
transfers[].at | number |
transfers[].from | string | null |
transfers[].to | string | null |
transfers[].tokenId | string | null |
transfers[].quantity | number | null |
transfers[].txHash | string | null |
coveredFrom | number | null |
truncated | boolean |
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