Token – Holder Profile & Token – Holder Positions: Complete Holder Intelligence on Solana

Birdeye Data is introducing two new REST API endpoints that give you structured, queryable holder intelligence for any Solana token – broken down by behavioral tag, with per-wallet detail available on demand.

What’s New

Two new endpoints are now live on the Birdeye Data API:

• Token – Holder Profile — Returns a holder profile summary for a specified token, including token market data, holder summary, and a full breakdown by holder tag (bundler, sniper, insider, dev).
• Token – Holder Positions— Returns a paginated list of wallet positions for a specified token, filtered by holder tags. Per-wallet data includes PnL, volumes, and associated wallet labels.

Both endpoints are live on Solana only.

Note: Bundler tag data is accurate for tokens created from March 1, 2026 onwards. Data for tokens created before this date is still being backfilled.

Token – Holder Profile

Endpoint: GET /v1/token/holder-profile

Returns a holder profile summary for a specified token, including token market data, holder summary, and breakdown by holder tags.

Parameters

Description	Default
Token mint address (required)	—
Time interval for volume data	1h
Display mode for token amounts	raw (options: raw, scaled)
Include holders with zero balance	true

Solana network only.

What’s Returned for Token – Holder Profile endpoints

Token market snapshot — market cap, liquidity, 1h volume (buy and sell sides), total holder count, top wallet supply concentration, and token creation date.

Holder tag breakdown — for each of the four holder tags (bundler, sniper, insider, dev), the response returns:

Field	Description
Holders	Number of wallets in this tag
% supply held	Share of total supply held by this tag
Hold amount	Current token balance across all wallets in this tag
Buy vol	Total buy volume
Sell vol	Total sell volume
Avg buy price	Average entry price across all wallets in this tag
PnL	Aggregate profit/loss for this tag

Token – Holder Positions

Endpoint: GET /v1/token/holder-positions

Returns a paginated list of wallet positions for a specified token, filtered by holder tags. Per-wallet data includes PnL, volumes, and associated labels.

Parameters

Description	Default
Token mint address (required)	—
Holder tags to filter by (bundler, sniper, insider, dev) — comma-separated	bundler
Field to sort by	amount
Sort direction	desc (options: asc, desc)
Display mode for token amounts	raw (options: raw, scaled)
Include holders with zero balance	true
Offset for pagination	—
Number of items per page	—

Solana network only.

What’s Returned

A paginated array of wallet-level positions. For each wallet:

Field	Description
Wallet	Wallet address
Holding	Current token balance
% Supply	Share of total supply
Avg buy	Average entry price
PnL	Profit/loss for this wallet
First TX	Timestamp of first transaction
Labels	Associated wallet labels

---

Recommended Usage Pattern

Token – Holder Profile gives you the macro view – which groups hold supply, their volume behavior, and their aggregate PnL. Use this first to assess the holder composition at a glance.

Token – Holder Positions goes one level deeper – letting you page through every individual wallet within a tag and inspect their position.

Step 1: GET /v1/token/holder-profile
→ See the full tag breakdown: who holds, how much, and what their PnL looks like

Step 2: GET /v1/token/holder-positions (filter by relevant tag)
→ Inspect individual wallets within that tag, sorted by current holding

---

Start Building

Both endpoints are live now. Review the full parameter reference and response schema in the documentation:

• Token – Holder Profile: https://docs.birdeye.so/reference/get-token-v1-holder-profile
• Token – Holder Positions: https://docs.birdeye.so/reference/get-token-v1-holder-positions

To get started, visit the Birdeye Data Dashboard or explore the full API Documentation.

---

Birdeye Data is a high-performance data provider that delivers real-time, accurate, and comprehensive on-chain data across tokens, wallets, trades, and protocols on Solana, Sui, and major EVM chains. From fast-moving startups to global leaders like Phantom, Raydium, Coinbase, and Bybit, Birdeye Data powers teams of all sizes with the data they need to build and scale confidently.

Stay connected: Website | X | Docs | Blog | Telegram