# for Enterprise-plan clients

{% hint style="info" %}
Please note that the endpoints below are still in <mark style="color:yellow;">**beta**</mark> and might have changes in the future. If you're currently our Enterprise plan user, and have no access to the endpoints below, please contact <api@coingecko.com>&#x20;
{% endhint %}

| Endpoint \[beta]                                                                       | Description                                                                                                                |
| -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **/coins/{id}/circulating\_supply\_chart**                                             | 📈 Get historical circulating supply of a coin, by number of days away from now.                                           |
| **/coins/{id}/circulating\_supply\_chart/range**                                       | 📈 Get historical circulating supply of a coin, within a range of timestamp                                                |
| **/coins/{id}/total\_supply\_chart**                                                   | 📈 Get historical total supply of a coin, by number of days away from now.                                                 |
| **/coins/{id}/total\_supply\_chart/range**                                             | 📈 Get historical total supply of a coin, within a range of timestamp                                                      |
| **/token\_lists/{asset\_platform\_id}/all.json**                                       | 🪙 Get full list of tokens of a blockchain network (asset platform) that is supported by Ethereum token list standard.     |
| Exclusive 5minutely and hourly interval params for **/coins/{id}/market\_chart**       | 📈 Get coin historical market data including price, market cap, and 24h volume, by number of days away from now.           |
| Exclusive 5minutely and hourly interval params for **/coins/{id}/market\_chart/range** | 📈 Get coin historical market data including price, market cap, and 24h volume, of a specific date range (Unix timestamp). |

More experimental endpoints will be added soon. Please contact <api@coingecko.com> to learn more about Enterprise plan, or visit <https://landing.coingecko.com/api-for-business>

### <mark style="color:green;">/coins/{id}/circulating\_supply\_chart</mark>

📈 Get historical circulating supply of a coin, by number of days away from now.

* **Plan Eligibility:** [Enterprise](https://www.coingecko.com/en/api/pricing) only
* **Data Granularity (auto):**
  * **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
* **Update Frequency:** 5 minutes. The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35).

<table><thead><tr><th>Paramaters</th><th width="263.3333333333333">Values</th><th>Remarks</th></tr></thead><tbody><tr><td><p><strong><code>{id}</code></strong> <mark style="color:red;">*required</mark><strong>:</strong> </p><p>this is path to pass the coin id, not query parameter.</p></td><td><p>Valid values: any coin id </p><p>e.g. <code>bitcoin</code> , …</p></td><td>To get full list of Coin id, please visit <a href="https://api.coingecko.com/api/v3/coins/list">/coins/list</a> endpoint. You may also obtain the API id directly from the ‘Info’ section of a CoinGecko <a href="https://www.coingecko.com/en/coins/bitcoin">coin page</a>.</td></tr><tr><td><p><strong><code>days</code></strong> <mark style="color:red;">*required</mark><strong>:</strong> </p><p>data up to number of days ago</p></td><td><p>Valid values: any integer </p><p>e.g. <code>1</code>, <code>14</code>, <code>30</code>, ..</p></td><td><strong><code>days</code></strong> parameter must be specified in call request.</td></tr><tr><td><strong><code>interval</code>:</strong> data interval</td><td>Valid values: <code>daily</code></td><td>if <strong><code>interval</code></strong> is not specified, auto data granularity will apply.</td></tr></tbody></table>

**Example Request**

{% code overflow="wrap" %}

```
https://pro-api.coingecko.com/api/v3/coins/bitcoin/circulating_supply_chart?days=2&interval=daily&x_cg_pro_api_key={YOUR_KEY}
```

{% endcode %}

**Example Response**

{% file src="<https://2075558597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fid6RwASuk2b1d3wDIdi4%2Fuploads%2FBsRrTRvCFy1g1AgGp1db%2Fcirculating_supply_chart.json?alt=media&token=7a264265-d6fd-4684-b0bf-42cf06d712e9>" %}

```json
{
  "circulating_supply": [
    [
      1666224000000,
      "19184000.0"
    ],
    [
      1666310400000,
      "19184918.0"
    ],
    [
      1666326090000,
      "19185081.0"
    ]
  ]
}
```

### <mark style="color:green;">/coins/{id}/circulating\_supply\_chart/range</mark>

📈 Get historical circulating supply of a coin, within a range of timestamp.

