Sign in

v2

latestOpenAPI 3.1.02026-07-316132736.5 KB
V2 - Token

Get Token Holder Positions

Returns the top holders for a token ranked by balance. Each entry includes wallet address, token balance, percentage of supply held, USD value, wallet labels (e.g. INSIDER, SNIPER, BUNDLER, CEX), and entity name if identified. Use for whale watching, concentration analysis, and supply distribution audits.

get/api/2/token/holder-positions

Query parameters

chainIdstring

Blockchain chain ID (e.g., "evm:56", "solana:solana")

Blockchain chain ID (e.g., "evm:56", "solana:solana")

addressstring

Token contract address

Token contract address

label'sniper' | 'insider' | 'bundler' | 'proTrader' | 'smartTrader' | 'freshTrader' | 'dev' | 'liquidityPool' | 'locker'

Filter by wallet label (e.g. sniper, bundler, insider)

Filter by wallet label (e.g. sniper, bundler, insider)

limitnumber nullable

Maximum number of results (default: 100)

Maximum number of results (default: 100)

offsetnumber nullable

Offset for pagination

Offset for pagination

string
OR
string[]

Comma-separated wallet addresses to filter

boolean required
OR
string required

Use swap recipient mode for accurate Account Abstraction tracking

boolean required
OR
string required

Include total fees paid (gas + platform + MEV) and deduct from PnL

Response

Token Holder response

totalCountnumber required