Endpoint Overview - CoinGecko API

Set up your API key yet?

Authenticate your requests to start using the Pro API.

Plan-specific endpoint access is marked as:

💼 — Analyst plan & above only
👑 — Enterprise plan only
All other endpoints are available to all paid plans, including Basic plan

Some endpoints have parameters or data access exclusive to certain plans — refer to the endpoint reference page for details.

CoinGecko

Price

Endpoint	Description
/simple/price	Query prices of one or more coins by Coin API IDs, symbols, or names
/simple/token_price/{id}	Query one or more token prices by token contract addresses

Search & ID Map

Endpoint	Description
/search	Search for coins, categories and markets on CoinGecko
/coins/list	Query all supported coins with coin ID, name and symbol
/asset_platforms	Query all supported asset platforms (blockchain networks)
/token_lists/{asset_platform_id}/all.json	Full list of tokens on a blockchain network supported by Ethereum token list standard
/simple/supported_vs_currencies	Query all supported currencies on CoinGecko

Coins

Endpoint	Description
/coins/markets	Query all supported coins with price, market cap, volume and market data
/coins/{id}	Query all metadata and market data of a coin by coin ID
/coins/{id}/contract/{contract_address}	Query all metadata and market data of a coin by asset platform and token contract address
/coins/{id}/tickers	Query coin tickers on both CEX and DEX by coin ID
/coins/{id}/history	Query historical data (price, market cap, 24hr volume, etc.) at a given date by coin ID
💼 /coins/list/new	Query the latest 200 coins recently listed on CoinGecko
💼 /coins/top_gainers_losers	Query top 30 coins with largest price gain and loss by time duration
💼 /coins/{id}/supply_breakdown	Query the supply breakdown of a coin based on provided coin ID

Coin Charts

Endpoint	Description
/coins/{id}/market_chart	Historical chart data (price, market cap, 24hr volume) by coin ID
/coins/{id}/market_chart/range	Historical chart data within a time range by coin ID
/coins/{id}/contract /{contract_address}/market_chart	Historical chart data by asset platform and token contract address
/coins/{id}/contract /{contract_address}/market_chart/range	Historical chart data within a time range by asset platform and token contract address
/coins/{id}/ohlc	OHLC chart by coin ID
💼 /coins/{id}/ohlc/range	OHLC chart within a time range by coin ID
👑 /coins/{id}/circulating_supply_chart	Historical circulating supply by coin ID
👑 /coins/{id} /circulating_supply_chart/range	Historical circulating supply within a time range by coin ID
👑 /coins/{id}/total_supply_chart	Historical total supply by coin ID
👑 /coins/{id}/total_supply_chart/range	Historical total supply within a time range by coin ID

Categories

Endpoint	Description
/coins/categories/list	Query all supported coin categories on CoinGecko
/coins/categories	Query all coin categories with market data (market cap, volume, etc.)

RWA

Endpoint	Description
/rwas/list	Query all supported tokenized real world assets (RWAs) with RWA ID, name and symbol
/rwas/markets	Query all supported RWAs with price, market cap, volume and market data
/rwas/{id}	Query all metadata, market data and tokens of an RWA by RWA ID
/rwas/{id}/tickers	Query RWA token tickers on centralized and decentralized exchanges by RWA ID
/rwas/{id}/market_chart	Query historical chart data of an RWA including price, market cap and 24hrs volume
/rwas/issuers/list	Query all supported RWA issuers with issuer ID and name
/rwas/issuers/{id}	Query market data and tokens of an RWA issuer by issuer ID

Exchanges

Endpoint	Description
/exchanges/list	Query all supported exchanges with ID and name
/exchanges	Query all supported exchanges with data (ID, name, country, etc.)
/exchanges/{id}	Query exchange data and top 100 tickers by exchange ID
/exchanges/{id}/tickers	Query exchange tickers by exchange ID
/exchanges/{id}/volume_chart	Historical volume chart data in BTC by exchange ID
💼 /exchanges/{id}/volume_chart/range	Historical volume chart data in BTC within a date range by exchange ID

Derivatives

Endpoint	Description
/derivatives/exchanges/list	Query all supported derivatives exchanges with ID and name
/derivatives	Query all tickers from derivatives exchanges
/derivatives/exchanges	Query all derivatives exchanges with data (ID, name, open interest, etc.)
/derivatives/exchanges/{id}	Query derivatives exchange data by exchange ID

Public Treasury

Endpoint	Description
/entities/list	Query all supported entities with entity ID, name, symbol, and country
/{entity}/public_treasury/{coin_id}	Query public companies’ and governments’ crypto holdings by coin ID
/public_treasury/{entity_id}	Query public companies’ and governments’ crypto holdings by entity ID
/public_treasury/{entity_id}/{coin_id} /holding_chart	Historical crypto holdings chart by entity ID and coin ID
/public_treasury/{entity_id} /transaction_history	Crypto transaction history by entity ID

NFTs

