API Endpoints

Token - Holder Chart

get
https://public-api.birdeye.so/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.

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

  • time_from and time_to are optional. If not passed, the latest records will be returned.
    • net_change: Absolute change in holder count compared to the reference point. Whether this is compared to the previous interval or the beginning of the queried range depends on the percent_mode parameter
    • percent_change: Percentage change in holder count relative to the same reference point as net_change. Expressed as a percentage (e.g., 0.035 = 0.035%).
Query Params
string
required

Token mint address.

string
enum
Defaults to 1h

Holder-count chart interval. Supported values: 1d, 1h, 1m, 1s. Note: 1s chart type only supports data within the last 3 days.

Allowed:
integer
1 to 10000000000

Start time for the chart as a unix timestamp in seconds.

integer
1 to 10000000000

End time for the chart as a unix timestamp in seconds.

string
enum
Defaults to padding

Controls how chart data is handled. padding fills missing timestamps to maintain continuity; no_fill returns only timestamps where values change.

Allowed:
string
enum
Defaults to beginning

Defines how holder-count percentage change is calculated. beginning compares each point with the first record; previous compares each point with the previous record.

Allowed:
integer
1 to 100
Defaults to 20

Maximum number of chart points to return.

Headers
string
enum
Defaults to solana

Solana network only.

Allowed:
Responses

Updated 2 months ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago

Did this page help you?