Skip to main content
GET
/
coins
/
{id}
/
circulating_supply_chart
👑 Circulating Supply Chart by ID
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/coins/{id}/circulating_supply_chart \
  --header 'x-cg-pro-api-key: <api-key>'
{
  "circulating_supply": [
    [
      1712448000000,
      "19675268.0"
    ],
    [
      1712534400000,
      "19675268.0"
    ],
    [
      1712586776000,
      "19675268.0"
    ]
  ]
}

​
Note

  • You may leave the interval params as empty for automatic granularity:
    • 1 day from now = 5-minutely data
    • 2-90 days from now = hourly data
    • 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

​
days
string
default:1
required

data up to number of days ago Valid values: any integer or max

​
interval
enum<string>

data interval

Available options:
5m,
hourly,
daily

Response

200 - application/json

Get historical circulating supply chart of a coin

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