* **Plan Eligibility:** [Enterprise](https://www.coingecko.com/en/api/pricing) only
* **Data Granularity (auto):**
  * date range is within **1 day** = **5-minutely data**
  * date range is within **2-90 days** = **hourly data**
  * date range is **91 days & above** = **daily data (00:00 UTC)**
* **Data Availability:** from 22 June 2019
* **Update Frequency:** 5 minutes. The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35).

| Paramaters                                                                                                                                                                    | Values                                                                                       | Remarks                                                                                                                                                                                                                                                                                                                      |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong><code>{id}</code></strong> <mark style="color:red;">\*required</mark><strong>:</strong> </p><p><em>this is path to pass the coin id, not query parameter.</em></p> | <p>Valid values: any coin id </p><p>e.g. <code>bitcoin</code> , <code>ethereum</code>, …</p> | <p>To get full list of <strong>Coin id</strong>, please visit <a href="https://api.coingecko.com/api/v3/coins/list">/coins/list</a> endpoint. </p><p>You may also obtain the <strong>API id</strong> directly from the ‘Info’ section of a CoinGecko <a href="https://www.coingecko.com/en/coins/bitcoin">coin page</a>.</p> |
| <p><strong><code>from</code></strong> <mark style="color:red;">\*required</mark>: </p><p>from date in UNIX Timestamp</p>                                                      | <p>Valid values: UNIX timestamp <br>e.g. <code>1633046400</code></p>                         | You may convert human readable date to UNIX timestamp using tools like <https://www.epochconverter.com/>                                                                                                                                                                                                                     |
| <p><strong><code>to</code></strong> <mark style="color:red;">\*required</mark>: </p><p>to date in UNIX Timestamp</p>                                                          | <p>Valid values: UNIX timestamp </p><p>e.g. <code>1635724799</code></p>                      | You may convert human readable date to UNIX timestamp using tools like <https://www.epochconverter.com/>                                                                                                                                                                                                                     |

**Example Request** (e.g. date range from 1 Oct - 31 Oct 2021)

{% code overflow="wrap" %}

```
https://pro-api.coingecko.com/api/v3/coins/bitcoin/circulating_supply_chart/range?from=1633046400&to=1635724799&x_cg_pro_api_key={YOUR_KEY}
```

{% endcode %}

**Example Response**

{% file src="<https://2075558597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fid6RwASuk2b1d3wDIdi4%2Fuploads%2FhrWN3Yld1KnRSCuA7wyF%2Fcirculating_supply_chart%20range.json?alt=media&token=155e2d05-519c-4684-a50f-6114a1c22edc>" %}

```json
{
  "circulating_supply": [
    [
      1633046428278,
      "18830918.0"
    ],
    [
      1633050274736,
      "18830981.0"
    ],
    [
      1633053814651,
      "18831037.0"
    ],
    ...
```

### <mark style="color:green;">/coins/{id}/total\_supply\_chart</mark>

📈 Get historical total supply of a coin, by number of days away from now.

* **Plan Eligibility:** [Enterprise](https://www.coingecko.com/en/api/pricing) only
* **Data Granularity (auto):**
  * **1 day** from now = **5-minutely data**
  * **2-90 days** from now = **hourly data**
  * **91 days & above** from now = **daily data (00:00 UTC)**
* **Update Frequency:** 5 minutes. The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35).

<table><thead><tr><th>Paramaters</th><th width="263.3333333333333">Values</th><th>Remarks</th></tr></thead><tbody><tr><td><p><strong><code>{id}</code></strong> <mark style="color:red;">*required</mark><strong>:</strong> </p><p>this is path to pass the coin id, not query parameter.</p></td><td><p>Valid values: any coin id </p><p>e.g. <code>bitcoin</code> , …</p></td><td>To get full list of Coin id, please visit <a href="https://api.coingecko.com/api/v3/coins/list">/coins/list</a> endpoint. You may also obtain the API id directly from the ‘Info’ section of a CoinGecko <a href="https://www.coingecko.com/en/coins/bitcoin">coin page</a>.</td></tr><tr><td><p><strong><code>days</code></strong> <mark style="color:red;">*required</mark><strong>:</strong> </p><p>data up to number of days ago</p></td><td><p>Valid values: any integer </p><p>e.g. <code>1</code>, <code>14</code>, <code>30</code>, ..</p></td><td><strong><code>days</code></strong> parameter must be specified in call request.</td></tr><tr><td><strong><code>interval</code>:</strong> data interval</td><td>Valid values: <code>daily</code></td><td>if <strong><code>interval</code></strong> is not specified, auto data granularity will apply.</td></tr></tbody></table>

