Sign in

v1

latestOpenAPI 3.1.02026-07-228799577.7 KB
Token

Get Token Traders

Returns wallets that traded the token, along with full position state: realized and unrealized PnL, remaining size, trade counts, and timing. Legacy fields (wallet, pnl, position, buyUsd, sellUsd, counts, roi, timing.firstTrade, timing.lastTrade) are unchanged. Additive fields (invested, proceeds, volume, averages, current, extended timing) align with /v2/pnl/wallets/:wallet/positions and /tokens/:token/holders?enrich=walletPnl for the same wallet-token pair.

get/v2/pnl/tokens/{token}/traders

Path parameters

tokenstring required

Solana token mint address (base58, 32-44 characters).

Query parameters

sort'holding' | 'value' | 'pnl' | 'realized' | 'unrealized' | 'invested' | 'roi' | 'last_trade' | 'first_trade'

Field to sort traders by.

direction'asc' | 'desc'

Sort direction.

limitinteger

Number of results per page.

cursorstring

Opaque pagination cursor returned from the previous page's pagination.nextCursor.

platform'axiom' | 'axiom-flash' | 'bloom' | 'photon'

Filter traders by the trading platform(s) they use. Comma-separated list.

excludeArbitrage'true' | 'false'

Exclude wallets flagged as arbitrage bots. Pass false to include them.

excludeZeroBuys'true' | 'false'

Exclude wallets with zero buy transactions. Pass false to include them.

activeOnly'true' | 'false'

Only include wallets currently holding the token (balance > 0).

minTradesinteger

Minimum trade count for this token.

Response

Successful response.