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.

GET/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>"
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 wallet 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

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.
address

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

Response fields of Wallet NFT transfers brief: recent NFT moves, counted
FieldTypeDescription
walletstringThe wallet, lowercase.
transferCountintegerTransfers on the page. 0 on an empty page.
inCountintegerOf them, transfers the wallet received.
outCountintegerOf them, transfers the wallet sent. The rest have the wallet at both ends.
mintCountintegerOf them, mints: sent from the zero address.
burnCountintegerOf them, burns: sent to the zero address.
spamCountintegerOf them, transfers of a collection flagged as likely spam.
collectionCountintegerDistinct collections on the page.
collectionsobject[]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[].contractstringThe NFT collection contract, lowercase.
collections[].collectionNamestring | nullThe collection's name as its contract reports it.
collections[].collectionSymbolstring | nullThe collection's symbol as its contract reports it.
collections[].possibleSpamboolean | nullWhether the source flags the collection as likely spam, such as an unsolicited airdrop; null when it gives no verdict.
collections[].transfersintegerTransfers of this collection on the page.
transfersobject[]The page's 25 newest transfers, newest first, each exactly as wallet-nft-transfers lists it.
transfers[].atstring | nullWhen the transfer was mined, ISO-8601 UTC.
transfers[].blockNumberinteger | nullThe block the transfer was mined in.
transfers[].txHashstring | nullThe transaction hash.
transfers[].logIndexinteger | nullThe transfer's log index in its block; one transaction can move several NFTs.
transfers[].contractstringThe NFT collection contract, lowercase.
transfers[].tokenIdstringThe token id, in decimal.
transfers[].standardstring | nullThe token standard of the collection.
transfers[].amountstring | nullHow many units moved, in decimal. Always 1 for an ERC-721; an ERC-1155 can move more.
transfers[].fromstring | nullThe sending address, lowercase; the zero address on a mint.
transfers[].tostring | nullThe receiving address, lowercase; the zero address on a burn.
transfers[].directionstringin when the wallet received the NFT, out when it sent it, self when it is both ends.
transfers[].kindstring | nullmint when sent from the zero address, burn when sent to it, transfer otherwise. It says nothing about whether the transfer was a sale.
transfers[].collectionNamestring | nullThe collection's name as its contract reports it.
transfers[].collectionSymbolstring | nullThe collection's symbol as its contract reports it.
transfers[].possibleSpamboolean | nullWhether the source flags the collection as likely spam, such as an unsolicited airdrop; null when it gives no verdict.
nextCursorstring | nullPass 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