**Example Request**

{% code overflow="wrap" %}

```
https://pro-api.coingecko.com/api/v3/coins/bitcoin/total_supply_chart?days=2&interval=daily&x_cg_pro_api_key={YOUR_KEY}
```

{% endcode %}

**Example Response**

```json
{
  "total_supply": [
    [
      1702252800000,
      "21000000.0"
    ],
    [
      1702339200000,
      "21000000.0"
    ],
    [
      1702395014000,
      "21000000.0"
    ]
  ]
}
```

### <mark style="color:green;">/coins/{id}/total\_supply\_chart/range</mark>

📈 Get historical total supply of a coin, within a range of timestamp.

* **Plan Eligibility:** [Enterprise](https://www.coingecko.com/en/api/pricing) only
* The data is provided at daily intervals (00:00:00 UTC)
* **Update Frequency:** 5 minutes. The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35).

| Paramaters                                                                                                                                                                    | Values                                                                                       | Remarks                                                                                                                                                                                                                                                                                                                      |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong><code>{id}</code></strong> <mark style="color:red;">\*required</mark><strong>:</strong> </p><p><em>this is path to pass the coin id, not query parameter.</em></p> | <p>Valid values: any coin id </p><p>e.g. <code>bitcoin</code> , <code>ethereum</code>, …</p> | <p>To get full list of <strong>Coin id</strong>, please visit <a href="https://api.coingecko.com/api/v3/coins/list">/coins/list</a> endpoint. </p><p>You may also obtain the <strong>API id</strong> directly from the ‘Info’ section of a CoinGecko <a href="https://www.coingecko.com/en/coins/bitcoin">coin page</a>.</p> |
| <p><strong><code>from</code></strong> <mark style="color:red;">\*required</mark>: </p><p>from date in UNIX Timestamp</p>                                                      | <p>Valid values: UNIX timestamp <br>e.g. <code>1633046400</code></p>                         | You may convert human readable date to UNIX timestamp using tools like <https://www.epochconverter.com/>                                                                                                                                                                                                                     |
| <p><strong><code>to</code></strong> <mark style="color:red;">\*required</mark>: </p><p>to date in UNIX Timestamp</p>                                                          | <p>Valid values: UNIX timestamp </p><p>e.g. <code>1635724799</code></p>                      | You may convert human readable date to UNIX timestamp using tools like <https://www.epochconverter.com/>                                                                                                                                                                                                                     |

**Example Request** (e.g. date range from 1 Oct - 31 Oct 2021)

{% code overflow="wrap" %}

```
https://pro-api.coingecko.com/api/v3/coins/bitcoin/total_supply_chart/range?from=1633046400&to=1635724799&x_cg_pro_api_key={YOUR_KEY}
```

{% endcode %}

**Example Response**

```json
{
  "total_supply": [
    [
      1633046400000,
      "21000000.0"
    ],
    [
      1633132800000,
      "21000000.0"
    ],
    [
      1633219200000,
      "21000000.0"
    ],
    ...
```

### <mark style="color:green;">/token\_lists/{asset\_platform\_id}/all.json</mark>

