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
/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/*
/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.
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)
Last updated
Was this helpful?