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.

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

  • Standard
    • Lite
    • Starter
    • Premium
    • Business
    • Enterprise
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 wallets that have traded the token but no longer hold it (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 22 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 22 days ago