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 will be marked:
- 💼 - exclusive for any Paid Plan subscribers
- 👑 - exclusive for Enterprise Plan subscribers only
CoinGecko Endpoints: Coins
| Endpoint | Description |
|---|---|
| /ping | Endpoint to check the API server status |
| 💼 /key | Endpoint to check account's API usage |
| /simple/price | Endpoint to query the prices of one or more coins by using their unique Coin API IDs |
| /simple/token_price/{id} | Endpoint to query the prices of one or more coins by using their unique Coin API IDs |
| /simple/supported_vs_currencies | Endpoint to query all the supported currencies on CoinGecko |
| /coins/list | Endpoint to query all the supported coins on CoinGecko with coins id, name and symbol |
| /coins/markets | Endpoint to query all the supported coins with price, market cap, volume and market related data |
| /coins/{id} | Endpoint to 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 | Endpoint to query the coin tickers on both centralized exchange (cex) and decentralized exchange (dex) based on a particular coin id |
| /coins/{id}/history | Endpoint to 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 | Endpoint to 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 | Endpoint to 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 | Endpoint to get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin id |
| 💼 /coins/{id}/ohlc/range | Endpoint to 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 | Endpoint to query the top 30 coins with largest price gain and loss by a specific time duration |
| 💼 /coins/list/new | Endpoint to query the latest 200 coins that recently listed on CoinGecko |
| 👑 /coins/{id}/circulating_supply_chart | Endpoint to 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 | Endpoint to query historical circulating supply of a coin, within a range of timestamp based on the provided coin id |
| 👑 /coins/{id}/total_supply_chart | Endpoint to 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 | Endpoint to query historical total supply of a coin, within a range of timestamp based on the provided coin id |
| /coins/{id}/contract/{contract_address} | Endpoint to 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 | Endpoint to 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 | Endpoint to 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 | Endpoint to query all the coins categories on CoinGecko |
| /coins/categories | Endpoint to query all the coins categories with market data (market cap, volume, etc.) on CoinGecko |
CoinGecko Endpoints: NFT
| Endpoint | Description |
|---|---|
| /nfts/list | Endpoint to query all supported NFTs with id, contract address, name, asset platform id and symbol on CoinGecko |
| /nfts/{id} | Endpoint to to query all the NFT data (name, floor price, 24 hr volume....) based on the nft collection id |
| /nfts/{asset_platform_id}/contract/{..} | Endpoint to query all the NFT data (name, floor price, 24 hr volume....) based on the nft collection contract address and respective asset platform |
| 💼 /nfts/markets | Endpoint to query all the supported NFT collections with floor price, market cap, volume and market related data on CoinGecko |
| 💼 /nfts/{id}/market_chart | Endpoint to 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 | Endpoint to 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 | Endpoint to 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 | Endpoint to query all the supported exchanges with exchanges’ data (id, name, country, .... etc) that have active trading volumes on CoinGecko |
| /exchanges/list | Endpoint to query all the exchanges with id and name |
| /exchanges/{id} | Endpoint to query exchange’s data (name, year established, country, .... etc), exchange volume in BTC and tickers based on exchange’s id |
| /exchanges/{id}/tickers | Endpoint to query exchange's tickers based on exchange’s id |
| /exchanges/{id}/volume_chart | Endpoint to 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 | Endpoint to query the historical volume chart data in BTC by specifying date range in UNIX based on exchange’s id |
| /derivatives | Endpoint to query all the tickers from derivatives exchanges on CoinGecko |
| /derivatives/exchanges | Endpoint to query all the derivatives exchanges with related data (id, name, open interest, .... etc) on CoinGecko |
| /derivatives/exchanges/{id} | Endpoint to query the derivatives exchange’s related data (id, name, open interest, .... etc) based on the exchanges’ id |
| /derivatives/exchanges/list | Endpoint to to query all the derivatives exchanges with id and name on CoinGecko |
CoinGecko Endpoints: General
| Endpoint | Description |
|---|---|
| /exchange_rates | Endpoint to query BTC exchange rates with other currencies. |
| /asset_platforms | Endpoint to query all the asset platforms (blockchain networks) on CoinGecko. |
| 👑 /token_lists/{asset_platform_id}/all.json | Endpoint to get full list of tokens of a blockchain network (asset platform) that is supported by Ethereum token list standard |
| /search | Endpoint to search for coins, categories and markets listed on CoinGecko |
| /search/trending | Endpoint to query trending search coins, nfts and categories on CoinGecko in the last 24 hours |
| /global | Endpoint to query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap and etc |
| /global/decentralized_finance_defi | Endpoint to query cryptocurrency global decentralized finance (defi) data including defi market cap, trading volume |
| 💼 /global/market_cap_chart | Endpoint to query historical global market cap and volume data by number of days away from now |
| /companies/public_treasury/{coin_id} | Endpoint to query public companies’ bitcoin or ethereum holdings |
💼 Onchain DEX Endpoints (GeckoTerminal)
| Endpoint | Description |
|---|---|
| /onchain/simple/networks/{..}/token_price/{addresses} | Endpoint to get token price based on the provided token contract address on a network |
| /onchain/networks | Endpoint to query all the supported networks on GeckoTerminal |
| /onchain/networks/{network}/dexes | Endpoint to query all the supported decentralized exchanges (dexes) based on the provided network on GeckoTerminal |
| /onchain/networks/trending_pools | Endpoint to query all the trending pools across all networks on GeckoTerminal |
| /onchain/networks/{network}/trending_pools | Endpoint to query the trending pools based on the provided network |
| /onchain/networks/{network}/pools/{address} | Endpoint to query the specific pool based on the provided network and pool address |
| /onchain/networks/{network}/pools/multi/{addresses} | Endpoint to query multiple pools based on the provided network and pool address |
| /onchain/networks/{network}/pools | Endpoint to query all the top pools based on the provided network |
| /onchain/networks/{network}/dexes/{dex}/pools | Endpoint to query all the top pools based on the provided network and decentralized exchange (dex) |
| /onchain/networks/{network}/new_pools | Endpoint to 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 | Endpoint to search for pools on a network |
| /onchain/networks/{..}/tokens/{token_address}/pools | Endpoint to query top pools based on the provided token contract address on a network |
| /onchain/networks/{network}/tokens/{address} | Endpoint to query specific token data based on the provided token contract address on a network |
| /onchain/networks/{network}/tokens/multi/{addresses} | Endpoint to query multiple tokens data based on the provided token contract addresses on a network |
| /onchain/networks/{network}/tokens/{address}/info | Endpoint to 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 | Endpoint to query pool info including base and quote token info based on provided pool contract address on a network |
| /onchain/tokens/info_recently_updated | Endpoint to query 100 most recently updated tokens info across all networks on GeckoTerminal |
| /onchain/networks/{network} /pools/{pool_address}/ohlcv/{timeframe} | Endpoint to 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 | Endpoint to query the last 300 trades in the past 24 hours based on the provided pool address |