Tokens API

Token PnL leaders brief: the most profitable wallets on a token

The 25 wallets with the largest all-time profit on a token, realized plus held, with buys and sells. Chain and token.

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

Get a free API key Try it in the API reference

What it returns

The brief of token-pnl-leaders; prefer it unless you need all 100 wallets. The first 25 of the ranking by total profit on one token over its whole life, realized plus the mark-to-market profit on tokens still held, each exactly as token-pnl-leaders lists it, with how many wallets the full ranking lists.

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-brief/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 Token PnL leaders brief: the most profitable wallets on a token
Field	Type	Description
`asOfBlock`	integer \| null	The block the ranking was computed up to.
`leaderCount`	integer	Wallets `token-pnl-leaders` lists, at most 100. 0 for an empty ranking.
`leaders`	object[]	The ranking's first 25, highest total profit first, each exactly as `token-pnl-leaders` lists it.
`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 `token-pnl-leaders` lists.

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.

Who made the most on this token, all time, held tokens included?
The full answer this one condenses
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.
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.
The individual trades behind a token
Raw trade events in a window — who traded, when, which side, how much. A price that could not be trusted is null, never a number.

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