# CoinGecko MCP > CoinGecko provides real-time access to global cryptocurrency prices, market cap data, and deep on-chain analytics. It lets your AI client check current coin values across multiple fiat currencies, track historical price movements over time, list supported exchanges, and inspect specific token contract details directly from the blockchain. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** cryptocurrency, bitcoin, ethereum, market-data, defi, trading ## Description This MCP turns your agent into a financial analyst that runs off natural conversation. You stop manually navigating dozens of separate crypto data websites. Instead, you ask for market insights—like 'What's the 24-hour volume change for Ethereum?'—and get an instant answer based on thousands of tokens and global statistics. It handles everything from checking basic coin prices to analyzing complex DeFi yields or tracking NFT collections. If your current AI workflow needs a reliable source of crypto data, connecting it through Vinkius gives you access to this entire catalog of tools without needing multiple API keys or integrations. ## Tools ### list_asset_platforms Lists all supported platforms where digital assets can be traded or tracked. ### get_coin_history Retrieves historical price data for a given coin at a specific date. ### get_coin_market_chart_range Retrieves detailed historical market data within user-specified time boundaries. ### get_coin_market_chart Fetches general historical market data for a selected cryptocurrency. ### get_coin_ohlc Gathers Open, High, Low, and Close (OHLC) candlestick data for a coin. ### get_coin_tickers Fetches a list of trading pairs and tickers associated with a specific coin across exchanges. ### get_coin Gets current data for a specified coin, including its exchange tickers. ### list_coins Retrieves a comprehensive list of every coin ID, name, and symbol that the system supports. ### list_coins_markets Lists detailed market data for all supported coins, including market cap, volume, and related metrics. ### get_exchange_tickers Fetches a list of trading pair symbols available at an exchange. ### get_exchange Retrieves volume metrics and tickers for an entire exchange. ### get_exchange_volume_chart Generates volume chart data specific to a selected exchange over time. ### list_exchanges_markets Lists all supported markets and their IDs across various exchanges. ### list_exchanges Retrieves a list of all major cryptocurrency exchanges tracked by the platform. ### get_global_defi Pulls global data specifically related to the top 100 cryptocurrencies in decentralized finance (DeFi). ### get_global Retrieves macro-level cryptocurrency global market statistics and overall trends. ### get_nft_by_contract Retrieves specific data points about NFTs based on their contract address. ### get_nft Gathers current market and metadata information for an entire NFT collection. ### list_nfts Retrieves a list of every recognized NFT collection available for data analysis. ### list_onchain_dexes Lists all supported decentralized exchanges (DEXs) operating on a specific network. ### list_onchain_networks Provides a list of every supported blockchain network monitored by the system. ### get_onchain_pool Gets liquidity pool details and metrics by providing a specific blockchain address. ### get_onchain_pool_trades Retrieves the latest transaction records from a specified liquidity pool. ### get_onchain_token Fetches technical token data by providing its contract address on a network. ### get_public_treasury Gets the public holdings of major companies for a given cryptocurrency, like Bitcoin or Ethereum. ### get_simple_price Provides the current market price for cryptocurrencies across various fiat and crypto pairings. ### get_simple_token_price Gets the current trading price of a specific token on a given platform or network. ### get_supported_vs_currencies Lists all fiat and crypto currencies supported for pricing comparisons within the system. ### get_trending Identifies cryptocurrencies that are currently gaining interest or momentum in the market. ## Prompt Examples **Prompt:** ``` What is the current price of Bitcoin and Solana in USD? ``` **Response:** ``` I've checked the latest data: Bitcoin is currently trading at $64,230.12 and Solana is at $145.67 USD. Both have seen a slight increase in the last 24 hours. ``` **Prompt:** ``` Show me the top 5 coins by market cap in the 'decentralized-finance-defi' category. ``` **Response:** ``` Fetching DeFi market leaders... The top 5 are: 1. Lido Staked Ether (STETH), 2. Dai (DAI), 3. Uniswap (UNI), 4. Chainlink (LINK), and 5. Wrapped BTC (WBTC). ``` **Prompt:** ``` Get the global cryptocurrency market statistics. ``` **Response:** ``` The total crypto market cap is approximately $2.45 trillion, with a 24h volume of $85 billion. Bitcoin dominance stands at 52.1% and Ethereum at 16.8%. ``` ## Capabilities ### Check real-time asset prices You get the current trading price for any cryptocurrency against specified fiat and crypto pairs. ### Analyze market trends over time The system retrieves historical data, allowing you to chart performance or calculate changes across specific dates or ranges. ### Identify global market structure You can pull overall market metrics, such as total market capitalization and the top DeFi performers worldwide. ### Investigate blockchain specifics The MCP fetches deep data on token contracts, listing active networks or checking liquidity pools by address. ### Compare exchange activity You pull volume and ticker information for specific exchanges to see where trading is happening. ## Use Cases ### Assessing DeFi Yield Risks A user needs to know if a new liquidity pool is safe. They ask their agent to run get_onchain_pool on the target address, then follow up with get_onchain_pool_trades to verify recent activity and spot any suspicious volume spikes. ### Building a Market Report A financial analyst needs quarterly data. They combine list_coins_markets for the list of assets, use get_global_defi to focus on high-yield sectors, and finish by pulling public treasury data using get_public_treasury to assess corporate backing. ### Tracking NFT Market Shifts A collector wants to verify the value of a specific asset. They start with list_nfts to find the collection, then use get_nft_by_contract and get_nft for current floor prices and recent sales data. ### Quick Price Comparison A trader wants to check if Bitcoin's price is stable. They simply run get_simple_price, specifying the fiat currency (like USD) and getting an immediate comparison against other key assets using get_coin. ## Benefits - Deep Dive Analytics: Don't just see the current price. Use get_coin_market_chart_range to pull historical market data, letting your agent analyze performance trends over custom time spans. - On-Chain Verification: Go past surface metrics. Tools like get_onchain_token and get_onchain_pool let you inspect specific contracts and liquidity pool activity directly on the blockchain ledger. - Global Market Overview: Need a macro view? The get_global tool pulls total market cap, dominance percentages, and overall volume data so you can assess institutional health quickly. - Comprehensive Asset Listing: Use list_coins to see every supported coin ID before querying specific pricing with get_coin or list_coins_markets. It's the full directory of crypto assets. - Exchange Comparison: You can pull ticker information using get_coin_tickers and compare volume across different exchanges by running get_exchange_volume_chart. ## How It Works The bottom line is: your AI talks to this MCP, which talks to the crypto market data, and you get the synthesized result. 1. First, subscribe to this MCP and enter your CoinGecko API Key (Demo or Pro). 2. Next, tell your AI client exactly what you need—for example, 'What was the price of Bitcoin last month?' 3. The agent executes the right tool, pulls the data, and presents it back in a conversational answer. ## Frequently Asked Questions **How do I use the get_simple_price tool?** You provide the base coin and the fiat currency you want to compare it against. For example, asking for Bitcoin's price in USD gets you an immediate current value. **Can I track NFT liquidity using get_nft_by_contract?** Yes, that tool allows you to pull specific data about an entire NFT collection based on its contract address. This is useful for checking market depth and recent sales. **What’s the difference between list_coins_markets and get_global?** list_coins_markets gives you a comprehensive data sheet for *every* supported coin, detailing its specific market cap and volume. get_global provides macro stats about the entire crypto ecosystem. **How do I check historical exchange volume?** You use get_exchange_volume_chart by specifying the desired exchange. This gives you a dedicated chart tracking volume trends over time for that single platform. **What happens if my calls using `list_coins` exceed a rate limit?** If you hit a rate limit, your agent should implement an exponential backoff strategy. The API handles standard throttling, but high-volume data collection requires batching requests to avoid errors. **Can I use `get_coin_market_chart_range` to compare multiple different time periods?** No, the tool accepts only one start and end timestamp per request. To compare multiple ranges, you must execute separate calls for each distinct historical timeframe. **When using `get_onchain_token`, how do I confirm which network a contract address belongs to?** You should first run `list_onchain_networks` to get the supported chain identifiers. You must provide the correct chain ID alongside the contract address for accurate data retrieval. **Is the current price data from `get_coin` always up-to-the-second, or is there a delay?** The tool delivers real-time pricing aggregated across major exchanges. While extremely fast, minor latency can occur during peak market volatility. **How can I check the current price of multiple cryptocurrencies at once?** You can use the `get_simple_price` tool. Just provide a comma-separated list of IDs (e.g., 'bitcoin,ethereum,solana') and the target currency (e.g., 'usd') to get instant valuations. **Can the AI identify which coins are currently trending in the market?** Yes! By using the `get_trending` tool, your agent will retrieve the top-7 trending coins on CoinGecko as searched by users in the last 24 hours. **Is it possible to get detailed information about a specific token's contract on a network?** Absolutely. Use the `get_onchain_token` tool with the network ID and contract address to fetch precise on-chain data, including pool information and token metadata.