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.

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 (bundler, sniper, insider, dev, smart_trader) 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 14 days 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 14 days ago