Tokens API

Who made the most on this token, all time, held tokens included?

Up to 100 wallets ranked by all-time total profit on a token, realized plus unrealized, with what each bought and sold, average prices and trade count.

GET/api/external/token-analysis/token-pnl-leaders/{chain}/{mint}

Get a free API key Try it in the API reference

What it returns

Up to 100 wallets ranked by TOTAL profit on the token since they first traded it: profit already taken on tokens sold plus the mark-to-market profit on tokens still held, highest first. Tokens a wallet sold without having bought them here are costed at its average buy price. truncated means more wallets are ranked than the ones listed. An empty leaders means no ranking exists for the token, which is the case for stablecoins. An address that is not a known token returns 404.

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/token-analysis/token-pnl-leaders/ETH/<mint>"

Parameters
Parameter	Description
`chain` path · string · required	The chain the token lives on. ETH only; 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 Who made the most on this token, all time, held tokens included?
Field	Type	Description
`asOfBlock`	integer \| null	The block the ranking was computed up to.
`leaders`	object[]	Highest `totalPnlUsd` first. At most 100.
`leaders[].wallet`	string	Lowercase.
`leaders[].totalPnlUsd`	number \| null	Realized plus unrealized profit, USD. What the list is ranked by.
`leaders[].totalPnlPct`	number \| null	`totalPnlUsd` as a percentage of the USD spent buying.
`leaders[].realizedPnlUsd`	number \| null	Profit on tokens already sold, USD. A real `0` when the wallet sold nothing.
`leaders[].realizedPnlPct`	number \| null	Realized profit as a percentage of the cost of the tokens sold; `null` when the wallet sold nothing.
`leaders[].unrealizedPnlUsd`	number \| null	Mark-to-market profit on the tokens still held, USD.
`leaders[].tokensBought`	number \| null	Whole tokens bought.
`leaders[].tokensSold`	number \| null	Whole tokens sold.
`leaders[].boughtUsd`	number \| null	USD spent buying.
`leaders[].soldUsd`	number \| null	USD received selling.
`leaders[].avgBuyPriceUsd`	number \| null	`null` when the wallet bought nothing.
`leaders[].avgSellPriceUsd`	number \| null	`null` when the wallet sold nothing.
`leaders[].costOfSoldUsd`	number \| null	The cost of the tokens sold, at the average buy price; `null` when the wallet sold nothing.
`leaders[].trades`	integer \| null	Buys and sells together.
`truncated`	boolean	`true` when more wallets are ranked than the ones listed.

Price per call

Ethereum: 50 credits

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

Token PnL leaders brief: the most profitable wallets on a token
The same answer in a compact response
Most profitable wallets on this token
Realized profit over the last day, rather than total profit over the token's life.
One wallet's profit across tokens
Pick a wallet from this list and see its whole book.
Who took the most profit on this token over its whole life?
Total profit with held tokens valued, rather than profit already taken.
A token's price and daily volume history, as candles
A token's price and volume history: open/high/low/close and USD volume per bucket, 1m to 1d, each flagged if closed. Sum daily candles for a 7-day or 30-day volume.
Is the holder base growing or shrinking
Holder-count snapshots in 5m to 1d buckets, plus the net change over the span covered. SOL at every width; ETH, BNB, BASE, RHC, ARC at 1h/4h for 7 days, 1d for 30.

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