Skip to main content

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​

  1. 1
    Connect to CoinGecko

    Add the CoinGecko server to your Civic environment through the server directory.

  2. 2
    No Authentication Required

    CoinGecko server uses public API endpoints that don't require authentication.

  3. 3
    Test Connection

    Start with get_coins_markets to see current market data or get_search to explore available coins.

What You Can Do​

Market Data & Prices

Real-time prices, market caps, volumes, and price changes across thousands of cryptocurrencies

DeFi & On-Chain Analytics

DEX trading data, liquidity pools, token analytics, and on-chain metrics

NFT Market Data

NFT collection prices, market charts, and trending digital assets

Historical Analysis

Historical price data, OHLCV charts, and time-series analysis

Use Cases​

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
  • 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
  • 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
  • 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 (43)​

Core Market Data (7 tools)

Essential tools for cryptocurrency prices, market caps, and basic market information.

Price and Market Data

get_coins_markets

Primary market data tool - Get prices, market caps, volumes, and market data

  • 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

Quick price lookups for specific coins in multiple currencies

  • Use Cases: Simple price checks, portfolio valuation, quick comparisons
get_coins_top_gainers_losers

Top 30 coins with largest price gains and losses by time duration

  • Timeframes: 1h, 24h, 7d, 14d, 30d, 60d, 1y
get_id_coins

Complete metadata and market data for specific coins by ID

  • Data: Full coin details, market data, social links, developer data
get_global

Global cryptocurrency market overview and statistics

  • Data: Total market cap, total volume, market dominance, DeFi stats
get_coins_history

Historical data for a specific coin on a particular date

  • Use Cases: Point-in-time analysis, historical comparisons
get_search

Search for coins, categories, markets, and trending searches

  • Scope: Coins, exchanges, categories, NFTs
note

Always use jq_filter parameter to reduce response size and improve performance.

Discovery & Listing Tools (4 tools)

Tools for discovering cryptocurrencies and understanding the CoinGecko ecosystem.

get_coins_list

Complete list of all supported coins with IDs, names, and symbols

  • Parameters: include_platform (contract addresses), status (active/inactive)
get_new_coins_list

Latest 200 coins recently listed on CoinGecko

  • Use Cases: Discovery of new projects, early-stage research
get_list_coins_categories

All coin categories available on CoinGecko

  • Categories: DeFi, NFT, Gaming, Layer 1, Layer 2, etc.
get_search_trending

Currently trending search terms and coins

  • Data: Top searches, trending coins, trending NFTs
Historical Data & Charts (4 tools)

Comprehensive historical price data and charting information.

get_range_coins_market_chart

Historical price, market cap, and volume data within date ranges

  • Parameters: coin ID, vs_currency, from/to timestamps
get_range_coins_ohlc

OHLC (Open, High, Low, Close) candle data for specific time ranges

  • Use Cases: Technical analysis, candlestick charting
get_range_contract_coins_market_chart

Historical data for tokens by contract address

  • Use Cases: Token-specific analysis, contract-based tracking
get_coins_contract

Token data by blockchain platform and contract address

  • Platforms: Ethereum, BSC, Polygon, Arbitrum, etc.
DeFi & On-Chain Analytics (25 tools)

Advanced DeFi protocol data, liquidity pools, and on-chain metrics.

Network and DEX Data

get_onchain_networks

All supported blockchain networks for on-chain data

get_networks_onchain_dexes

Decentralized exchanges on specific networks

get_onchain_categories

On-chain data categories and classifications

get_pools_onchain_categories

Liquidity pool categories across DeFi protocols

Pool Analysis Tools

get_networks_onchain_trending_pools

Trending liquidity pools on specific networks

get_networks_onchain_new_pools

Recently created liquidity pools

get_networks_onchain_pools

Comprehensive pool data including TVL, volume, APY

get_pools_networks_onchain_info

Detailed information about specific liquidity pools

get_pools_networks_onchain_trades

Recent trades and transactions for specific pools

