Skip to main content
GET
SDK
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.

SDK Example

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

tokenAddress
string
required

Query Parameters

enrich
string

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

Example:

"all"

Response

200 - application/json

Successful response

total
integer
enrich
string[]

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

accounts
object[]