> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
> Use this file to discover all available pages before exploring further.
# CoinGecko MCP Tools
> Tools available through the CoinGecko MCP Server
The [CoinGecko MCP Server](/ai-integration/mcp-server) exposes two tools to your AI agent:
| Tool | Description |
| ------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `search_docs` | Looks up SDK documentation — methods, parameters, and request structure — before writing any code. |
| `execute` | Runs 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](/docs/sdk-typescript).
| Method | Endpoint | Description |
| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `simple.price.get()` | [/simple/price](/reference/simple-price) | Query prices of one or more coins by Coin API IDs, symbols, or names |
| `simple.tokenPrice.getID()` | [/simple/token\_price/\{id}](/reference/simple-token-price) | Query one or more token prices by token contract addresses |
| `coins.markets.get()` | [/coins/markets](/reference/coins-markets) | Query all supported coins with price, market cap, volume and market data |
| `coins.getID()` | [/coins/\{id}](/reference/coins-id) | Query all metadata and market data of a coin by coin ID |
| `coins.contract.get()` | [/coins/\{id}/contract/\{contract\_address}](/reference/coins-contract-address) | Query all metadata and market data of a coin by asset platform and token contract address |
| `coins.tickers.get()` | [/coins/\{id}/tickers](/reference/coins-id-tickers) | Query coin tickers on both CEX and DEX by coin ID |
| `coins.history.get()` | [/coins/\{id}/history](/reference/coins-id-history) | Query historical data (price, market cap, 24hr volume, etc.) at a given date by coin ID |
| `coins.list.getNew()` | [/coins/list/new](/reference/coins-list-new) | Query the latest 200 coins recently listed on CoinGecko |
| `coins.topGainersLosers.get()` | [/coins/top\_gainers\_losers](/reference/coins-top-gainers-losers) | Query top 30 coins with largest price gain and loss by time duration |
| `coins.marketChart.get()` | [/coins/\{id}/market\_chart](/reference/coins-id-market-chart) | Historical chart data (price, market cap, 24hr volume) by coin ID |
| `coins.marketChart.getRange()` | [/coins/\{id}/market\_chart/range](/reference/coins-id-market-chart-range) | Historical chart data within a time range by coin ID |
| `coins.contract.marketChart.get()` | [/coins/\{id}/contract
/\{contract\_address}/market\_chart](/reference/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](/reference/contract-address-market-chart-range) | Historical chart data within a time range by asset platform and token contract address |
| `coins.ohlc.get()` | [/coins/\{id}/ohlc](/reference/coins-id-ohlc) | OHLC chart by coin ID |
| `coins.ohlc.getRange()` | [/coins/\{id}/ohlc/range](/reference/coins-id-ohlc-range) | OHLC chart within a time range by coin ID |
| `coins.circulatingSupplyChart.get()` | [/coins/\{id}/circulating\_supply\_chart](/reference/coins-id-circulating-supply-chart) | Historical circulating supply by coin ID |
| `coins.circulatingSupplyChart.getRange()` | [/coins/\{id}
/circulating\_supply\_chart/range](/reference/coins-id-circulating-supply-chart-range) | Historical circulating supply within a time range by coin ID |
| `coins.totalSupplyChart.get()` | [/coins/\{id}/total\_supply\_chart](/reference/coins-id-total-supply-chart) | Historical total supply by coin ID |
| `coins.totalSupplyChart.getRange()` | [/coins/\{id}/total\_supply\_chart/range](/reference/coins-id-total-supply-chart-range) | Historical total supply within a time range by coin ID |
| `coins.categories.getList()` | [/coins/categories/list](/reference/coins-categories-list) | Query all supported coin categories on CoinGecko |
| `coins.categories.get()` | [/coins/categories](/reference/coins-categories) | Query all coin categories with market data (market cap, volume, etc.) |
| `exchanges.getList()` | [/exchanges/list](/reference/exchanges-list) | Query all supported exchanges with ID and name |
| `exchanges.get()` | [/exchanges](/reference/exchanges) | Query all supported exchanges with data (ID, name, country, etc.) |
| `exchanges.getID()` | [/exchanges/\{id}](/reference/exchanges-id) | Query exchange data and top 100 tickers by exchange ID |
| `exchanges.tickers.get()` | [/exchanges/\{id}/tickers](/reference/exchanges-id-tickers) | Query exchange tickers by exchange ID |
| `exchanges.volumeChart.get()` | [/exchanges/\{id}/volume\_chart](/reference/exchanges-id-volume-chart) | Historical volume chart data in BTC by exchange ID |
| `exchanges.volumeChart.getRange()` | [/exchanges/\{id}/volume\_chart/range](/reference/exchanges-id-volume-chart-range) | Historical volume chart data in BTC within a date range by exchange ID |
| `derivatives.exchanges.getList()` | [/derivatives/exchanges/list](/reference/derivatives-exchanges-list) | Query all supported derivatives exchanges with ID and name |
| `derivatives.get()` | [/derivatives](/reference/derivatives-tickers) | Query all tickers from derivatives exchanges |
| `derivatives.exchanges.get()` | [/derivatives/exchanges](/reference/derivatives-exchanges) | Query all derivatives exchanges with data (ID, name, open interest, etc.) |
| `derivatives.exchanges.getID()` | [/derivatives/exchanges/\{id}](/reference/derivatives-exchanges-id) | Query derivatives exchange data by exchange ID |
| `entities.getList()` | [/entities/list](/reference/entities-list) | Query all supported entities with entity ID, name, symbol, and country |
| `publicTreasury.getCoinID()` | [/\{entity}/public\_treasury/\{coin\_id}](/reference/companies-public-treasury) | Query public companies' and governments' crypto holdings by coin ID |
| `publicTreasury.getEntityID()` | [/public\_treasury/\{entity\_id}](/reference/public-treasury-entity) | Query public companies' and governments' crypto holdings by entity ID |
| `publicTreasury.getHoldingChart()` | [/public\_treasury/\{entity\_id}/\{coin\_id}
/holding\_chart](/reference/public-treasury-entity-chart) | Historical crypto holdings chart by entity ID and coin ID |
| `publicTreasury.getTransactionHistory()` | [/public\_treasury/\{entity\_id}
/transaction\_history](/reference/public-treasury-transaction-history) | Crypto transaction history by entity ID |
| `nfts.getList()` | [/nfts/list](/reference/nfts-list) | Query all supported NFTs with ID, contract address, name, asset platform ID and symbol |
| `nfts.getID()` | [/nfts/\{id}](/reference/nfts-id) | Query NFT data (name, floor price, 24hr volume, etc.) by collection ID |
| `nfts.contract.getContractAddress()` | [/nfts/\{asset\_platform\_id}/contract
/\{contract\_address}](/reference/nfts-contract-address) | Query NFT data by collection contract address and asset platform |
| `nfts.getMarkets()` | [/nfts/markets](/reference/nfts-markets) | Query all supported NFT collections with floor price, market cap, volume and market data |
| `nfts.marketChart.get()` | [/nfts/\{id}/market\_chart](/reference/nfts-id-market-chart) | Historical 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](/reference/nfts-contract-address-market-chart) | Historical NFT market data by contract address |
| `nfts.tickers.get()` | [/nfts/\{id}/tickers](/reference/nfts-id-tickers) | Latest floor price and 24hr volume per NFT marketplace by collection ID |
| `search.trending.get()` | [/search/trending](/reference/trending-search) | Query trending search coins, NFTs and categories in the last 24 hours |
| `news.get()` | [/news](/reference/news) | Query the latest crypto news and guides on CoinGecko |
| `global.get()` | [/global](/reference/crypto-global) | Query global crypto data (active cryptocurrencies, markets, total market cap, etc.) |
| `global.decentralizedFinanceDefi.get()` | [/global/decentralized\_finance\_defi](/reference/global-defi) | Query top 100 global DeFi data (market cap, trading volume) |
| `global.marketCapChart.get()` | [/global/market\_cap\_chart](/reference/global-market-cap-chart) | Historical global market cap and volume data |
| `coins.list.get()` | [/coins/list](/reference/coins-list) | Query all supported coins with coin ID, name and symbol |
| `assetPlatforms.get()` | [/asset\_platforms](/reference/asset-platforms-list) | Query all supported asset platforms (blockchain networks) |
| `tokenLists.getAllJson()` | [/token\_lists/\{asset\_platform\_id}/all.json](/reference/token-lists) | Full list of tokens on a blockchain network supported by Ethereum token list standard |
| `simple.supportedVsCurrencies.get()` | [/simple/supported\_vs\_currencies](/reference/simple-supported-currencies) | Query all supported currencies on CoinGecko |
| `search.get()` | [/search](/reference/search-data) | Search for coins, categories and markets on CoinGecko |
| `exchangeRates.get()` | [/exchange\_rates](/reference/exchange-rates) | Query BTC exchange rates with other currencies |
| `ping.get()` | [/ping](/reference/ping-server) | Check API server status |
| `key.get()` | [/key](/reference/api-usage) | Monitor account API usage (rate limits, credits, etc.) |
| `onchain.simple.networks.tokenPrice.getAddresses()` | [/onchain/simple/networks/\{network}
/token\_price/\{addresses}](/reference/onchain-simple-price) | Token price by token contract addresses on a network |
| `onchain.networks.pools.getAddress()` | [/onchain/networks/\{network}/pools
/\{address}](/reference/pool-address) | Query specific pool by network and pool address |
| `onchain.networks.pools.multi.getAddresses()` | [/onchain/networks/\{network}/pools/multi
/\{addresses}](/reference/pools-addresses) | Query multiple pools by network and pool addresses |
| `onchain.networks.pools.info.get()` | [/onchain/networks/\{network}/pools
/\{pool\_address}/info](/reference/pool-token-info-contract-address) | Pool metadata (token details, socials, etc.) by pool address |
| `onchain.networks.pools.get()` | [/onchain/networks/\{network}/pools](/reference/top-pools-network) | Top pools by network |
| `onchain.networks.dexes.getPools()` | [/onchain/networks/\{network}/dexes/\{dex}
/pools](/reference/top-pools-dex) | Top pools by network and DEX |
| `onchain.networks.tokens.pools.get()` | [/onchain/networks/\{network}/tokens
/\{token\_address}/pools](/reference/top-pools-contract-address) | Top pools by token contract address |
| `onchain.search.pools.get()` | [/onchain/search/pools](/reference/search-pools) | Search pools by pool address, token name, symbol, or contract address |
| `onchain.pools.megafilter.get()` | [/onchain/pools/megafilter](/reference/pools-megafilter) | Query pools by various filters across all networks |
| `onchain.networks.newPools.get()` | [/onchain/networks/new\_pools](/reference/latest-pools-list) | Latest pools across all networks |
| `onchain.networks.newPools.getNetwork()` | [/onchain/networks/\{network}/new\_pools](/reference/latest-pools-network) | Latest pools by network |
| `onchain.networks.trendingPools.get()` | [/onchain/networks/trending\_pools](/reference/trending-pools-list) | Trending pools across all networks |
| `onchain.networks.trendingPools.getNetwork()` | [/onchain/networks/\{network}
/trending\_pools](/reference/trending-pools-network) | Trending pools by network |
| `onchain.pools.trendingSearch.get()` | [/onchain/pools/trending\_search](/reference/trending-search-pools) | Trending search pools across all networks |
| `onchain.networks.tokens.getAddress()` | [/onchain/networks/\{network}/tokens
/\{address}](/reference/token-data-contract-address) | Token data by token contract address on a network |
| `onchain.networks.tokens.multi.getAddresses()` | [/onchain/networks/\{network}/tokens/multi
/\{addresses}](/reference/tokens-data-contract-addresses) | Multiple tokens data by token contract addresses on a network |
| `onchain.networks.tokens.info.get()` | [/onchain/networks/\{network}/tokens
/\{address}/info](/reference/token-info-contract-address) | Token metadata (name, symbol, CoinGecko ID, socials, etc.) by token contract address |
| `onchain.tokens.infoRecentlyUpdated.get()` | [/onchain/tokens/info\_recently\_updated](/reference/tokens-info-recent-updated) | 100 most recently updated tokens info across all networks |
| `onchain.networks.pools.ohlcv.getTimeframe()` | [/onchain/networks/\{network}/pools
/\{pool\_address}/ohlcv/\{timeframe}](/reference/pool-ohlcv-contract-address) | Pool OHLCV chart by pool address |
| `onchain.networks.tokens.ohlcv.getTimeframe()` | [/onchain/networks/\{network}/tokens
/\{token\_address}/ohlcv/\{timeframe}](/reference/token-ohlcv-token-address) | Token OHLCV chart by token address |
| `onchain.networks.pools.trades.get()` | [/onchain/networks/\{network}/pools
/\{pool\_address}/trades](/reference/pool-trades-contract-address) | Last 300 trades in past 24 hours by pool address |
| `onchain.networks.tokens.trades.get()` | [/onchain/networks/\{network}/tokens
/\{token\_address}/trades](/reference/token-trades-contract-address) | 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](/reference/top-token-traders-token-address) | Top token traders by token contract address |
| `onchain.networks.tokens.topHolders.get()` | [/onchain/networks/\{network}/tokens
/\{address}/top\_holders](/reference/top-token-holders-token-address) | Top token holders by token contract address |
| `onchain.networks.tokens.holdersChart.get()` | [/onchain/networks/\{network}/tokens
/\{token\_address}/holders\_chart](/reference/token-holders-chart-token-address) | Historical token holders chart by token contract address |
| `onchain.categories.get()` | [/onchain/categories](/reference/categories-list) | Query all supported categories on GeckoTerminal |
| `onchain.categories.getPools()` | [/onchain/categories/\{category\_id}
/pools](/reference/pools-category) | Query pools by category ID |
| `onchain.networks.get()` | [/onchain/networks](/reference/networks-list) | All supported networks on GeckoTerminal |
| `onchain.networks.dexes.get()` | [/onchain/networks/\{network}/dexes](/reference/dexes-list) | All supported DEXs by network |