Tokens API

Are the top holders fresh wallets

For a token's 20 largest holders: wallet or contract, whether each bought its position or was sent it, the native coin paid, and how many other tokens it traded before (virgin to established).

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

Get a free API key Try it in the API reference

What it returns

For each of the token's 20 largest holders: whether it is a wallet, a contract or a burn address; how the wallet first got the token (a buy, with the native coin it paid, or a plain transfer, and from whom); and how many other tokens it traded before that, from virgin (none) to established (4 or more). Many virgin wallets among the top holders, or many that were sent their tokens rather than buying them, is a sign the supply was spread by one hand. The history is read from the chain itself; a wallet whose history is too long to read here is left null rather than guessed. holder-packs groups the virgin buyers that bought together.

Chains

Solana SOL
Robinhood Chain RHC

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-freshness/SOL/<mint>"

Parameters
Parameter	Description
`chain` path · string · required	RHC and SOL; every other chain returns 400.
`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 Are the top holders fresh wallets
Field	Type	Description
`asOf`	string \| null	When the holder list was taken (ISO 8601 UTC).
`holdersRead`	integer	Holders read: up to 20, the largest first.
`summary`	object	Counts over the holders that are wallets.
`summary.virgin`	integer
`summary.shortHistory`	integer
`summary.established`	integer
`summary.unread`	integer	Wallets whose `freshness` is `null`.
`summary.bought`	integer	Wallets whose first receipt was a buy.
`summary.received`	integer	Wallets whose first receipt was a transfer.
`holders`	object[]	Largest first.
`holders[].rank`	integer	1 = largest holder.
`holders[].wallet`	string
`holders[].label`	string \| null	What the address is when known, e.g. `LP`; else `null`.
`holders[].amount`	number \| null	The balance in whole tokens.
`holders[].addressKind`	string \| null	`wallet` (no code or a delegated wallet on RHC; an ordinary keypair address on SOL), `contract` (a contract; on SOL, a program-owned address such as a pool or a curve), or `burn` (the zero or dead address; on SOL, the incinerator).
`holders[].freshness`	string \| null	`virgin`: the wallet traded no other token before this one. `short-history`: 1 to 3 other tokens. `established`: 4 or more. `null` for a contract, a burn address, or a wallet whose history is too large to read here.
`holders[].priorTokens`	number \| null	Distinct other tokens the wallet bought or sold before its entry, counted up to 4 (`4` means 4 or more). The native coin, wrapped or not, is not counted; on SOL neither are USDC and USDT. `null` when `freshness` is.
`holders[].entry`	object \| null	The first time the wallet received the token. `null` for a contract or a burn address, and for a wallet whose first receipt could not be found.
`holders[].entry.how`	string	`bought` when that transaction was a trade the wallet paid for (a swap router, the launch curve or a pool paid the token out to it); `received` when it was a plain transfer from another wallet or contract, or a share of somebody else's trade that the wallet paid nothing for.
`holders[].entry.at`	number \| null	Unix seconds of the block (slot on SOL).
`holders[].entry.block`	integer	The block of that transaction; on SOL, its slot.
`holders[].entry.tx`	string	Its transaction hash; on SOL, its signature.
`holders[].entry.from`	string \| null	Who sent the token: the pool, router or wallet.
`holders[].entry.nativeIn`	number \| null	Native coin paid for the tokens in that buy, in whole units (ETH on RHC, SOL on SOL, wrapped included). `null` for a transfer, and for a buy paid in another token or whose payment cannot be tied to this wallet. The entry is the first receipt, so a small test buy made before the real position shows its own small amount.

Price per call

Solana: 1,348 credits
Robinhood Chain: 104 credits

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

Did fresh wallets buy this token together
The virgin buyers among these holders that bought in the same block at the same size.
Which wallets hold the token together, as clusters?
Which of the holders are linked to each other by transfers.
Who are the largest holders of this token?
The holder list alone, with balances and USD values.
How risky is this token's holder base, in one verdict?
Each of the largest holders behind the freshness counts.
Which wallets sniped this token at launch, and are they still holding?
The wallets that bought within 30 seconds of the launch: what each bought, what it holds now and whether it held, sold, moved or burned it, with totals. Robinhood Chain launchpad tokens.
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.

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