Skip to main content
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"
    }
  }
}

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