Skip to main content
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": [
    [
      1712448000000,
      "19675268.0"
    ],
    [
      1712534400000,
      "19675268.0"
    ],
    [
      1712586776000,
      "19675268.0"
    ]
  ]
}

​
Tips

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

​
Note

  • You may leave the interval params as empty for automatic granularity:
    • date range is 1 day from now = 5-minutely data
    • date range is within 2-90 days from now = hourly data
    • date range is 91 days & above from now = daily data (00:00 UTC)
  • Data Availability: from 22 June 2019.
  • Cache/Update Frequency: 5 minutes.
  • 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 circulating supply chart of a coin

​
circulating_supply
((number | string)[])[]