Notes
For Pro-API users (any paid plan subscribers), you get to access all the endpoints listed below, except those that marked with 👑.
- Some endpoints may have parameters or data access that are exclusive to different plan subscribers, please refer to the endpoint reference for details.
- In the API Reference section, the distinction between Paid Plan and Enterprise Plan endpoint access will be marked as below:
- 💼 — exclusive for any Paid Plan subscribers: Analyst / Lite / Pro
- 👑 — exclusive for Enterprise Plan subscribers only.
CoinGecko Endpoints: Coins
| Endpoint | Description |
|---|---|
| /ping | Check the API server status |
| 💼 /key | Check account's API usage |
| /simple/price | Query the prices of one or more coins by using their unique Coin API IDs |
| /simple/token_price/{id} | Query the prices of one or more coins by using their unique Coin API IDs |
| /simple/supported_vs_currencies | Query all the supported currencies on CoinGecko |
| /coins/list | Query all the supported coins on CoinGecko with coins ID, name and symbol |
| /coins/markets | Query all the supported coins with price, market cap, volume and market related data |
| /coins/{id} | Query all the metadata (image, websites, socials, description, contract address, etc.) from the CoinGecko coin page based on a particular coin ID |
| /coins/{id}/tickers | Query the coin tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular coin ID |
| /coins/{id}/history | Query the historical data (price, market cap, 24hr volume, ...) at a given date for a coin based on a particular coin ID |
| /coins/{id}/market_chart | Get the historical chart data of a coin including time in UNIX, price, market cap and 24hr volume based on particular coin ID |
| /coins/{id}/market_chart/range | Get the historical chart data of a coin within certain time range in UNIX along with price, market cap and 24hr volume based on particular coin ID |
| /coins-id-ohlc | Get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin ID |
| 💼 /coins/{id}/ohlc/range | Get the OHLC chart (Open, High, Low, Close) of a coin within a range of timestamp based on particular coin ID |
| 💼 /coins/top_gainers_losers | Query the top 30 coins with largest price gain and loss by a specific time duration |
| 💼 /coins/list/new | Query the latest 200 coins that recently listed on CoinGecko |
| 👑 /coins/{id}/circulating_supply_chart | Query historical circulating supply of a coin by number of days away from now based on provided coin ID |
| 👑 /coins/{id}/circulating_supply_chart/range | Query historical circulating supply of a coin, within a range of timestamp based on the provided coin ID |
| 👑 /coins/{id}/total_supply_chart | Query historical total supply of a coin by number of days away from now based on provided coin ID |
| 👑 /coins/{id}/total_supply_chart/range | Query historical total supply of a coin, within a range of timestamp based on the provided coin ID |
| /coins/{id}/contract/{contract_address} | Query all the metadata (image, websites, socials, description, contract address, etc.) from the CoinGecko coin page based on an asset platform and a particular token contract address |
| /coins/{id}/contract/../market_chart | Get the historical chart data including time in UNIX, price, market cap and 24hr volume based on asset platform and particular token contract address |
| /coins/{id}/contract/../market_chart/range | Get the historical chart data within certain time range in UNIX along with price, market cap and 24hr volume based on asset platform and particular token contract address |
| /coins/categories/list | Query all the coins categories on CoinGecko |
| /coins/categories | Query all the coins categories with market data (market cap, volume, ...) on CoinGecko |
CoinGecko Endpoints: NFT
| Endpoint | Description |
|---|---|
| /nfts/list | Query all supported NFTs with ID, contract address, name, asset platform ID and symbol on CoinGecko |
| /nfts/{id} | Query all the NFT data (name, floor price, 24hr volume, ...) based on the NFT collection ID |
| /nfts/{asset_platform_id}/../{contract_address} | Query all the NFT data (name, floor price, 24hr volume, ...) based on the NFT collection contract address and respective asset platform |
| 💼 /nfts/markets | Query all the supported NFT collections with floor price, market cap, volume and market related data on CoinGecko |
| 💼 /nfts/{id}/market_chart | Query historical market data of a NFT collection, including floor price, market cap, and 24hr volume, by number of days away from now |
| 💼 /nfts/{asset_platform_id}/../market_chart | Query historical market data of a NFT collection, including floor price, market cap, and 24hr volume, by number of days away from now based on the provided contract address |
| 💼 /nfts/{id}/tickers | Query the latest floor price and 24hr volume of a NFT collection, on each NFT marketplace, e.g. OpenSea and LooksRare |
CoinGecko Endpoints: Exchanges & Derivatives
| Endpoint | Description |
|---|---|
| /exchanges | Query all the supported exchanges with exchanges’ data (ID, name, country, ...) that have active trading volumes on CoinGecko |
| /exchanges/list | Query all the exchanges with ID and name |
| /exchanges/{id} | Query exchange’s data (name, year established, country, ...), exchange volume in BTC and tickers based on exchange’s ID |
| /exchanges/{id}/tickers | Query exchange's tickers based on exchange’s ID |
| /exchanges/{id}/volume_chart | Query the historical volume chart data with time in UNIX and trading volume data in BTC based on exchange’s ID |
| 💼 /exchanges/{id}/volume_chart/range | Query the historical volume chart data in BTC by specifying date range in UNIX based on exchange’s ID |
| /derivatives | Query all the tickers from derivatives exchanges on CoinGecko |
| /derivatives/exchanges | Query all the derivatives exchanges with related data (ID, name, open interest, ...) on CoinGecko |
| /derivatives/exchanges/{id} | Query the derivatives exchange’s related data (ID, name, open interest, ...) based on the exchanges’ ID |
| /derivatives/exchanges/list | Query all the derivatives exchanges with ID and name on CoinGecko |
CoinGecko Endpoints: General
| Endpoint | Description |
|---|---|
| /exchange_rates | Query BTC exchange rates with other currencies |
| /asset_platforms | Query all the asset platforms (blockchain networks) on CoinGecko |
| 👑 /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 |
| /search | Search for coins, categories and markets listed on CoinGecko |
| /search/trending | Query trending search coins, NFTs and categories on CoinGecko in the last 24 hours |
| /global | Query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap and etc. |
| /global/decentralized_finance_defi | Query cryptocurrency global decentralized finance (DeFi) data including DeFi market cap, trading volume |
| 💼 /global/market_cap_chart | Query historical global market cap and volume data by number of days away from now |
| /companies/public_treasury/{coin_id} | Query public companies’ Bitcoin or Ethereum holdings |
💼 Onchain DEX Endpoints (GeckoTerminal)
| Endpoint | Description |
|---|---|
| /onchain/simple/networks/../token_price/.. | Get token price based on the provided token contract address on a network |
| /onchain/networks | Query all the supported networks on GeckoTerminal |
| /onchain/networks/{network}/dexes | Query all the supported decentralized exchanges (DEXs) based on the provided network on GeckoTerminal |
| /onchain/networks/trending_pools | Query all the trending pools across all networks on GeckoTerminal |
| /onchain/networks/../trending_pools | Query the trending pools based on the provided network |
| /onchain/networks/../pools/{address} | Query the specific pool based on the provided network and pool address |
| /onchain/networks/../pools/multi/.. | Query multiple pools based on the provided network and pool address |
| /onchain/networks/{network}/pools | Query all the top pools based on the provided network |
| /onchain/networks/../dexes/{dex}/pools | Query all the top pools based on the provided network and decentralized exchange (DEX) |
| /onchain/networks/{network}/new_pools | Query all the latest pools based on provided network |
| /onchain/networks/new_pools | Query all the latest pools across all networks on GeckoTerminal |
| 🔥 💼 /onchain/pools/megafilter | Query pools based on various filters across all networks on GeckoTerminal |
| /onchain/search/pools | Search for pools on a network |
| 💼 /onchain/pools/trending_search | Query all the trending search pools across all networks on GeckoTerminal |
| /onchain/networks/../tokens/../pools | Query top pools based on the provided token contract address on a network |
| /onchain/networks/../tokens/{address} | Query specific token data based on the provided token contract address on a network |
| /onchain/networks/../tokens/multi/.. | Query multiple tokens data based on the provided token contract addresses on a network |
| /onchain/networks/../tokens/../info | Query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network |
| /onchain/networks/../pools/../info | Query pool metadata (base and quote token details, image, socials, websites, description, contract address, etc.) based on a provided pool contract address on a network |
| /onchain/tokens/info_recently_updated | Query 100 most recently updated tokens info across all networks on GeckoTerminal |
| 💼 /onchain/networks/../tokens/../top_holders | Query top token holders based on the provided token contract address on a network |
| /onchain/networks/../pools/../ohlcv/.. | Get the OHLCV chart (Open, High, Low, Close, Volume) of a pool based on the provided pool address on a network |
| /onchain/networks/../pools/../trades | Query the last 300 trades in the past 24 hours based on the provided pool address |
| /onchain/categories | Query all the supported categories on GeckoTerminal |
| /onchain/categories/{category_id}/pools | Query all the pools based on the provided category ID |