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"
    }
  }
}

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

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

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

Show child attributes

CoinGecko API

Onchain API

Historical Token Holders Chart by Token Address

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples