Endpoint Overview

The full list of Public API endpoints are listed here: https://www.coingecko.com/en/api/documentation​
Other exclusive endpoints for paid plan users are listed on the Exclusive Endpoints page.
​
If you're new to CoinGecko, you may want to learn more about our methodologies on how we aggregate and calculate these data: market data (price, trading volume, .. ), exchanges, trust score, and listings.
​
CoinGecko API is divided into the following top-level categories
Endpoint Category
Description
/simple/*
The simplest & fastest endpoints to call the latest price of crypto assets, by id or contract address.
/coins/*
Endpoints that return list of coins on CoinGecko, and their respective price, market data, historical data, and metadata (image, descriptions, links, followers, token supply info, etc).
More exclusive endpoints are available to discover trending coins, newly added coins and more.
/contract/*
Works similarly as /coins/* endpoint above , except that it is queried by contract address, instead of api id.
/asset_platforms
To get the full list of blockchain network supported on CoinGecko.
/coins/categories/*
To get the full list of categories supported by CoinGecko & its market data, as seen on Categories page.
/nfts/* 
Endpoints that return list of NFT collections on CoinGecko, and their respective floor price, market data, metadata, and historical data.
/exchanges/*
Endpoints that return list of exchanges on CoinGecko, and their respective market data, tickers (trading pairs), metadata, and historical data.
/derivatives/*
Endpoints that return list of derivative exchanges on CoinGecko, and their respective market data, tickers (trading pairs), and metadata.
/search/*
To get query search result of coins, categories and exchanges.
/search/trending/*
To get the current trending search coins on CoinGecko.
/global/*
To get global crypto data such as current and historical global market cap
/companies/*
To get public companies data such as BTC and ETH treasuries
​
Overview on interval granularity of historical data:
The data granularity (interval) for market_chart and market_chart/range endpoints is automatic and based on the date range:
1 day from current time = 5-minutely data
1 day from anytime (except from current time) = hourly data
2-90 days from current time or anytime = hourly data
above 90 days from current time or anytime = daily data (00:00 UTC) 

For ohlc endpoint, the data granularity is automatic and based on the date range:
1-2 days from current time = 30-minutely data
3-30 days from current time = 4-hourly data
above 31 days from current time = 4-daily data
For paid plan subscribers, you have the option to specify exclusive interval parameters to bypass auto granularity.
Text
Public
Analyst/Lite/Pro
Enterprise
coins/{id}/market_chart
auto
interval=daily
auto
interval=daily
auto
interval=daily
interval=hourly (100 days)
interval=5m (10 days)
coins/{id}/market_chart/range
auto
​
auto
interval=daily
auto
interval=daily
interval=hourly (100 days)
interval=5m (10 days)
coins/{id}/ohlc
auto
auto
interval=daily (180 days)
auto
interval=daily (180 days)
​
​

Endpoint Category	Description
/simple/*	The simplest & fastest endpoints to call the latest price of crypto assets, by id or contract address.
/coins/*	Endpoints that return list of coins on CoinGecko, and their respective price, market data, historical data, and metadata (image, descriptions, links, followers, token supply info, etc). More exclusive endpoints are available to discover trending coins, newly added coins and more.
/contract/*	Works similarly as /coins/* endpoint above , except that it is queried by contract address, instead of api id.
/asset_platforms	To get the full list of blockchain network supported on CoinGecko.
/coins/categories/*	To get the full list of categories supported by CoinGecko & its market data, as seen on Categories page.
/nfts/*	Endpoints that return list of NFT collections on CoinGecko, and their respective floor price, market data, metadata, and historical data.
/exchanges/*	Endpoints that return list of exchanges on CoinGecko, and their respective market data, tickers (trading pairs), metadata, and historical data.
/derivatives/*	Endpoints that return list of derivative exchanges on CoinGecko, and their respective market data, tickers (trading pairs), and metadata.
/search/*	To get query search result of coins, categories and exchanges.
/search/trending/*	To get the current trending search coins on CoinGecko.
/global/*	To get global crypto data such as current and historical global market cap
/companies/*	To get public companies data such as BTC and ETH treasuries

Text	Public	Analyst/Lite/Pro	Enterprise
coins/{id}/market_chart	auto interval=daily	auto interval=daily	auto interval=daily interval=hourly (100 days) interval=5m (10 days)
coins/{id}/market_chart/range	auto	auto interval=daily	auto interval=daily interval=hourly (100 days) interval=5m (10 days)
coins/{id}/ohlc	auto	auto interval=daily (180 days)	auto interval=daily (180 days)

Getting Started - Previous

Authentication

Next - Getting Started

Best Practices

Last modified 1mo ago