API Endpoints

Token - Holder Positions

get
https://public-api.birdeye.so/token/v1/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.

Note: Bundler tag data is accurate for tokens created from 2026-03-01 onwards. Data for tokens created before this date is still being backfilled.

Supported API Plans:

> * Standard > * Starter > * Premium > * Business > * Enterprise

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

Token mint address

string

Comma-separated list of holder tags to filter by. Default: bundler

string
enum
Defaults to amount

Field to sort by. Default: amount

Allowed:
string
enum
Defaults to desc

Sort direction. Default: desc

Allowed:
string
enum
Defaults to raw

Display mode for token amounts. Default: raw

Allowed:
boolean
Defaults to true

Include holders with zero balance. Default: true

integer
Defaults to 0

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.

integer
1 to 50
Defaults to 50

Number of items per page.

Headers
string
enum
Defaults to solana

Solana network only.

Allowed:
Responses

Updated 1 day ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 1 day ago