Wallets API

Which NFTs a wallet holds

Every NFT collection a wallet holds, with a per-collection count, or (given one collection's address) the token IDs held in it. SOL, ETH, BNB, BASE, STABLE.

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

Get a free API key Try it in the API reference

Chains

Solana SOL
BNB Chain BNB
Ethereum ETH
Stable STABLE
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-holdings/SOL/<address>"

Parameters
Parameter	Description
`contract` query · string · optional	A collection address to drill into — the ERC-721 contract on an EVM chain, the collection's own address on Solana. Omit it to get every collection this wallet holds instead. With it, the response reports that ONE collection's specific token IDs rather than the general collection list — the two are never both fetched in the same request. Omitted, the answer stays under 32 KB up to about 250 collections held.
`chain` path · string · required	SOL, ETH, BNB, BASE and STABLE; every other chain returns 400, and so does SOL on a deployment with no Solana node configured — the message says which of the two it is.
`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 Which NFTs a wallet holds
Field	Type	Description
`collections`	object[] \| null	Every collection this wallet holds one or more tokens from, counting only memberships the chain itself verifies. Up to 1,000 holdings are read per request. null only when `contract` was supplied — that mode answers a different, narrower question and does not also fetch this list.
`collections[].contractAddress`	string
`collections[].name`	string \| null
`collections[].symbol`	string \| null
`collections[].quantity`	number \| null	How many distinct tokens of this collection the wallet holds. null when the answering source reports no distinct count (always on STABLE), never 0.
`contract`	string \| null	Echoes the `contract` filter, or null when the request asked for every collection.
`tokenIds`	string[] \| null	The identifiers of the specific tokens held within `contract`, always STRINGS: a numeric token id on an EVM chain (it can exceed a safe JSON integer), the asset's own address on Solana. Populated only when `contract` was supplied; null otherwise.

Price per call

Solana: 21 credits
BNB Chain, Ethereum, Base: 500 credits
Stable: 14 credits

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

What a wallet is holding now
This wallet's NFT holdings, not the USD-valued fungible-token positions that endpoint ranks.
A wallet's own raw account record
This wallet's NFTs, alongside its own raw native-balance account record.
The NFTs a creator minted, Solana only
The NFTs an address CREATED, not the ones it holds.
The NFT approvals a wallet has granted
The tokens an approval over a whole collection puts at risk.
Which NFTs a wallet bought or sold
What this wallet holds right now, rather than the trades that moved them.
The NFT transfers into and out of a wallet
What the wallet holds right now, rather than the transfers that got it there.

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