---
title: "Token - Holder Profile"
method: GET
path: "/token/v1/holder-profile"
tags: ["Holder"]
---

# Token - Holder Profile

`GET /token/v1/holder-profile`

Retrieve holder profile summary for a specified token, including token market data, holder summary, and breakdown by holder tags (bundler, sniper, insider, dev, smart_trader).

## Query parameters

- `token_address` string, required
- `interval` '1h'
- `ui_amount_mode` 'scaled' | 'raw'
- `include_zero_balance` boolean

## Headers

- `x-chain` 'solana'

## Response `200`

JSON object containing token holder profile summary

- TokenHolderProfileResponse
  - `success` boolean, required — Whether the request succeeded.
  - `data` object, required
    - `token` object
      - `creation_time` integer — Token creation time as unix timestamp
      - `market_cap` number — Current market cap in USD
      - `liquidity` number — Current liquidity in USD
      - `volume_1h` number — Total trade volume in token amount over the selected interval
      - `volume_1h_usd` number — Total trade volume in USD over the selected interval
      - `buy_volume_1h` number — Buy volume in token amount over the selected interval
      - `buy_volume_1h_usd` number — Buy volume in USD over the selected interval
      - `sell_volume_1h` number — Sell volume in token amount over the selected interval
      - `sell_volume_1h_usd` number — Sell volume in USD over the selected interval
      - `is_scaled_ui_token` boolean — Whether this token has scaled UI amount. Always returned regardless of ui_amount_mode.
      - `top10_holder` object — Aggregated stats for the top 10 holders
        - `hold_amount` string — Total token amount held by the top 10 holders
        - `percent_of_supply` number — Percentage of total supply held by the top 10 holders
    - `holder_summary` object — Aggregated stats across all labeled holders
      - `total_holder` integer — Total number of labeled holders
      - `total_holding` number — Total token amount held by all labeled holders
      - `percent_of_supply` number — Percentage of total supply held by all labeled holders
    - `tags` object[] — Breakdown by holder tag, one entry per tag. Supported tags: `bundler`, `sniper`, `insider`, `dev`, `smart_trader`. A tag with no matching holder is still returned, with zeroed metrics.
      - `tag` 'bundler' | 'sniper' | 'insider' | 'dev' | 'smart_trader' — Holder category tag.
      - `holder_count` integer — Number of wallets with this tag that currently hold the token
      - `hold_amount` string — Total token amount held by wallets with this tag
      - `percent_of_supply` number — Percentage of total supply held by wallets with this tag
      - `buy_volume` string — Total token buy volume by wallets with this tag
      - `sell_volume` string — Total token sell volume by wallets with this tag
      - `buy_volume_usd` string — Total buy volume in USD by wallets with this tag
      - `sell_volume_usd` string — Total sell volume in USD by wallets with this tag
      - `avg_buy_price` string — Average buy price in USD across all wallets with this tag
      - `pnl` string — Total PnL in USD for wallets with this tag, realized and unrealized combined

## Other responses

- `400` — Bad Request
- `401` — Unauthorized. API key is missing or invalid
- `403` — Forbidden. Request is blacklisted or not whitelisted
- `429` — Too Many Requests. Rate limit reached
- `500` — Internal Server Error

---

[API](https://skmtc.net/birdeye/apis/birdeye-data-api.md) · [All operations](https://skmtc.net/birdeye/apis/birdeye-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/birdeye/birdeye-data-api/revisions/fcaba926a089/schema)