Skip to main content
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 days param:
    • 7 = all data (no fixed intervals)
    • 30 = daily data (30 intervals)
    • max = weekly data
ChainNetwork id
Solanasolana
Ethereumeth
Basebase
BNB Chainbsc
Optimismoptimism
Arbitrumarbitrum
Polygonpolygon_pos
TONton
Suisui-network
Robinhoodrobinhood
Roninronin
Bittensorbittensor

​
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

​
x-cg-pro-api-key
string
header
required

Learn how to set up your API key

Path Parameters

​
network
string
default:solana
required

Network ID. *refers to /onchain/networks.

​
token_address
string
default:Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump
required

Token contract address.

Query Parameters

​
days
enum<string>

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

​
data
object
required
​
meta
object
required