Skip to main content
The CoinGecko MCP Server exposes two tools to your AI agent:
ToolDescription
search_docsLooks up SDK documentation — methods, parameters, and request structure — before writing any code.
executeRuns TypeScript code against the CoinGecko SDK in a sandboxed environment. Supports multiple operations in a single call.

Available Methods for execute

The table below lists all methods the execute tool can call. Each method maps to an SDK method in the official TypeScript SDK.
MethodEndpointDescription
simple.price.get()/simple/priceQuery prices of one or more coins by Coin API IDs, symbols, or names
simple.tokenPrice.getID()/simple/token_price/{id}Query one or more token prices by token contract addresses
coins.markets.get()/coins/marketsQuery all supported coins with price, market cap, volume and market data
coins.getID()/coins/{id}Query all metadata and market data of a coin by coin ID
coins.contract.get()/coins/{id}/contract/{contract_address}Query all metadata and market data of a coin by asset platform and token contract address
coins.tickers.get()/coins/{id}/tickersQuery coin tickers on both CEX and DEX by coin ID
coins.history.get()/coins/{id}/historyQuery historical data (price, market cap, 24hr volume, etc.) at a given date by coin ID
coins.list.getNew()/coins/list/newQuery the latest 200 coins recently listed on CoinGecko
coins.topGainersLosers.get()/coins/top_gainers_losersQuery top 30 coins with largest price gain and loss by time duration
coins.marketChart.get()/coins/{id}/market_chartHistorical chart data (price, market cap, 24hr volume) by coin ID
coins.marketChart.getRange()/coins/{id}/market_chart/rangeHistorical chart data within a time range by coin ID
coins.contract.marketChart.get()/coins/{id}/contract
/{contract_address}/market_chart
Historical chart data by asset platform and token contract address
coins.contract.marketChart.getRange()/coins/{id}/contract
/{contract_address}/market_chart/range
Historical chart data within a time range by asset platform and token contract address
coins.ohlc.get()/coins/{id}/ohlcOHLC chart by coin ID
coins.ohlc.getRange()/coins/{id}/ohlc/rangeOHLC chart within a time range by coin ID
coins.circulatingSupplyChart.get()/coins/{id}/circulating_supply_chartHistorical circulating supply by coin ID
coins.circulatingSupplyChart.getRange()/coins/{id}
/circulating_supply_chart/range
Historical circulating supply within a time range by coin ID
coins.totalSupplyChart.get()/coins/{id}/total_supply_chartHistorical total supply by coin ID
coins.totalSupplyChart.getRange()/coins/{id}/total_supply_chart/rangeHistorical total supply within a time range by coin ID
coins.categories.getList()/coins/categories/listQuery all supported coin categories on CoinGecko
coins.categories.get()/coins/categoriesQuery all coin categories with market data (market cap, volume, etc.)
exchanges.getList()/exchanges/listQuery all supported exchanges with ID and name
exchanges.get()/exchangesQuery all supported exchanges with data (ID, name, country, etc.)
exchanges.getID()/exchanges/{id}Query exchange data and top 100 tickers by exchange ID
exchanges.tickers.get()/exchanges/{id}/tickersQuery exchange tickers by exchange ID
exchanges.volumeChart.get()/exchanges/{id}/volume_chartHistorical volume chart data in BTC by exchange ID
exchanges.volumeChart.getRange()/exchanges/{id}/volume_chart/rangeHistorical volume chart data in BTC within a date range by exchange ID
derivatives.exchanges.getList()/derivatives/exchanges/listQuery all supported derivatives exchanges with ID and name
derivatives.get()/derivativesQuery all tickers from derivatives exchanges
derivatives.exchanges.get()/derivatives/exchangesQuery all derivatives exchanges with data (ID, name, open interest, etc.)
derivatives.exchanges.getID()/derivatives/exchanges/{id}Query derivatives exchange data by exchange ID
entities.getList()/entities/listQuery all supported entities with entity ID, name, symbol, and country
publicTreasury.getCoinID()/{entity}/public_treasury/{coin_id}Query public companies’ and governments’ crypto holdings by coin ID
publicTreasury.getEntityID()/public_treasury/{entity_id}Query public companies’ and governments’ crypto holdings by entity ID
publicTreasury.getHoldingChart()/public_treasury/{entity_id}/{coin_id}
/holding_chart
Historical crypto holdings chart by entity ID and coin ID
publicTreasury.getTransactionHistory()/public_treasury/{entity_id}
/transaction_history
Crypto transaction history by entity ID
nfts.getList()/nfts/listQuery all supported NFTs with ID, contract address, name, asset platform ID and symbol
nfts.getID()/nfts/{id}Query NFT data (name, floor price, 24hr volume, etc.) by collection ID
nfts.contract.getContractAddress()/nfts/{asset_platform_id}/contract
/{contract_address}
Query NFT data by collection contract address and asset platform
nfts.getMarkets()/nfts/marketsQuery all supported NFT collections with floor price, market cap, volume and market data
nfts.marketChart.get()/nfts/{id}/market_chartHistorical NFT market data (floor price, market cap, 24hr volume) by collection ID
nfts.contract.marketChart.get()/nfts/{asset_platform_id}/contract
/{contract_address}/market_chart
Historical NFT market data by contract address
nfts.tickers.get()/nfts/{id}/tickersLatest floor price and 24hr volume per NFT marketplace by collection ID
search.trending.get()/search/trendingQuery trending search coins, NFTs and categories in the last 24 hours
news.get()/newsQuery the latest crypto news and guides on CoinGecko
global.get()/globalQuery global crypto data (active cryptocurrencies, markets, total market cap, etc.)
global.decentralizedFinanceDefi.get()/global/decentralized_finance_defiQuery top 100 global DeFi data (market cap, trading volume)
global.marketCapChart.get()/global/market_cap_chartHistorical global market cap and volume data
coins.list.get()/coins/listQuery all supported coins with coin ID, name and symbol
assetPlatforms.get()/asset_platformsQuery all supported asset platforms (blockchain networks)
tokenLists.getAllJson()/token_lists/{asset_platform_id}/all.jsonFull list of tokens on a blockchain network supported by Ethereum token list standard
simple.supportedVsCurrencies.get()/simple/supported_vs_currenciesQuery all supported currencies on CoinGecko
search.get()/searchSearch for coins, categories and markets on CoinGecko
exchangeRates.get()/exchange_ratesQuery BTC exchange rates with other currencies
ping.get()/pingCheck API server status
key.get()/keyMonitor account API usage (rate limits, credits, etc.)
onchain.simple.networks.tokenPrice.getAddresses()/onchain/simple/networks/{network}
/token_price/{addresses}
Token price by token contract addresses on a network
onchain.networks.pools.getAddress()/onchain/networks/{network}/pools
/{address}
Query specific pool by network and pool address
onchain.networks.pools.multi.getAddresses()/onchain/networks/{network}/pools/multi
/{addresses}
Query multiple pools by network and pool addresses
onchain.networks.pools.info.get()/onchain/networks/{network}/pools
/{pool_address}/info
Pool metadata (token details, socials, etc.) by pool address
onchain.networks.pools.get()/onchain/networks/{network}/poolsTop pools by network
onchain.networks.dexes.getPools()/onchain/networks/{network}/dexes/{dex}
/pools
Top pools by network and DEX
onchain.networks.tokens.pools.get()/onchain/networks/{network}/tokens
/{token_address}/pools
Top pools by token contract address
onchain.search.pools.get()/onchain/search/poolsSearch pools by pool address, token name, symbol, or contract address
onchain.pools.megafilter.get()/onchain/pools/megafilterQuery pools by various filters across all networks
onchain.networks.newPools.get()/onchain/networks/new_poolsLatest pools across all networks
onchain.networks.newPools.getNetwork()/onchain/networks/{network}/new_poolsLatest pools by network
onchain.networks.trendingPools.get()/onchain/networks/trending_poolsTrending pools across all networks
onchain.networks.trendingPools.getNetwork()/onchain/networks/{network}
/trending_pools
Trending pools by network
onchain.pools.trendingSearch.get()/onchain/pools/trending_searchTrending search pools across all networks
onchain.networks.tokens.getAddress()/onchain/networks/{network}/tokens
/{address}
Token data by token contract address on a network
onchain.networks.tokens.multi.getAddresses()/onchain/networks/{network}/tokens/multi
/{addresses}
Multiple tokens data by token contract addresses on a network
onchain.networks.tokens.info.get()/onchain/networks/{network}/tokens
/{address}/info
Token metadata (name, symbol, CoinGecko ID, socials, etc.) by token contract address
onchain.tokens.infoRecentlyUpdated.get()/onchain/tokens/info_recently_updated100 most recently updated tokens info across all networks
onchain.networks.pools.ohlcv.getTimeframe()/onchain/networks/{network}/pools
/{pool_address}/ohlcv/{timeframe}
Pool OHLCV chart by pool address
onchain.networks.tokens.ohlcv.getTimeframe()/onchain/networks/{network}/tokens
/{token_address}/ohlcv/{timeframe}
Token OHLCV chart by token address
onchain.networks.pools.trades.get()/onchain/networks/{network}/pools
/{pool_address}/trades
Last 300 trades in past 24 hours by pool address
onchain.networks.tokens.trades.get()/onchain/networks/{network}/tokens
/{token_address}/trades
Last 300 trades in past 24 hours across all pools by token address
onchain.networks.tokens.topTraders.get()/onchain/networks/{network}/tokens
/{token_address}/top_traders
Top token traders by token contract address
onchain.networks.tokens.topHolders.get()/onchain/networks/{network}/tokens
/{address}/top_holders
Top token holders by token contract address
onchain.networks.tokens.holdersChart.get()/onchain/networks/{network}/tokens
/{token_address}/holders_chart
Historical token holders chart by token contract address
onchain.categories.get()/onchain/categoriesQuery all supported categories on GeckoTerminal
onchain.categories.getPools()/onchain/categories/{category_id}
/pools
Query pools by category ID
onchain.networks.get()/onchain/networksAll supported networks on GeckoTerminal
onchain.networks.dexes.get()/onchain/networks/{network}/dexesAll supported DEXs by network