🪙 Get full list of tokens of a blockchain network (asset platform) that is supported by [Ethereum token list standard](https://tokenlists.org/).

* **Plan Eligibility:** [Enterprise](https://www.coingecko.com/en/api/pricing) only
* **Update Frequency:** 5 minutes
* Note: a token will only be included in the list if the contract address is added by CoinGecko team. If you identified any missing token, you may contact us at <api@coingecko.com>

| Paramaters                                                                                                                                                                                               | Values                                                                                                                                 | Remarks                                                                                                                             |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong><code>{asset\_platform\_id}</code></strong> <mark style="color:red;">\*required<strong>:</strong></mark> </p><p><em>this is path to pass the asset platform id, not query parameter.</em></p> | <p>Valid values: any asset platform id </p><p>e.g. <code>polygon-pos</code> , <code>arbitrum-nova</code>, <code>ethereum</code>, …</p> | To get full list of asset platform id, please visit [/asset\_platforms](https://api.coingecko.com/api/v3/asset_platforms) endpoint. |

**Example Request** (e.g. token lists of Polygon network)

{% code overflow="wrap" %}

```
https://pro-api.coingecko.com/api/v3/token_lists/polygon-pos/all.json?x_cg_pro_api_key={YOUR_KEY}
```

{% endcode %}

**Example Response**

{% file src="<https://2075558597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fid6RwASuk2b1d3wDIdi4%2Fuploads%2FOY8jtldr2zAXOKVlysrO%2Ftoken_lists%20polygoin-pos%20all.json?alt=media&token=5bab83b2-42f8-4ff5-94ed-f0335a2851b6>" %}

```json
{
  "name": "CoinGecko",
  "logoURI": "https://www.coingecko.com/assets/thumbnail-007177f3eca19695592f0b8b0eabbdae282b54154e1be912285c9034ea6cbaf2.png",
  "keywords": [
    "defi"
  ],
  "timestamp": "2022-10-21T02:05:57.841+00:00",
  "tokens": [
    {
      "chainId": 137,
      "address": "0x52468c88e8b4f5bcca20a6a7813355637dc5e3ad",
      "name": "Power Of Deep Ocean",
      "symbol": "PODO",
      "decimals": 18,
      "logoURI": "https://assets.coingecko.com/coins/images/27645/thumb/PODO_TICKER_200.png?1665020330"
    },
    ...
```

### <mark style="color:green;">/coins/{id}/market\_chart</mark>

📈 Get coin historical market data including price, market cap, and 24h volume, by **number of days away from now**.

| Paramaters                                                                                                                                                           | Values                                                                                                        | Remarks                                                                                                                                                                                                                                                |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <p><strong><code>{id}</code></strong> <mark style="color:red;">\*required</mark><strong>:</strong> </p><p>this is path to pass the coin id, not query parameter.</p> | <p>Valid values: any coin id </p><p>e.g. <code>bitcoin</code> , …</p>                                         | To get full list of Coin id, please visit [/coins/list](https://api.coingecko.com/api/v3/coins/list) endpoint. You may also obtain the API id directly from the ‘Info’ section of a CoinGecko [coin page](https://www.coingecko.com/en/coins/bitcoin). |
| <p><strong><code>days</code></strong> <mark style="color:red;">\*required</mark><strong>:</strong> </p><p>data up to number of days ago</p>                          | <p>Valid values: any integer </p><p>e.g. <code>1</code>, <code>14</code>, <code>30</code>, ..</p>             | **`days`** parameter must be specified in call request.                                                                                                                                                                                                |
| **`interval`:** data interval                                                                                                                                        | <p>Valid values: </p><ul><li><code>daily</code></li><li><code>hourly</code></li><li><code>5m</code></li></ul> | if **`interval`** is not specified, [auto data granularity](https://coingecko-api.gitbook.io/coingecko-api-guide/getting-started/endpoint-overview#overview-on-interval-granularity-of-historical-data) will apply.                                    |

🔐 **Exclusive for Enterprise Plan subscriber**: 5minutely and hourly interval parameters&#x20;

1. To get 5-minutely historical data, you should use ***interval=5m*** parameter.
   * Limit of days: 10 days from today.&#x20;
2. To get hourly historical data, you may use ***interval=hourly*** paramete&#x72;**.**
   * Limit of days: 100 days from today

**Example Request**

{% code overflow="wrap" %}

```
https://pro-api.coingecko.com/api/v3/coins/bitcoin/market_chart?vs_currency=usd&days=10&interval=5m&x_cg_pro_api_key={YOUR_KEY}
```

{% endcode %}

**Example Response**

```
{
    "prices": [
    [
        1690254061200,
        29135.231334997916
    ],
    [
        1690257681111,
        29108.866096076745
    ], 
    ...
    
    "total_volumes": [
    [
        1690254061200,
        14991051699.314873
    ],
    [
        1690257681111,
        14519187411.01496
    ],
    ...
    
    "market_caps": [
    [
        1690254061200,
        566936368207.943
    ],
    [
        1690257681111,
        565663731272.7854
    ],
    ...   
]
```

**Note:**&#x20;

* Data availability:&#x20;
  * interval=5m: from 10 days ago, up to 2 days ago.
  * interval=hourly: from 100 days ago, up to now.
* If you call more than the days limit stated above, only up to 10 days (or 100 days for hourly) of data will be returned.
* If you wish to get older data before 10 days ago from today, please use the [**coins/{id}/market\_chart/range**](#coins-id-market_chart-range) endpoint.
* This endpoint may experience some stability issue and may be some missing data. Please share your feedback with us. We appreciate your patience and understanding as we continue to make new improvements to CoinGecko API to serve you better.

### <mark style="color:green;">/coins/{id}/market\_chart/range</mark>

📈 Get coin historical market data including price, market cap, and 24h volume, of a **specific date range** (Unix timestamp).

| Paramaters                                                                                                                                                                    | Values                                                                                                        | Remarks                                                                                                                                                                                                                                                                                                                      |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong><code>{id}</code></strong> <mark style="color:red;">\*required</mark><strong>:</strong> </p><p><em>this is path to pass the coin id, not query parameter.</em></p> | <p>Valid values: any coin id </p><p>e.g. <code>bitcoin</code> , <code>ethereum</code>, …</p>                  | <p>To get full list of <strong>Coin id</strong>, please visit <a href="https://api.coingecko.com/api/v3/coins/list">/coins/list</a> endpoint. </p><p>You may also obtain the <strong>API id</strong> directly from the ‘Info’ section of a CoinGecko <a href="https://www.coingecko.com/en/coins/bitcoin">coin page</a>.</p> |
| <p><strong><code>from</code></strong> <mark style="color:red;">\*required</mark>: </p><p>from date in UNIX Timestamp</p>                                                      | <p>Valid values: UNIX timestamp <br>e.g. <code>1633046400</code></p>                                          | You may convert human readable date to UNIX timestamp using tools like <https://www.epochconverter.com/>                                                                                                                                                                                                                     |
| <p><strong><code>to</code></strong> <mark style="color:red;">\*required</mark>: </p><p>to date in UNIX Timestamp</p>                                                          | <p>Valid values: UNIX timestamp </p><p>e.g. <code>1635724799</code></p>                                       | You may convert human readable date to UNIX timestamp using tools like <https://www.epochconverter.com/>                                                                                                                                                                                                                     |
| **`interval`:** data interval                                                                                                                                                 | <p>Valid values: </p><ul><li><code>daily</code></li><li><code>hourly</code></li><li><code>5m</code></li></ul> | <p>if <strong><code>interval</code></strong> is not specified, <a href="../../getting-started/endpoint-overview#overview-on-interval-granularity-of-historical-data">auto data granularity</a> will apply.<br><br><strong>interval=daily</strong> is exclusive  for all paid plans (Analyst, Lite, Pro, Enterprise)</p>      |

🔐 **Exclusive for Enterprise Plan subscriber**: 5minutely and hourly interval parameters&#x20;

1. To get 5-minutely historical data, you should use ***interval=5m*** parameter.
   * Limit of days per call: 10 days
2. To get hourly historical data, you may use ***interval=hourly*** paramete&#x72;**.**
   * Limit of days per call: 100 days

**Example Request** (1 Jan 2023 00:00:00 UTC to 5 Jan 2023 00:00:00 UTC)

{% code overflow="wrap" %}

```
https://pro-api.coingecko.com/api/v3/coins/bitcoin/market_chart/range?vs_currency=usd&from=1672531200&to=1672876800&interval=5m&x_cg_pro_api_key={YOUR_KEY}
```

{% endcode %}

**Example Response**

```
{
    "prices": [
    [
        1672531208000,
        16542.456148037014
    ],
    [
        1672531521000,
        16542.223749075885
    ], 
    ...
    
    "total_volumes": [
    [
        1672531208000,
        11979309065.331757
    ],
    [
        1672531521000,
        11758188892.834383
    ],
    ...
    
    "market_caps": [
    [
        1672531208000,
        318407574277.7691
    ],
    [
        1672531521000,
        318407574277.7691
    ],
    ...   
]
```

**Note:**&#x20;

* Data availability:&#x20;
  * interval=5minutely: from 9 February 2018, up to 2 days ago.
  * interval=hourly: from 29 Jan 2019, up to now.&#x20;
* This endpoint may experience some stability issue and may be some missing data. Please share your feedback with us. We appreciate your patience and understanding as we continue to make new improvements to CoinGecko API to serve you better.