Total Supply Chart within Time Range by ID
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/total_supply_chart/range \
--header 'x-cg-pro-api-key: <api-key>'{
"total_supply": [
[
1735689600000,
"19803921.0"
],
[
1735776000000,
"19804340.0"
],
[
1735862400000,
"19804871.0"
]
]
}Total Supply Chart within Time Range by ID
To query historical total supply of a coin, within a range of timestamp based on the provided coin ID
GET
/
coins
/
{id}
/
total_supply_chart
/
range
Total Supply Chart within Time Range by ID
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/total_supply_chart/range \
--header 'x-cg-pro-api-key: <api-key>'{
"total_supply": [
[
1735689600000,
"19803921.0"
],
[
1735776000000,
"19804340.0"
],
[
1735862400000,
"19804871.0"
]
]
}Notes
- Accepts ISO date strings (
YYYY-MM-DDorYYYY-MM-DDTHH:MM, recommended) or UNIX timestamps forfromandto. - Data is provided at daily intervals (00:00:00 UTC).
- Data availability:
- Full coverage for all coins starts from 27 July 2023
- Patched historical data from June 2019 is available for select coins only and may contain inaccuracies
The last completed UTC day (00:00) is available after 01:40 UTC the next day.
SDK Examples
New to the SDK? Install and authenticate theclient first:TypeScript | Python
const response = await client.coins.totalSupplyChart.getRange('bitcoin', {
from: '2025-01-01',
to: '2025-12-31',
});
console.log(JSON.stringify(response, null, 2));
response = client.coins.total_supply_chart.get_range(
"bitcoin",
from_="2025-01-01",
to="2025-12-31",
)
print(response.model_dump_json(indent=2))
Authorizations
headerAuthqueryAuth
Learn how to set up your API key
Path Parameters
Coin ID.
*refers to /coins/list.
Query Parameters
Was this page helpful?

