Tokens API

How far would the price fall if the biggest holders sold?

The price drop if the largest holder cluster, or given wallets, sold everything into the token's launchpad curve, else into its on-chain DEX pools only. SOL, ETH, BNB, BASE, RHC.

GET/api/external/token-analysis/sell-impact/{chain}/{mint}

Get a free API key Try it in the API reference

What it returns

Sells the holdings of the token's largest holder cluster — or of the wallets you name — into the token's current market, and returns the price drop that sale would cause.

The model: constant product. Selling q tokens into a token-side reserve R drops the price by 100 × (1 − (R / (R + q))²) percent. Fees and any buyers arriving meanwhile are ignored.

The reserve `R`: while the token is still on its launchpad bonding curve (pump.fun on SOL, Pons V2 on RHC) it is the curve's token reserve, read from the chain — the curve is the whole market then. Otherwise it is the SUM of the token-side depth of every on-chain DEX pool that lists one, counting only pools where this token is the base side: a seller splitting a sale across constant-product pools meets their combined reserve. Pools that list no depth are left out and counted in poolsWithoutDepth; concentrated-liquidity pools and a truncated list both make the drop read high, never low.

DEX liquidity only: off a curve the drop is measured on on-chain DEX pools alone (reserve.scope dex-pools-only, and note says so). Liquidity on centralized exchanges is not seen, so for a large token that also trades there a real sale would move the price less; for a token that trades only on DEXes the figure is the realistic one.

The holdings `q`: the largest cluster of transfer-connected holders (the first cluster holder-clusters lists), or, with wallets, the sum of those wallets' current balances. priceDropPct is null — never 0 — when either side is unknown: no cluster map for the token, a map with no cluster, or no market with a stated depth.

Price: the sum of what the endpoints it calls would cost called directly — holder-clusters only when wallets is omitted, and pools only when the token is not on its launchpad curve — plus its own chain reads (the curve, and the balances of the wallets you name).

Chains

Solana SOL
BNB Chain BNB
Ethereum ETH
Base BASE
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/sell-impact/SOL/<mint>"

Parameters
Parameter	Description
`wallets` query · string · optional	Optional. Comma-separated wallets whose combined holding is sold instead of the largest cluster — base58 on SOL, 0x-prefixed hex elsewhere. Each address at most once, at most 50. Omit it to sell the largest holder cluster.
`chain` path · string · required	SOL, ETH, BNB, BASE and RHC; 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 How far would the price fall if the biggest holders sold?
Field	Type	Description
`holdings`	object
`holdings.basis`	string	`wallets` when `wallets` was given; `largest-cluster` otherwise.
`holdings.tokens`	number \| null	Tokens sold, decimal-adjusted. `null` when no cluster is known.
`holdings.cluster`	object \| null	The cluster sold, on `largest-cluster`. `null` on `wallets`, and when the token has no cluster map or its map holds no cluster.
`holdings.cluster.rank`	integer	Always 1: the cluster holding the largest share.
`holdings.cluster.supplyPct`	number \| null	The cluster's share of total supply, 0-100.
`holdings.cluster.holderCount`	integer \| null	Holder wallets in the cluster.
`holdings.wallets`	object[] \| null	Each named wallet's current balance, in the order given. `null` on `largest-cluster`.
`holdings.wallets[].wallet`	string
`holdings.wallets[].tokens`	number	Decimal-adjusted; `0` when the wallet holds none.
`reserve`	object
`reserve.basis`	string	`bonding-curve` while the token trades on its launchpad curve; `pools` otherwise.
`reserve.scope`	string	What the reserve covers. `whole-market` on `bonding-curve`: the curve is the token's only market. `dex-pools-only` on `pools`: on-chain DEX liquidity only — liquidity on centralized exchanges is not seen, so for a token that also trades there a real sale would move the price less than `priceDropPct` says.
`reserve.venue`	string \| null	The launchpad, on `bonding-curve`; `null` on `pools`.
`reserve.tokens`	number \| null	The token-side reserve a sale trades against, decimal-adjusted: the curve's, or the sum over the counted pools. `null` when no pool lists a depth.
`reserve.poolsCounted`	integer \| null	Pools whose depth was summed. `null` on `bonding-curve`.
`reserve.poolsWithoutDepth`	integer \| null	Pools listed without a token-side depth, left out of the sum. `null` on `bonding-curve`.
`reserve.poolsTruncated`	boolean \| null	Whether the pool list holds only part of the token's pools. `null` on `bonding-curve`.
`priceDropPct`	number \| null	The price drop the sale would cause, 0-100, against the reserve `reserve.scope` describes. `null` when the holdings or the reserve are unknown.
`note`	string	What `priceDropPct` is measured against, in one sentence: the bonding curve (the whole market), or on-chain DEX pool liquidity only — and, when `poolsTruncated` is true, that the list was cut short.

Price per call

Solana: 17,073 credits
BNB Chain, Ethereum, Base: 17,070 creditsbase; varies with wallets
Robinhood Chain: 17,071 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?
The clusters behind the holdings sold here, and the wallets in each.
Every pool a token trades in
The pools whose depth is summed as the market here.
How risky is this token's holder base, in one verdict?
The sale behind the verdict's price drop, or a sale by wallets you name.
What was the first recorded price of this token, and when?
The earliest USD price on record for a token and when it was recorded; null when none is recorded. An asset tracked across chains carries its first price on any chain.
How much has this token's price changed over a chosen window?
A token's USD price change in percent over a chosen window (1h to 365d); null when no price is tracked for it.
How much has been paid in fees trading this token?
All-time fees paid over a Solana token's trades: network, priority, tips and trading-platform fees in SOL, platform fees in stablecoins, and the tips and platform fees split by name.

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