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

The address of a token.

string
enum
Defaults to 1h

A list chart holder type: 1d, 1h, 1m, 1s.
Note: 1s chart type only supports data within the last 3 days.

Allowed:
integer
1 to 10000000000

Specify the start time using unix timestamps in seconds

integer
1 to 10000000000

Specify the end time using unix timestamps 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 percentage change is calculated for a timestamp compared to the first or last record in the dataset (beginning = compare with first record, previous = compare with previous/last record).

Allowed:
integer
1 to 100
Defaults to 20

Limit the number of records returned.

Headers
string
enum
Defaults to solana

Solana network only.

Allowed:
Responses

Updated about 1 month ago

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

Updated about 1 month ago