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 api@coingecko.com

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

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

/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

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.

{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

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/

{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

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.

{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

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/

{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 api@coingecko.com

Paramaters Values Remarks

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.

{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

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.

{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

To get 5-minutely historical data, you should use interval=5m parameter.
- Limit of days: 10 days from today.
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

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)

{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

To get 5-minutely historical data, you should use interval=5m parameter.
- Limit of days per call: 10 days
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.

Previousfor Paid Plan subscribers NextChangelog

Last updated 4 months ago