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
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 |
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.) |
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 |
Trending
| Endpoint | Description |
|---|---|
| /search/trending | Query trending search coins, NFTs and categories in the last 24 hours |
News & Insights
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 |
ID Map
| Endpoint | Description |
|---|---|
| /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 |
Utility
| Endpoint | Description |
|---|---|
| /search | Search for coins, categories and markets on CoinGecko |
| /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 |
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 |
New & Trending Pools
| 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/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 | Last 300 trades in past 24 hours by pool address |
| 💼 /onchain/networks/{network}/tokens /{token_address}/trades | Last 300 trades in past 24 hours across all pools by token address |
| 💼 /onchain/networks/{network}/tokens /{token_address}/top_traders | Top token traders by token contract address |
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 |
ID Map
| Endpoint | Description |
|---|---|
| /onchain/networks | All supported networks on GeckoTerminal |
| /onchain/networks/{network}/dexes | All supported DEXs by network |
Utility
| Endpoint | Description |
|---|---|
| /onchain/search/pools | Search pools by pool address, token name, symbol, or contract address |
⚡ Need real-time data streams?
Stream prices, trades, and OHLCV data with ultra-low latency via WebSocket.
