Links

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 [email protected]
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 [email protected] 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
circulating_supply_chart.json
191B
Code
{
"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
circulating_supply_chart range.json
39KB
Code
{
"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 [email protected]
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
token_lists polygoin-pos all.json
253KB
Code
{
"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. 1.
    To get 5-minutely historical data, you should use interval=5m parameter.
    • Limit of days: 10 days from today.
  2. 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. 1.
    To get 5-minutely historical data, you should use interval=5m parameter.
    • Limit of days per call: 10 days
  2. 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.