Wallets API
Wallet NFT transfers brief: recent NFT moves, counted
A wallet's 25 newest NFT transfers plus counts in and out, mints, burns, spam and the collections moved most.
/api/external/wallet-analysis/wallet-nft-transfers-brief/{chain}/{address}What it returns
The brief of wallet-nft-transfers; prefer it unless you need every transfer on the page. The same chain, wallet and cursor. It lists the page's 25 newest transfers, each exactly as wallet-nft-transfers lists it, and over the whole page counts the transfers in and out, the mints, the burns and the likely spam, and names the 20 collections moved most. nextCursor is the full page's: it continues after the page's last transfer, listed or not.
Chains
- BNB Chain BNB
- Ethereum ETH
- Base BASE
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/wallet-analysis/wallet-nft-transfers-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 wallet it was issued for; an empty one, or one over 2048 characters, is a 400 (enforced after the API-key gate). |
chainpath · string · required | The chain the wallet address belongs to. ETH, BNB and BASE are served; SOL, STABLE, RHC and ARC return 400. CELO, ARB, OP and SCROLL return 400 here. |
addresspath · string · required | The wallet address. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
wallet | string | The wallet, lowercase. |
transferCount | integer | Transfers on the page. 0 on an empty page. |
inCount | integer | Of them, transfers the wallet received. |
outCount | integer | Of them, transfers the wallet sent. The rest have the wallet at both ends. |
mintCount | integer | Of them, mints: sent from the zero address. |
burnCount | integer | Of them, burns: sent to the zero address. |
spamCount | integer | Of them, transfers of a collection flagged as likely spam. |
collectionCount | integer | Distinct collections on the page. |
collections | object[] | The 20 collections with the most transfers on the page, the most first, ties the most recently moved first, each named as its newest transfer names it. |
collections[].contract | string | The NFT collection contract, lowercase. |
collections[].collectionName | string | null | The collection's name as its contract reports it. |
collections[].collectionSymbol | string | null | The collection's symbol as its contract reports it. |
collections[].possibleSpam | boolean | null | Whether the source flags the collection as likely spam, such as an unsolicited airdrop; null when it gives no verdict. |
collections[].transfers | integer | Transfers of this collection on the page. |
transfers | object[] | The page's 25 newest transfers, newest first, each exactly as wallet-nft-transfers lists it. |
transfers[].at | string | null | When the transfer was mined, ISO-8601 UTC. |
transfers[].blockNumber | integer | null | The block the transfer was mined in. |
transfers[].txHash | string | null | The transaction hash. |
transfers[].logIndex | integer | null | The transfer's log index in its block; one transaction can move several NFTs. |
transfers[].contract | string | The NFT collection contract, lowercase. |
transfers[].tokenId | string | The token id, in decimal. |
transfers[].standard | string | null | The token standard of the collection. |
transfers[].amount | string | null | How many units moved, in decimal. Always 1 for an ERC-721; an ERC-1155 can move more. |
transfers[].from | string | null | The sending address, lowercase; the zero address on a mint. |
transfers[].to | string | null | The receiving address, lowercase; the zero address on a burn. |
transfers[].direction | string | in when the wallet received the NFT, out when it sent it, self when it is both ends. |
transfers[].kind | string | null | mint when sent from the zero address, burn when sent to it, transfer otherwise. It says nothing about whether the transfer was a sale. |
transfers[].collectionName | string | null | The collection's name as its contract reports it. |
transfers[].collectionSymbol | string | null | The collection's symbol as its contract reports it. |
transfers[].possibleSpam | boolean | null | Whether the source flags the collection as likely spam, such as an unsolicited airdrop; null when it gives no verdict. |
nextCursor | string | null | Pass back as cursor for the next page, which starts after the page's last transfer, 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