> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 👑 Circulating Supply Chart within Time Range by ID

> This endpoint allows you to **query historical circulating supply of a coin, within a range of timestamps based on the provided coin ID**

<Tip>
  ### Tips

  * Supports ISO date strings (`YYYY-MM-DD` or\
    `YYYY-MM-DDTHH:MM`, recommended for best compatibility) or UNIX timestamps.
</Tip>

<Note>
  ### Note

  * You may leave the interval params 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.
</Note>


## OpenAPI

````yaml api-reference/coingecko-pro.json get /coins/{id}/circulating_supply_chart/range
openapi: 3.0.0
info:
  title: CoinGecko Pro API
  version: 3.0.0
servers:
  - url: https://pro-api.coingecko.com/api/v3
security:
  - apiKeyAuth: []
  - apiKeyQueryParam: []
paths:
  /coins/{id}/circulating_supply_chart/range:
    get:
      tags:
        - Coins
      summary: 👑 Circulating Supply Chart within Time Range by ID
      description: >-
        This endpoint allows you to **query historical circulating supply of a
        coin, within a range of timestamp based on the provided coin ID**
      operationId: coins-id-circulating-supply-chart-range
      parameters:
        - name: id
          in: path
          description: |-
            coin ID 
             *refers to [`/coins/list`](/reference/coins-list).
          required: true
          schema:
            type: string
            example: bitcoin
            default: bitcoin
        - name: from
          in: query
          description: >-
            starting date in ISO date string (`YYYY-MM-DD` or
            `YYYY-MM-DDTHH:MM`) or UNIX timestamp. 
             **use ISO date string for best compatibility**
          required: true
          schema:
            type: string
            default: '2024-01-01'
          examples:
            iso_date:
              value: '2024-01-01'
            iso_datetime:
              value: 2024-01-01T00:00
            unix_timestamp:
              value: '1609459200'
        - name: to
          in: query
          description: >-
            ending date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`)
            or UNIX timestamp. 
             **use ISO date string for best compatibility**
          required: true
          schema:
            type: string
            default: '2024-12-31'
          examples:
            iso_date:
              value: '2024-12-31'
            iso_datetime:
              value: 2024-12-31T23:59
            unix_timestamp:
              value: '1640995200'
      responses:
        '200':
          description: Get historical circulating supply chart of a coin
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CirculatingSupplyChartBase'
components:
  schemas:
    CirculatingSupplyChartBase:
      type: object
      properties:
        circulating_supply:
          type: array
          items:
            type: array
            items:
              oneOf:
                - type: number
                - type: string
      example:
        circulating_supply:
          - - 1712448000000
            - '19675268.0'
          - - 1712534400000
            - '19675268.0'
          - - 1712586776000
            - '19675268.0'
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-cg-pro-api-key
    apiKeyQueryParam:
      type: apiKey
      in: query
      name: x_cg_pro_api_key

````