v1
latestOpenAPI 3.1.02026-07-2410781551.8 KBHolder
Token - Holder Positions
Retrieve a paginated list of wallet positions for a specified token, filtered by holder tags. Returns per-wallet trading data including PnL, volumes, and associated labels.
get/token/v1/holder-positions
Query parameters
token_addressstring required
Example:J3Dhvhga7QwgLWUGn43caDJtaoUTkDLmiMGqstS2Dw8A
Token mint address
labelsstring[]
Comma-separated list of holder tags to filter by. Default: bundler
[ "bundler", "sniper" ]
sort_by'amount'
Field to sort by. Default: amount
order_type'asc' | 'desc'
Sort direction. Default: desc
ui_amount_mode'scaled' | 'raw'
Display mode for token amounts. Default: raw
include_zero_balanceboolean
Include wallets that have traded the token but no longer hold it (zero balance). Default: true
offsetinteger
Specify the offset for pagination. Filter for records with offset greater than the specified offset value, including those with offset equal to the specified offset.
limitinteger
Number of items per page.
Headers
x-chain'solana'
Solana network only.
Response
JSON array containing token holder position details