Sign in

v1

latestOpenAPI 3.1.02026-07-2410781551.8 KB
Wallet, Networth & PnL

Token - Top traders

Rank the top trader trading a token by volume, trade count, PnL, USD volume, or Solana holder position metrics. On Solana, the response can include wallet tags, current holding stats, average buy/sell prices, first and last trade time, and optional holder net worth and funding details.

get/defi/v2/tokens/top_traders

Query parameters

addressstring required

The address of the token contract.

time_frame'30m' | '1h' | '2h' | '4h' | '6h' | '8h' | '12h' | '24h' | '2d' | '3d' | '7d' | '14d' | '30d' | '60d' | '90d' | 'all_time' required
sort_type'desc' | 'asc' required

Specify the sort order.

sort_by'volume' | 'trade' | 'total_pnl' | 'unrealized_pnl' | 'realized_pnl' | 'volume_usd' | 'hold_volume' required

Specify the sort field.

offsetinteger

Pagination start position. offset + limit <= 10000

limitinteger

Number of items per page.

ui_amount_mode'raw' | 'scaled'

Indicate whether to use the scaled amount for scaled ui amount tokens. Only support solana

wallet_tagsstring[]

Filter Solana traders by wallet tags. Supports comma-separated values.

get_holders_networthboolean

Solana only. When true, the response includes netWorth, solBalance, and funding for each trader. This may make the response slightly slower than when disabled.

Headers

x-chain'solana' | 'ethereum' | 'arbitrum' | 'avalanche' | 'bsc' | 'optimism' | 'polygon' | 'base' | 'zksync' | 'monad' | 'hyperevm' | 'aptos' | 'fogo' | 'mantle' | 'megaeth' | 'robinhood' | 'sui'

A chain name listed in supported networks.

Response

JSON object containing a list of top traded tokens

successboolean required