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 coin data of a coin (name, price, market .... including exchange tickers) on 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, 24hrs volume, etc) 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 24hrs 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 24hrs 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 coin data (name, price, market .... including exchange tickers) on CoinGecko coin page based on asset platform and particular token contract address |
| /coins/{id}/contract/{..}/market_chart | Get the historical chart data including time in UNIX, price, market cap and 24hrs 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 24hrs 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, etc.) 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, 24 hr volume....) based on the nft collection id |
| /nfts/{asset_platform_id}/contract/{..} | Query all the NFT data (name, floor price, 24 hr 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 24h volume, by number of days away from now |
| 💼 /nfts/{asset_platform_id}/contract/ {contract_address}/market_chart | Query historical market data of a NFT collection, including floor price, market cap, and 24h volume, by number of days away from now based on the provided contract address |
| 💼 /nfts/{id}/tickers | Query the latest floor price and 24h 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, .... etc) 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, .... etc), 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, .... etc) on CoinGecko |
| /derivatives/exchanges/{id} | Query the derivatives exchange’s related data (id, name, open interest, .... etc) 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/{addresses} | 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 (dexes) based on the provided network on GeckoTerminal |
| /onchain/networks/trending_pools | Query all the trending pools across all networks on GeckoTerminal |
| /onchain/networks/{network}/trending_pools | Query the trending pools based on the provided network |
| /onchain/networks/{network}/pools/{address} | Query the specific pool based on the provided network and pool address |
| /onchain/networks/{network}/pools/multi/{addresses} | 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/{network}/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 | Endpoint to query all the latest pools across all networks on GeckoTerminal |
| /onchain/search/pools | Search for pools on a network |
| /onchain/networks/{..}/tokens/{token_address}/pools | Query top pools based on the provided token contract address on a network |
| /onchain/networks/{network}/tokens/{address} | Query specific token data based on the provided token contract address on a network |
| /onchain/networks/{network}/tokens/multi/{addresses} | Query multiple tokens data based on the provided token contract addresses on a network |
| /onchain/networks/{network}/tokens/{address}/info | Query specific token info such as name, symbol, CoinGecko id etc. based on provided token contract address on a network |
| /onchain/networks/{..}/pools/{pool_address}/info | Query pool info including base and quote token info based on provided pool contract address on a network |
| /onchain/tokens/info_recently_updated | Qeery 100 most recently updated tokens info across all networks on GeckoTerminal |
| /onchain/networks/{network} /pools/{pool_address}/ohlcv/{timeframe} | Get the OHLCV chart (Open, High, Low, Close, Volume) of a pool based on the provided pool address on a network |
| /onchain/networks/{..}/pools/{pool_address}/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/.../pools | Query all the pools based on the provided category id |