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": [
    [
      1712448000000,
      "21000000.0"
    ],
    [
      1712534400000,
      "21000000.0"
    ],
    [
      1712586776000,
      "21000000.0"
    ]
  ]
}

Tips

  • Supports ISO date strings (YYYY-MM-DD or
    YYYY-MM-DDTHH:MM, recommended for best compatibility) or UNIX timestamps.

Note

  • Cache/Update Frequency: 5 minutes.
  • The data is provided at daily intervals (00:00:00 UTC).
  • Data Availability: from 22 June 2019
  • The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35).
  • Exclusive for Enterprise Plan Subscribers only.

Authorizations

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

Path Parameters

id
string
default:bitcoin
required

coin ID *refers to /coins/list.

Example:

"bitcoin"

Query Parameters

from
string
default:2024-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

to
string
default:2024-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

Get historical total supply chart range of a coin

total_supply
(number | string)[][]