Wallets API

The NFT approvals a wallet has granted

Which NFT collections a wallet has let another address move its tokens on, whole-collection or single-token, with any risk signal on the operator — what to revoke.

GET/api/external/wallet-analysis/wallet-nft-approvals/{chain}/{address}

Get a free API key Try it in the API reference

What it returns

Every NFT collection this wallet has approved another address (an operator) to move its tokens on, ERC-721 and ERC-1155, with each approval: the operator, whether it covers the whole collection or one token, when it was granted, and any risk signal on record for the operator. An approval for the whole collection lets the operator take every token of it the wallet holds, now or later; revoking unused ones is the usual advice. When complete is false the underlying scan of the wallet was not finished: the list may be short, or empty for an active wallet, so ask again a minute later before reading it as "no approvals". The collection risk flag has been seen on well-known legitimate collections, so treat it as a prompt to check, not a verdict.

Chains

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/wallet-analysis/wallet-nft-approvals/ETH/<address>"

Parameters
Parameter	Description
`chain` path · string · required	The chain the wallet address belongs to. ETH is served; SOL, BNB, BASE, 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 The NFT approvals a wallet has granted
Field	Type	Description
`wallet`	string	The wallet, lowercase.
`complete`	boolean	`false` when the scan of the wallet was not finished and the list may be incomplete, even empty. Such an answer is never cached, so asking again reads the finished scan.
`collections`	object[]	One entry per collection with at least one outstanding approval, ERC-721 collections first. Empty, with `complete` true, when the wallet has none.
`collections[].contract`	string	The collection contract, lowercase.
`collections[].standard`	string	The token standard of the collection.
`collections[].name`	string \| null	The collection's name as its contract reports it.
`collections[].symbol`	string \| null	The collection's symbol as its contract reports it.
`collections[].collectionFlagged`	boolean \| null	`true` when a risk signal is on record for the collection contract, `null` when none is; never `false`. It has been seen on well-known legitimate collections: a prompt to check, not a verdict.
`collections[].collectionRiskFlags`	string[] \| null	The names of the risk signals on record for the collection, e.g. `phishing_activities`; `[]` when none, `null` when unknown.
`collections[].approvals`	object[]	The collection's outstanding approvals, one per operator or approved token.
`collections[].approvals[].operator`	string	The address allowed to move the tokens, lowercase.
`collections[].approvals[].operatorName`	string \| null	The operator contract's name, when known.
`collections[].approvals[].operatorTag`	string \| null	A label for the operator, such as the marketplace it belongs to, when known.
`collections[].approvals[].allTokens`	boolean	`true` for an approval over every token of the collection (always so on ERC-1155), `false` for one token.
`collections[].approvals[].tokenId`	string \| null	The one approved token, in decimal, when `allTokens` is `false`.
`collections[].approvals[].grantedAt`	integer \| null	When the latest approval was granted, unix seconds.
`collections[].approvals[].firstGrantedAt`	integer \| null	When the wallet first approved this operator, unix seconds.
`collections[].approvals[].txHash`	string \| null	The transaction of the latest approval.
`collections[].approvals[].operatorFlagged`	boolean \| null	`true` when a risk signal is on record for the operator, `null` when none is; never `false`.
`collections[].approvals[].operatorRiskFlags`	string[] \| null	The names of the risk signals on record for the operator; `[]` when none, `null` when unknown.

Price per call

Ethereum: 666 credits

Charged only when the call succeeds. Prices as of 2026-10-30; the current ones are always in the API reference.

A wallet's outstanding token approvals
The same question for the wallet's token allowances.
Which NFTs a wallet holds
The tokens an approval over a whole collection puts at risk.
Can this NFT collection's owner abuse its holders, and is it flagged malicious?
Which operators a wallet has let move its tokens of such a collection.
Which wallet does this .sol or .eth name point to?
Resolves a .sol name on SOL, or an ENS .eth name (Basenames included) on ETH and BASE, to the wallet it points to right now, and says how it was resolved and who holds the name.
Which wallet does this .crypto, .x or .nft name point to?
Resolves a blockchain domain name such as brad.crypto, sandy.x or sandy.nft to the ETH address its record holds; null when the name sets none.
Which .crypto, .x or .nft name does this wallet use as its own?
The blockchain domain name a wallet set as its primary name, only when that name points back to the wallet; null when it has none.

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