Skip to main content

Set up your API key yet?

Authenticate your requests to start using the Pro API.
Plan-specific endpoint access is marked as:Some endpoints have parameters or data access exclusive to certain plans โ€” refer to the endpoint reference page for details.

CoinGecko

Price

EndpointDescription
/simple/priceQuery 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

EndpointDescription
/coins/marketsQuery 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}/tickersQuery coin tickers on both CEX and DEX by coin ID
/coins/{id}/historyQuery historical data (price, market cap, 24hr volume, etc.) at a given date by coin ID
๐Ÿ’ผ /coins/list/newQuery the latest 200 coins recently listed on CoinGecko
๐Ÿ’ผ /coins/top_gainers_losersQuery top 30 coins with largest price gain and loss by time duration
๐Ÿ’ผ /coins/{id}/supply_breakdownQuery the supply breakdown of a coin based on provided coin ID

Coin Charts

EndpointDescription
/coins/{id}/market_chartHistorical chart data (price, market cap, 24hr volume) by coin ID
/coins/{id}/market_chart/rangeHistorical 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}/ohlcOHLC chart by coin ID
๐Ÿ’ผ /coins/{id}/ohlc/rangeOHLC chart within a time range by coin ID
๐Ÿ‘‘ /coins/{id}/circulating_supply_chartHistorical 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_chartHistorical total supply by coin ID
๐Ÿ‘‘ /coins/{id}/total_supply_chart/rangeHistorical total supply within a time range by coin ID

Categories

EndpointDescription
/coins/categories/listQuery all supported coin categories on CoinGecko
/coins/categoriesQuery all coin categories with market data (market cap, volume, etc.)

Exchanges

EndpointDescription
/exchanges/listQuery all supported exchanges with ID and name
/exchangesQuery all supported exchanges with data (ID, name, country, etc.)
/exchanges/{id}Query exchange data and top 100 tickers by exchange ID
/exchanges/{id}/tickersQuery exchange tickers by exchange ID
/exchanges/{id}/volume_chartHistorical volume chart data in BTC by exchange ID
๐Ÿ’ผ /exchanges/{id}/volume_chart/rangeHistorical volume chart data in BTC within a date range by exchange ID

Derivatives

EndpointDescription
/derivatives/exchanges/listQuery all supported derivatives exchanges with ID and name
/derivativesQuery all tickers from derivatives exchanges
/derivatives/exchangesQuery all derivatives exchanges with data (ID, name, open interest, etc.)
/derivatives/exchanges/{id}Query derivatives exchange data by exchange ID

Public Treasury

EndpointDescription
/entities/listQuery 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

EndpointDescription
/nfts/listQuery 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/marketsQuery all supported NFT collections with floor price, market cap, volume and market data
๐Ÿ’ผ /nfts/{id}/market_chartHistorical 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}/tickersLatest floor price and 24hr volume per NFT marketplace by collection ID
EndpointDescription
/search/trendingQuery trending search coins, NFTs and categories in the last 24 hours

News & Insights

EndpointDescription
๐Ÿ’ผ /newsQuery the latest crypto news and guides on CoinGecko
๐Ÿ‘‘ /insightsQuery the latest coin insights on CoinGecko

Global

EndpointDescription
/globalQuery global crypto data (active cryptocurrencies, markets, total market cap, etc.)
/global/decentralized_finance_defiQuery top 100 global DeFi data (market cap, trading volume)
๐Ÿ’ผ /global/market_cap_chartHistorical global market cap and volume data

ID Map

EndpointDescription
/coins/listQuery all supported coins with coin ID, name and symbol
/asset_platformsQuery all supported asset platforms (blockchain networks)
/token_lists/{asset_platform_id}/all.jsonFull list of tokens on a blockchain network supported by Ethereum token list standard
/simple/supported_vs_currenciesQuery all supported currencies on CoinGecko

Utility

EndpointDescription
/searchSearch for coins, categories and markets on CoinGecko
/exchange_ratesQuery BTC exchange rates with other currencies
/pingCheck API server status
๐Ÿ’ผ /keyMonitor account API usage (rate limits, credits, etc.)

Onchain

Price

EndpointDescription
/onchain/simple/networks/{network}
/token_price/{addresses}
Token price by token contract addresses on a network

Pools

EndpointDescription
/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}/poolsTop 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/search/poolsSearch pools by pool address, token name, symbol, or contract address
๐Ÿ’ผ /onchain/pools/megafilterQuery pools by various filters across all networks
EndpointDescription
/onchain/networks/new_poolsLatest pools across all networks
/onchain/networks/{network}/new_poolsLatest pools by network
/onchain/networks/trending_poolsTrending pools across all networks
/onchain/networks/{network}
/trending_pools
Trending pools by network
๐Ÿ’ผ /onchain/pools/trending_searchTrending search pools across all networks

Tokens

EndpointDescription
/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_updated100 most recently updated tokens info across all networks

Charts

EndpointDescription
/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

EndpointDescription
/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

EndpointDescription
๐Ÿ’ผ /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

EndpointDescription
๐Ÿ’ผ /onchain/categoriesQuery all supported categories on GeckoTerminal
๐Ÿ’ผ /onchain/categories/{category_id}
/pools
Query pools by category ID

ID Map

EndpointDescription
/onchain/networksAll supported networks on GeckoTerminal
/onchain/networks/{network}/dexesAll supported DEXs by network

โšก Need real-time data streams?
Stream prices, trades, and OHLCV data with ultra-low latency via WebSocket.
Requires Analyst plan & above.