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

# Token - Holder Chart

`GET /token/v1/holder/chart`

Retrieve timestamped holder-count data points for visualizing a Solana token’s holder trends with configurable intervals, filters, and chart modes.

## Query parameters

- `token_address` string, required
- `chart_type` '1d' | '1h' | '1m' | '1s'
- `from` integer
- `to` integer
- `mode` 'no_fill' | 'padding'
- `percent_mode` 'beginning' | 'previous'
- `count` integer

## Headers

- `x-chain` 'solana'

## Response `200`

JSON object containing token holder-count chart data

- TokenHolderChartResponse — Response containing holder-count chart data for a Solana token.
  - `success` boolean, required — Indicates whether the request was successful.
  - `data` object[], required — Holder-count chart points ordered according to the chart query.
    - `timestamp` integer — Timestamp of the holder-count data point as a unix timestamp in seconds.
    - `holder` integer — Number of token holders at this timestamp.
    - `net_change` integer — Net holder-count change compared with the baseline selected by percent_mode.
    - `percent_change` number — Holder-count percentage change compared with the baseline selected by percent_mode.

## 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)