📘
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/../contract/..	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/../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/../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/..	Query all the NFT data (name, floor price, 24hr volume, ...) based on the NFT collection ID
/nfts/../contract/..	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/../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/../contract/../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/../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/../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/..	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/../pools	Query all the top pools based on the provided network
/onchain/networks/../dexes/../pools	Query all the top pools based on the provided network and decentralized exchange (DEX)
/onchain/networks/../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/..	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/../tokens/../holders_chart	Get the historical token holders chart 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/../tokens/../ohlcv/..	Get the OHLCV chart (Open, High, Low, Close, Volume) of a token based on the provided token 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/networks/../tokens/../trades	Query the last 300 trades in the past 24 hours across all pools, based on the provided token contract address on a network
💼 /onchain/categories	Query all the supported categories on GeckoTerminal
💼 /onchain/categories/../pools	Query all the pools based on the provided category ID