for Enterprise-plan clients

Exclusive endpoints for Enterprise plan customers only

Please note that the endpoints below are still in beta 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 [e-mail]

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 [e-mail] to learn more about Enterprise plan, or visit https://landing.coingecko.com/api-for-business

/coins/{id}/circulating_supply_chart

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

• Plan Eligibility: Enterprise 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).

Paramaters	Values	Remarks
{id} *required: this is path to pass the coin id, not query parameter.	Valid values: any coin id e.g. bitcoin , …	To get full list of Coin id, please visit /coins/list endpoint. You may also obtain the API id directly from the ‘Info’ section of a CoinGecko coin page.
days *required: data up to number of days ago	Valid values: any integer e.g. 1, 14, 30, ..	days parameter must be specified in call request.
interval: data interval	Valid values: daily	if interval is not specified, auto data granularity will apply.

Example Request

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

Example Response

191B

circulating_supply_chart.json

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

/coins/{id}/circulating_supply_chart/range

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

• Plan Eligibility: Enterprise 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
{id} *required: this is path to pass the coin id, not query parameter.	Valid values: any coin id e.g. bitcoin , ethereum, …	To get full list of Coin id, please visit /coins/list endpoint. You may also obtain the API id directly from the ‘Info’ section of a CoinGecko coin page.
from *required: from date in UNIX Timestamp	Valid values: UNIX timestamp e.g. 1633046400	You may convert human readable date to UNIX timestamp using tools like https://www.epochconverter.com/
to *required: to date in UNIX Timestamp	Valid values: UNIX timestamp e.g. 1635724799	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)

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

Example Response

39KB

circulating_supply_chart range.json

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

/coins/{id}/total_supply_chart

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

• Plan Eligibility: Enterprise 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).

Paramaters	Values	Remarks
{id} *required: this is path to pass the coin id, not query parameter.	Valid values: any coin id e.g. bitcoin , …	To get full list of Coin id, please visit /coins/list endpoint. You may also obtain the API id directly from the ‘Info’ section of a CoinGecko coin page.
days *required: data up to number of days ago	Valid values: any integer e.g. 1, 14, 30, ..	days parameter must be specified in call request.
interval: data interval	Valid values: daily	if interval is not specified, auto data granularity will apply.

Example Request

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

Example Response

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

/coins/{id}/total_supply_chart/range

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

• Plan Eligibility: Enterprise 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
{id} *required: this is path to pass the coin id, not query parameter.	Valid values: any coin id e.g. bitcoin , ethereum, …	To get full list of Coin id, please visit /coins/list endpoint. You may also obtain the API id directly from the ‘Info’ section of a CoinGecko coin page.
from *required: from date in UNIX Timestamp	Valid values: UNIX timestamp e.g. 1633046400	You may convert human readable date to UNIX timestamp using tools like https://www.epochconverter.com/
to *required: to date in UNIX Timestamp	Valid values: UNIX timestamp e.g. 1635724799	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)

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

Example Response

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

/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.

• Plan Eligibility: Enterprise 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 [e-mail]

Paramaters	Values	Remarks
{asset_platform_id} *required: this is path to pass the asset platform id, not query parameter.	Valid values: any asset platform id e.g. polygon-pos , arbitrum-nova, ethereum, …	To get full list of asset platform id, please visit /asset_platforms endpoint.

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

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

Example Response

253KB

token_lists polygoin-pos all.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"
    },
    ...

/coins/{id}/market_chart

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

Paramaters	Values	Remarks
{id} *required: this is path to pass the coin id, not query parameter.	Valid values: any coin id e.g. bitcoin , …	To get full list of Coin id, please visit /coins/list endpoint. You may also obtain the API id directly from the ‘Info’ section of a CoinGecko coin page.
days *required: data up to number of days ago	Valid values: any integer e.g. 1, 14, 30, ..	days parameter must be specified in call request.
interval: data interval	Valid values: daily hourly 5m	if interval is not specified, auto data granularity will apply.

🔐 Exclusive for Enterprise Plan subscriber: 5minutely and hourly interval parameters

1. To get 5-minutely historical data, you should use interval=5m parameter.

   • Limit of days: 10 days from today.

2. To get hourly historical data, you may use interval=hourly parameter.

   • Limit of days: 100 days from today

Example Request

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}

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:

• Data availability:

  • 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 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.

/coins/{id}/market_chart/range

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

Paramaters	Values	Remarks
{id} *required: this is path to pass the coin id, not query parameter.	Valid values: any coin id e.g. bitcoin , ethereum, …	To get full list of Coin id, please visit /coins/list endpoint. You may also obtain the API id directly from the ‘Info’ section of a CoinGecko coin page.
from *required: from date in UNIX Timestamp	Valid values: UNIX timestamp e.g. 1633046400	You may convert human readable date to UNIX timestamp using tools like https://www.epochconverter.com/
to *required: to date in UNIX Timestamp	Valid values: UNIX timestamp e.g. 1635724799	You may convert human readable date to UNIX timestamp using tools like https://www.epochconverter.com/
interval: data interval	Valid values: daily hourly 5m	if interval is not specified, auto data granularity will apply. interval=daily is exclusive for all paid plans (Analyst, Lite, Pro, Enterprise)

🔐 Exclusive for Enterprise Plan subscriber: 5minutely and hourly interval parameters

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 parameter.

   • Limit of days per call: 100 days

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

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}

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:

• Data availability:

  • interval=5minutely: from 9 February 2018, up to 2 days ago.

  • interval=hourly: from 29 Jan 2019, up to now.

• 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.