Tokens API

What does the token's holder map look like, as a picture?

A PNG picture of the token's holder map: the largest holders as bubbles sized by share, linked where their wallets are connected. Rendered on request.

GET/api/external/token-analysis/holder-map-image/{chain}/{mint}

Get a free API key Try it in the API reference

What it returns

A PNG picture (850 × 550) of the token's holder map: the largest holders drawn as bubbles sized by their share of supply, with the links between connected wallets — the clusters holder-clusters lists, drawn. The picture is served from this API's own host and is rendered on request, so a call that misses the cache can take up to about 25 seconds. Every field is null when no picture could be rendered — large, widely held tokens such as major stablecoins often have no map.

Chains

Solana SOL
BNB Chain BNB
Ethereum ETH
Base BASE
Robinhood Chain RHC
Arc ARC

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/holder-map-image/SOL/<mint>"

Parameters
Parameter	Description
`chain` path · string · required	SOL, ETH, BNB, BASE, RHC and ARC, each proven rendered. STABLE is not indexed by the underlying source. CELO, ARB, OP and SCROLL return 400 here.
`mint` path · string · required	The token mint address (Solana) or contract address (EVM).

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of What does the token's holder map look like, as a picture?
Field	Type	Description
`imageUrl`	string \| null	URL of the PNG picture, on this API's host. `null` when no picture could be rendered.
`renderedAt`	integer \| null	Unix seconds when the picture was rendered. `null` when unknown.

Price per call

Solana, BNB Chain, Ethereum, Base, Robinhood Chain, Arc: 17,069 credits

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

Which wallets hold the token together, as clusters?
Holder-clusters lists the clusters and wallets this picture draws.
Market data, all at once
Price, market cap, liquidity, 24h volume, buys and sells, price change, traders, pair, launch stage and paid visibility in one call; the market tools below each answer one of these.
Token identity, all at once
Name, symbol, decimals, total supply, image, socials, launchpad, deployer and its history, creation time (read createdAtIso) — one call; the identity tools each answer one.
Holder count and trend
How many wallets hold the token, how they got in (bought, received, airdropped) and how the count moved over 5m to 30d; a count, not a concentration.
Total supply
How many units of the token exist and their decimals, read from the contract itself wherever the chain has one; total, not circulating.
What the contract allows
What the contract lets anyone do: whether it has a blacklist function, whether its metadata is mutable, and whether the source is verified.

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