πŸ“‘ Endpoint Overview

πŸ“˜

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

EndpointDescription
/pingEndpoint to check the API server status
πŸ’Ό /keyEndpoint to check account's API usage
/simple/priceEndpoint 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_currenciesEndpoint to query all the supported currencies on CoinGecko
/coins/listEndpoint to query all the supported coins on CoinGecko with coins id, name and symbol
/coins/marketsEndpoint 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}/tickersEndpoint to query the coin tickers on both centralized exchange (cex) and decentralized exchange (dex) based on a particular coin id
/coins/{id}/historyEndpoint 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_chartEndpoint 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/rangeEndpoint 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-ohlcEndpoint to get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin id
πŸ’Ό /coins/{id}/ohlc/rangeEndpoint 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_losersEndpoint to query the top 30 coins with largest price gain and loss by a specific time duration
πŸ’Ό /coins/list/newEndpoint to query the latest 200 coins that recently listed on CoinGecko
πŸ‘‘ /coins/{id}/circulating_supply_chartEndpoint 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/rangeEndpoint to query historical circulating supply of a coin, within a range of timestamp based on the provided coin id
πŸ‘‘ /coins/{id}/total_supply_chartEndpoint 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/rangeEndpoint 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_chartEndpoint 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/rangeEndpoint 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/listEndpoint to query all the coins categories on CoinGecko
/coins/categoriesEndpoint to query all the coins categories with market data (market cap, volume, etc.) on CoinGecko

CoinGecko Endpoints: NFT

EndpointDescription
/nfts/listEndpoint 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/marketsEndpoint to query all the supported NFT collections with floor price, market cap, volume and market related data on CoinGecko
πŸ’Ό /nfts/{id}/market_chartEndpoint 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_chartEndpoint 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}/tickersEndpoint 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

EndpointDescription
/exchangesEndpoint to query all the supported exchanges with exchanges’ data (id, name, country, .... etc) that have active trading volumes on CoinGecko
/exchanges/listEndpoint 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}/tickersEndpoint to query exchange's tickers based on exchange’s id
/exchanges/{id}/volume_chartEndpoint 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/rangeEndpoint to query the historical volume chart data in BTC by specifying date range in UNIX based on exchange’s id
/derivativesEndpoint to query all the tickers from derivatives exchanges on CoinGecko
/derivatives/exchangesEndpoint 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/listEndpoint to to query all the derivatives exchanges with id and name on CoinGecko

CoinGecko Endpoints: General

EndpointDescription
/exchange_ratesEndpoint to query BTC exchange rates with other currencies.
/asset_platformsEndpoint to query all the asset platforms (blockchain networks) on CoinGecko.
πŸ‘‘ /token_lists/{asset_platform_id}/all.jsonEndpoint to get full list of tokens of a blockchain network (asset platform) that is supported by Ethereum token list standard
/searchEndpoint to search for coins, categories and markets listed on CoinGecko
/search/trendingEndpoint to query trending search coins, nfts and categories on CoinGecko in the last 24 hours
/globalEndpoint to query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap and etc
/global/decentralized_finance_defiEndpoint to query cryptocurrency global decentralized finance (defi) data including defi market cap, trading volume
πŸ’Ό /global/market_cap_chartEndpoint 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)

EndpointDescription
/onchain/simple/networks/{..}/token_price/{addresses}Endpoint to get token price based on the provided token contract address on a network
/onchain/networksEndpoint to query all the supported networks on GeckoTerminal
/onchain/networks/{network}/dexesEndpoint to query all the supported decentralized exchanges (dexes) based on the provided network on GeckoTerminal
/onchain/networks/trending_poolsEndpoint to query all the trending pools across all networks on GeckoTerminal
/onchain/networks/{network}/trending_poolsEndpoint 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}/poolsEndpoint to query all the top pools based on the provided network
/onchain/networks/{network}/dexes/{dex}/poolsEndpoint to query all the top pools based on the provided network and decentralized exchange (dex)
/onchain/networks/{network}/new_poolsEndpoint to query all the latest pools based on provided network
/onchain/networks/new_poolsEndpoint to query all the latest pools across all networks on GeckoTerminal
/onchain/search/poolsEndpoint to search for pools on a network
/onchain/networks/{..}/tokens/{token_address}/poolsEndpoint 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}/infoEndpoint 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}/infoEndpoint to query pool info including base and quote token info based on provided pool contract address on a network
/onchain/tokens/info_recently_updatedEndpoint 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}/tradesEndpoint to query the last 300 trades in the past 24 hours based on the provided pool address