Endpoint	Description
/nfts/list	Query all supported NFTs with ID, contract address, name, asset platform ID and symbol
/nfts/{id}	Query NFT data (name, floor price, 24hr volume, etc.) by collection ID
/nfts/{asset_platform_id}/contract /{contract_address}	Query NFT data by collection contract address and asset platform
💼 /nfts/markets	Query all supported NFT collections with floor price, market cap, volume and market data
💼 /nfts/{id}/market_chart	Historical NFT market data (floor price, market cap, 24hr volume) by collection ID
💼 /nfts/{asset_platform_id}/contract /{contract_address}/market_chart	Historical NFT market data by contract address
💼 /nfts/{id}/tickers	Latest floor price and 24hr volume per NFT marketplace by collection ID

Endpoint	Description
/search/trending	Query trending search coins, NFTs and categories in the last 24 hours

News & Insights

Endpoint	Description
💼 /news	Query the latest crypto news and guides on CoinGecko
👑 /insights	Query the latest coin insights on CoinGecko

Global

Endpoint	Description
/global	Query global crypto data (active cryptocurrencies, markets, total market cap, etc.)
/global/decentralized_finance_defi	Query top 100 global DeFi data (market cap, trading volume)
💼 /global/market_cap_chart	Historical global market cap and volume data

Utility

Endpoint	Description
/exchange_rates	Query BTC exchange rates with other currencies
/ping	Check API server status
/key	Monitor account API usage (rate limits, credits, etc.)

Onchain

Price

Endpoint	Description
/onchain/simple/networks/{network} /token_price/{addresses}	Token price by token contract addresses on a network
👑 /onchain/simple/token_price/multi	Token price by token contract addresses across networks

Search & ID Map

Endpoint	Description
/onchain/search/pools	Search pools by pool address, token name, symbol, or contract address
/onchain/networks	All supported networks on GeckoTerminal
/onchain/networks/{network}/dexes	All supported DEXs by network

Pools

Endpoint	Description
/onchain/networks/{network}/pools /{address}	Query specific pool by network and pool address
/onchain/networks/{network}/pools/multi /{addresses}	Query multiple pools by network and pool addresses
/onchain/networks/{network}/pools /{pool_address}/info	Pool metadata (token details, socials, etc.) by pool address
/onchain/networks/{network}/pools	Top pools by network
/onchain/networks/{network}/dexes/{dex} /pools	Top pools by network and DEX
/onchain/networks/{network}/tokens /{token_address}/pools	Top pools by token contract address
💼 /onchain/pools/megafilter	Query pools by various filters across all networks

Endpoint	Description
/onchain/networks/new_pools	Latest pools across all networks
/onchain/networks/{network}/new_pools	Latest pools by network
/onchain/networks/trending_pools	Trending pools across all networks
/onchain/networks/{network} /trending_pools	Trending pools by network
💼 /onchain/pools/trending_search	Trending search pools across all networks

Tokens

Endpoint	Description
/onchain/networks/{network}/tokens /{address}	Token data by token contract address on a network
/onchain/networks/{network}/tokens/multi /{addresses}	Multiple tokens data by token contract addresses on a network
👑 /onchain/tokens/multi	Multiple tokens data by token contract addresses across networks
/onchain/networks/{network}/tokens /{address}/info	Token metadata (name, symbol, CoinGecko ID, socials, etc.) by token contract address
/onchain/tokens/info_recently_updated	100 most recently updated tokens info across all networks

Charts

Endpoint	Description
/onchain/networks/{network}/pools /{pool_address}/ohlcv/{timeframe}	Pool OHLCV chart by pool address
💼 /onchain/networks/{network}/tokens /{token_address}/ohlcv/{timeframe}	Token OHLCV chart by token address

Trades

Endpoint	Description
/onchain/networks/{network}/pools /{pool_address}/trades	Trades by pool address
💼 /onchain/networks/{network}/pools /{pool_address}/trades/range	Trades within a time range by pool address
💼 /onchain/networks/{network}/tokens /{token_address}/trades	Trades across all pools by token address
💼 /onchain/networks/{network}/tokens /{token_address}/trades/range	Trades within a time range across all pools by token address
💼 /onchain/networks/{network}/tokens /{token_address}/top_traders	Top token traders by token contract address

Wallets

Endpoint	Description
💼 /onchain/wallets/{address}/balances	Query the token balances of a wallet address across networks
💼 /onchain/networks/{network}/wallets /{address}/transfers	Query the token transfers of a wallet address on a network

Holders

Endpoint	Description
💼 /onchain/networks/{network}/tokens /{address}/top_holders	Top token holders by token contract address
💼 /onchain/networks/{network}/tokens /{token_address}/holders_chart	Historical token holders chart by token contract address

Categories

Endpoint	Description
💼 /onchain/categories	Query all supported categories on GeckoTerminal
💼 /onchain/categories/{category_id} /pools	Query pools by category ID

⚡ Need real-time data streams?
Stream prices, trades, and OHLCV data with ultra-low latency via WebSocket.

Requires Basic plan & above.