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

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:

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

Solana network only.

What’s Returned

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

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