Token Analytics

get_tokens_networks_onchain_info

Comprehensive token information including supply, holders

get_tokens_networks_onchain_top_holders

Top token holders and distribution analysis

get_tokens_networks_onchain_pools

Liquidity pools containing specific tokens

get_tokens_networks_onchain_trades

Recent trading activity for specific tokens

warning

DeFi tools require specific network and address parameters. Use discovery tools first to find valid IDs.

NFT Market Data (4 tools)

NFT collection data, market trends, and digital asset analytics.

get_list_nfts

List of supported NFT collections with basic information

  • Parameters: order (market_cap, volume, id), per_page, asset_platform_id
get_id_nfts

Detailed NFT collection data including floor price, market cap

  • Data: Collection stats, social links, description, market metrics
get_nfts_market_chart

Historical market chart data for NFT collections

  • Metrics: Floor price, market cap, volume over time
info

NFT data includes floor prices, market caps, and trading volumes for major collections.

Configuration Requirements​

Best Practices​

Performance Optimization​

  1. Use jq_filter: Always include jq_filter parameter to reduce response size and improve performance
  2. Pagination: Use page and per_page parameters for large datasets
  3. Specific Queries: Use coin IDs or symbols instead of fetching all coins when possible
  4. Cache Results: Cache frequently accessed data to reduce API calls
  1. 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
  2. Currency Selection: Use appropriate vs_currency for your target audience
  3. Precision Settings: Use precision parameter for price display accuracy

Market Analysis Workflows​

  1. Market Overview: Start with get_coins_markets for general market conditions
  2. Specific Analysis: Use get_id_coins for detailed single-coin research
  3. Historical Context: Add get_range_coins_market_chart for price history
  4. Trend Analysis: Use get_coins_top_gainers_losers for market movers
  5. Discovery: Use get_search_trending and get_new_coins_list for opportunities

DeFi Research Strategy​

  1. Network Discovery: Start with get_onchain_networks to understand available chains
  2. Pool Analysis: Use get_networks_onchain_trending_pools for popular protocols
  3. Token Research: Combine get_tokens_networks_onchain_info with holder analysis
  4. Cross-Reference: Compare on-chain data with market data tools
warning

CoinGecko API has rate limits. For high-frequency access or commercial use, consider CoinGecko's paid API plans.

tip

Pro Tip: Use get_search to find exact coin IDs before using other tools. Many tools require specific CoinGecko coin IDs rather than symbols.

Guardrails​

In addition to the 14 universal guardrails, this server has 11 server-specific guardrails across 7 operations.

note

All guardrails restrict crypto access to an approved allowlist — both at request and response level across all major endpoints. Ideal for controlling which assets a team can interact with.

GuardrailOperationTimingDescription
Restrict to Vetted Coin IDsget_id_coinsRequestAllowlist for coin ID queries
Restrict Simple Price to Vetted Coinsget_simple_priceRequestAllowlist for price queries
Restrict Coins History to Vetted Coinsget_coins_historyRequestAllowlist for historical data
Restrict Market Chart to Vetted Coinsget_range_coins_market_chartRequestAllowlist for market chart queries
Restrict OHLC to Vetted Coinsget_range_coins_ohlcRequestAllowlist for candlestick queries
Restrict Search to Vetted Coinsget_searchRequestAllowlist for search queries
Filter Search Results to Vetted Coinsget_searchResponseRedacts non-vetted coins from search results
Filter Market Data to Vetted Coinsget_coins_marketsResponseRedacts non-vetted coins from market data
Filter Trending to Vetted Coinsget_search_trendingResponseRedacts non-vetted coins from trending
Filter New Coins to Vetted Listget_new_coins_listResponseRedacts non-vetted coins from new listings
Filter Gainers/Losers to Vetted Coinsget_coins_top_gainers_losersResponseRedacts non-vetted coins from gainers/losers
tip

Configure guardrails via the Civic UI or ask the Configurator Agent: "Add guardrails to my CoinGecko server."