Sign in

v2

latestOpenAPI 3.1.02026-07-316132736.5 KB
V2 - Token

Get Top Token Trader Positions

Returns the top traders for a token ranked by realized PnL or trading volume. Each entry includes wallet address, total buy/sell volumes, realized PnL in USD, number of trades, average entry/exit prices, and wallet labels (PRO_TRADER, SMART_TRADER, etc.). Use for identifying alpha wallets, copy-trade candidates, or insider activity on a token.

get/api/2/token/trader-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

Top Token Trader response

totalCountnumber required