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

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-DD or YYYY-MM-DDTHH:MM, recommended) or UNIX timestamps for from and to.
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 35 minutes after midnight (00:35 UTC).

SDK Examples

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

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 total supply chart data within time range

total_supply

((number | string)[])[]

required

Total supply data points as [timestamp, supply] pairs

👑 Total Supply Chart by ID Coins Categories List (ID Map)

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples