CoinGecko Server
Overview
The CoinGecko server provides the world’s most comprehensive cryptocurrency data platform. Built by CoinGecko, this server enables AI assistants to access real-time prices, market data, DeFi protocols, NFT information, and on-chain analytics across 400+ exchanges and thousands of cryptocurrencies.Getting Started
Connect to CoinGecko
No Authentication Required
Test Connection
get_coins_markets
to see current market data or get_search
to explore available coins.What You Can Do
Market Data & Prices
DeFi & On-Chain Analytics
NFT Market Data
Historical Analysis
Use Cases
Trading & Investment Analysis
Trading & Investment Analysis
- Price Monitoring: Track real-time prices and market movements
- Market Analysis: Analyze market caps, volumes, and price trends
- Portfolio Tracking: Monitor investments across different cryptocurrencies
- Top Gainers/Losers: Identify opportunities and market movers
- Historical Analysis: Study price patterns and historical performance
DeFi Research & Analytics
DeFi Research & Analytics
- DEX Analysis: Track decentralized exchange trading volumes and liquidity
- Token Research: Analyze token metrics, holder data, and on-chain activity
- Liquidity Pools: Monitor pool performance and yield opportunities
- Trending Pools: Discover popular and emerging DeFi protocols
- Cross-Chain Analysis: Compare metrics across different blockchain networks
Market Research & Discovery
Market Research & Discovery
- Coin Discovery: Find new and trending cryptocurrencies
- Category Analysis: Explore different crypto sectors (DeFi, NFT, Gaming, etc.)
- Platform Research: Understand different blockchain platforms and their ecosystems
- Market Trends: Identify trending coins and market sentiment
- Competitive Analysis: Compare similar projects and their performance
Data Integration & Reporting
Data Integration & Reporting
- Market Reports: Generate comprehensive market analysis reports
- Price Alerts: Monitor price thresholds and market conditions
- Research Documentation: Gather data for investment or research purposes
- API Integration: Feed crypto data into applications and dashboards
- Educational Content: Create educational materials with current market data
Available Tools (44)
Core Market Data (7 tools)
Core Market Data (7 tools)
get_coins_markets
get_coins_markets
- Parameters: vs_currency (required), category, ids, symbols, order, pagination
- Data: Current price, market cap, volume, 24h changes, ATH/ATL, market cap rank
get_simple_price
get_simple_price
- Use Cases: Simple price checks, portfolio valuation, quick comparisons
get_coins_top_gainers_losers
get_coins_top_gainers_losers
- Timeframes: 1h, 24h, 7d, 14d, 30d, 60d, 1y
get_id_coins
get_id_coins
- Data: Full coin details, market data, social links, developer data
get_global
get_global
- Data: Total market cap, total volume, market dominance, DeFi stats
get_coins_history
get_coins_history
- Use Cases: Point-in-time analysis, historical comparisons
get_search
get_search
- Scope: Coins, exchanges, categories, NFTs
jq_filter
parameter to reduce response size and improve performance.Discovery & Listing Tools (4 tools)
Discovery & Listing Tools (4 tools)
get_coins_list
get_coins_list
- Parameters: include_platform (contract addresses), status (active/inactive)
get_new_coins_list
get_new_coins_list
- Use Cases: Discovery of new projects, early-stage research
get_list_coins_categories
get_list_coins_categories
- Categories: DeFi, NFT, Gaming, Layer 1, Layer 2, etc.
get_search_trending
get_search_trending
- Data: Top searches, trending coins, trending NFTs
Historical Data & Charts (4 tools)
Historical Data & Charts (4 tools)
get_range_coins_market_chart
get_range_coins_market_chart
- Parameters: coin ID, vs_currency, from/to timestamps
get_range_coins_ohlc
get_range_coins_ohlc
- Use Cases: Technical analysis, candlestick charting
get_range_contract_coins_market_chart
get_range_contract_coins_market_chart
- Use Cases: Token-specific analysis, contract-based tracking
get_coins_contract
get_coins_contract
- Platforms: Ethereum, BSC, Polygon, Arbitrum, etc.
DeFi & On-Chain Analytics (25 tools)
DeFi & On-Chain Analytics (25 tools)
get_onchain_networks
get_onchain_networks
get_networks_onchain_dexes
get_networks_onchain_dexes
get_onchain_categories
get_onchain_categories
get_pools_onchain_categories
get_pools_onchain_categories
get_networks_onchain_trending_pools
get_networks_onchain_trending_pools
get_networks_onchain_new_pools
get_networks_onchain_new_pools
get_networks_onchain_pools
get_networks_onchain_pools
get_pools_networks_onchain_info
get_pools_networks_onchain_info
get_pools_networks_onchain_trades
get_pools_networks_onchain_trades
get_tokens_networks_onchain_info
get_tokens_networks_onchain_info
get_tokens_networks_onchain_top_holders
get_tokens_networks_onchain_top_holders
get_tokens_networks_onchain_pools
get_tokens_networks_onchain_pools
get_tokens_networks_onchain_trades
get_tokens_networks_onchain_trades
NFT Market Data (4 tools)
NFT Market Data (4 tools)
get_list_nfts
get_list_nfts
- Parameters: order (market_cap, volume, id), per_page, asset_platform_id
get_id_nfts
get_id_nfts
- Data: Collection stats, social links, description, market metrics
get_nfts_market_chart
get_nfts_market_chart
- Metrics: Floor price, market cap, volume over time
Configuration Requirements
Server Configuration
- Transport: Server-Sent Events (SSE) -
sse
transport type - Endpoint:
https://mcp.api.coingecko.com/sse
(remote server) - Authentication: None required - uses public API endpoints
- Rate Limits: Standard rate limits apply based on CoinGecko’s public API tiers
Best Practices
Performance Optimization
- Use jq_filter: Always include
jq_filter
parameter to reduce response size and improve performance - Pagination: Use
page
andper_page
parameters for large datasets - Specific Queries: Use coin IDs or symbols instead of fetching all coins when possible
- Cache Results: Cache frequently accessed data to reduce API calls
Data Filtering and Search
- JQ Filters: Learn basic jq syntax for efficient data extraction
.[] | {name, symbol, current_price}
- Extract specific fields.[:10]
- Limit to first 10 results.[] | select(.market_cap_rank <= 100)
- Filter by criteria
- Currency Selection: Use appropriate
vs_currency
for your target audience - Precision Settings: Use
precision
parameter for price display accuracy
Market Analysis Workflows
- Market Overview: Start with
get_coins_markets
for general market conditions - Specific Analysis: Use
get_id_coins
for detailed single-coin research - Historical Context: Add
get_range_coins_market_chart
for price history - Trend Analysis: Use
get_coins_top_gainers_losers
for market movers - Discovery: Use
get_search_trending
andget_new_coins_list
for opportunities
DeFi Research Strategy
- Network Discovery: Start with
get_onchain_networks
to understand available chains - Pool Analysis: Use
get_networks_onchain_trending_pools
for popular protocols - Token Research: Combine
get_tokens_networks_onchain_info
with holder analysis - Cross-Reference: Compare on-chain data with market data tools
get_search
to find exact coin IDs before using other tools. Many tools require specific CoinGecko coin IDs rather than symbols.