GET
/
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": "eb8f8786-9f4d-48f1-8124-eb2d9fd82b2d",
    "type": "token_holders_snapshot",
    "attributes": {
      "token_holders_list": [
        [
          "2025-05-29T10:44:50.813Z",
          7705761
        ],
        [
          "2025-05-29T11:45:03.137Z",
          7705748
        ]
      ]
    }
  },
  "meta": {
    "token": {
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "name": "Tether USD",
      "symbol": "USDT",
      "coingecko_coin_id": "tether"
    }
  }
}

​
Note

  • The historical token holders chart data is currently in Beta, with ongoing improvements to data quality, coverage, and update frequency.
  • Supported chains include: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, and Ronin.
  • days param provides the following automatic granularity:
    • days=7 = all data (without fixed intervals)
    • days=30 = daily data (30 daily intervals)
    • days=max = weekly data
  • 💼 Exclusive for Paid Plan subscribers (Analyst plan or above).
  • Cache/Update frequency: every 60 seconds.

Authorizations

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

Path Parameters

​
network
string
default:eth
required

network ID *refers to /networks

Example:

"eth"

​
token_address
string
default:0xdac17f958d2ee523a2206206994597c13d831ec7
required

token contract address

Example:

"0xdac17f958d2ee523a2206206994597c13d831ec7"

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

Get historical token holders chart for a token

​
data
object
​
meta
object