Circulating Supply Chart within Time Range by ID

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/coins/{id}/circulating_supply_chart/range \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "circulating_supply": [
    [
      1735689600000,
      "19803921.0"
    ],
    [
      1735776000000,
      "19804340.0"
    ],
    [
      1735862400000,
      "19804871.0"
    ]
  ]
}

GET

coins

{id}

circulating_supply_chart

range

Circulating Supply Chart within Time Range by ID

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/coins/{id}/circulating_supply_chart/range \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "circulating_supply": [
    [
      1735689600000,
      "19803921.0"
    ],
    [
      1735776000000,
      "19804340.0"
    ],
    [
      1735862400000,
      "19804871.0"
    ]
  ]
}

Notes

Accepts ISO date strings (YYYY-MM-DD or YYYY-MM-DDTHH:MM, recommended) or UNIX timestamps for from and to.
Auto-granularity when interval is not specified:
- 1 day from current time = 5-minutely data
- 1 day from any other time = hourly data
- 2–90 days = hourly data
- Above 90 days = daily data (00:00 UTC)
Data available from 22 June 2019 onwards.

The last completed UTC day (00:00) is available 35 minutes after midnight (00:35 UTC).

SDK Examples

const response = await client.coins.circulatingSupplyChart.getRange('bitcoin', {
  from: '2025-01-01',
  to: '2025-12-31',
});

console.log(JSON.stringify(response, null, 2));

response = client.coins.circulating_supply_chart.get_range(
  "bitcoin",
  from_="2025-01-01",
  to="2025-12-31",
)

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

string

default:bitcoin

required

Coin ID. *refers to /coins/list.

Query Parameters

from

string

default:2025-01-01

required

Starting date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp. Use ISO date string for best compatibility.

string

default:2025-12-31

required

Ending date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp. Use ISO date string for best compatibility.

Response

200 - application/json

Historical circulating supply chart data within time range

circulating_supply

((number | string)[])[]

required

Circulating supply data points as [timestamp, supply] pairs

👑 Circulating Supply Chart by ID 👑 Total Supply Chart by ID

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples