Historical Token Holders Chart by Token Address
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{token_address}/holders_chart \
--header 'x-cg-pro-api-key: <api-key>'{
"data": {
"id": "1dc4b7d5-f0fc-431e-893b-91490652148e",
"type": "token_holders_snapshot",
"attributes": {
"token_holders_list": [
[
"2026-04-28T00:00:00.000Z",
52790
],
[
"2026-04-29T00:00:00.000Z",
52865
]
]
}
},
"meta": {
"token": {
"name": "Pippin",
"symbol": "pippin",
"coingecko_coin_id": "pippin",
"address": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump"
}
}
}Historical Token Holders Chart by Token Address
To get the historical token holders chart based on the provided token contract address on a network
GET
/
onchain
/
networks
/
{network}
/
tokens
/
{token_address}
/
holders_chart
Historical Token Holders Chart by Token Address
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{token_address}/holders_chart \
--header 'x-cg-pro-api-key: <api-key>'{
"data": {
"id": "1dc4b7d5-f0fc-431e-893b-91490652148e",
"type": "token_holders_snapshot",
"attributes": {
"token_holders_list": [
[
"2026-04-28T00:00:00.000Z",
52790
],
[
"2026-04-29T00:00:00.000Z",
52865
]
]
}
},
"meta": {
"token": {
"name": "Pippin",
"symbol": "pippin",
"coingecko_coin_id": "pippin",
"address": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump"
}
}
}Notes
- Historical token holders chart data is currently in Beta, with ongoing improvements to data quality, coverage, and update frequency.
- Auto-granularity via
daysparam:7= all data (no fixed intervals)30= daily data (30 intervals)max= weekly data
Supported networks
Supported networks
| Chain | Network id |
|---|---|
| Solana | solana |
| Ethereum | eth |
| Base | base |
| BNB Chain | bsc |
| Optimism | optimism |
| Arbitrum | arbitrum |
| Polygon | polygon_pos |
| TON | ton |
| Sui | sui-network |
| Robinhood | robinhood |
| Ronin | ronin |
| Bittensor | bittensor |
SDK Examples
const response = await client.onchain.networks.tokens.holdersChart.get('Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump', {
network: 'solana',
});
console.log(JSON.stringify(response, null, 2));
response = client.onchain.networks.tokens.holders_chart.get(
"Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
network="solana",
)
print(response.model_dump_json(indent=2))
Authorizations
headerAuthqueryAuth
Learn how to set up your API key
Query Parameters
Number of days to return the historical token holders chart. Default value: 7
Available options:
7, 30, max Response
200 - application/json
Historical token holders chart data
Was this page helpful?