v1

latestOpenAPI 3.1.02026-07-228799577.7 KB
Tokens

Get Token Holders (Top 100)

Gets the top 100 holders for a specific token and the total holder count. Optional enrichment adds wallet identity (?enrich=identity) and/or PnL (?enrich=walletPnl). Use ?enrich=identity,walletPnl, ?enrich=all, or ?enrich=* for both. When enrichment is requested, the response includes an enrich array listing applied modules. pnl.token uses the same flat field set as PnL V2 (invested, proceeds, trade counts, volume, timing, avgCost, holdTimeSecs). pnl.wallet is lifetime wallet PnL. Enrichment fields are omitted per account when not applicable — for example, pool accounts may have identity only, and wallets with no trade history for the token omit pnl.

get/tokens/{tokenAddress}/holders

Path parameters

tokenAddressstring required

Query parameters

enrichstring
Example:all

Optional enrichment modules. Use identity, walletPnl, identity,walletPnl, all, or *. When omitted, no extra enrichment work is done.

Response

Successful response

totalinteger
enrichstring[]

List of enrichment modules applied to this response. Omitted when enrichment is not requested.