curl --request GET \
--url https://public-api.birdeye.so/token/v1/holder/chart \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/token/v1/holder/chart"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://public-api.birdeye.so/token/v1/holder/chart', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"timestamp": 1763608550,
"holder": 4451715,
"net_change": -160,
"percent_change": -0.0035939912958023305
},
{
"timestamp": 1763608548,
"holder": 4451713,
"net_change": -162,
"percent_change": -0.00363891618699986
}
],
"success": true
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}Token - Holder Chart
Retrieve timestamped holder-count data points for visualizing a Solana token’s holder trends with configurable intervals, filters, and chart modes.
curl --request GET \
--url https://public-api.birdeye.so/token/v1/holder/chart \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/token/v1/holder/chart"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://public-api.birdeye.so/token/v1/holder/chart', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"timestamp": 1763608550,
"holder": 4451715,
"net_change": -160,
"percent_change": -0.0035939912958023305
},
{
"timestamp": 1763608548,
"holder": 4451713,
"net_change": -162,
"percent_change": -0.00363891618699986
}
],
"success": true
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}- Usage Notes
- Accessibility
- Chain Supported
time_fromandtime_toare 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 parameterpercent_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%).
- Lite
- Starter
- Premium
- Business
- Enterprise
- Solana
Compute Unit ⚙️
Compute Unit ⚙️
- This endpoint consumes
25 CUper request.
Authorizations
API key for authentication
Headers
Solana network only.
solana Query Parameters
Token mint address.
Holder-count chart interval. Supported values: 1d, 1h, 1m, 1s. Note: 1s chart type only supports data within the last 3 days.
1d, 1h, 1m, 1s Start time for the chart as a unix timestamp in seconds.
1 <= x <= 10000000000End time for the chart as a unix timestamp in seconds.
1 <= x <= 10000000000Controls how chart data is handled. padding fills missing timestamps to maintain continuity; no_fill returns only timestamps where values change.
no_fill, padding Defines how holder-count percentage change is calculated. beginning compares each point with the first record; previous compares each point with the previous record.
beginning, previous Maximum number of chart points to return.
1 <= x <= 100Was this page helpful?

