BIbirdeye
Holder

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

Request

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

successboolean required

Whether the request succeeded.

Changes

No recorded changes to this operation across all 1 revision of this API.