> ## Documentation Index
> Fetch the complete documentation index at: https://docs.civic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CoinGecko Server

> Access comprehensive cryptocurrency data including prices, market caps, volumes, and trending coins through CoinGecko's MCP interface

# CoinGecko Server

## Overview

The CoinGecko server provides the world's most comprehensive cryptocurrency data platform. Built by [CoinGecko](https://www.coingecko.com), 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

<Steps>
  <Step title="Connect to CoinGecko">
    Add the CoinGecko server to your Civic environment through the server directory.
  </Step>

  <Step title="No Authentication Required">
    CoinGecko server uses public API endpoints that don't require authentication.
  </Step>

  <Step title="Test Connection">
    Start with `get_coins_markets` to see current market data or `get_search` to explore available coins.
  </Step>
</Steps>

## What You Can Do

<CardGroup cols={2}>
  <Card title="Market Data & Prices" icon="chart-line">
    Real-time prices, market caps, volumes, and price changes across thousands of cryptocurrencies
  </Card>

  <Card title="DeFi & On-Chain Analytics" icon="link">
    DEX trading data, liquidity pools, token analytics, and on-chain metrics
  </Card>

  <Card title="NFT Market Data" icon="image">
    NFT collection prices, market charts, and trending digital assets
  </Card>

  <Card title="Historical Analysis" icon="clock">
    Historical price data, OHLCV charts, and time-series analysis
  </Card>
</CardGroup>

## Use Cases

<AccordionGroup>
  <Accordion title="Trading & Investment Analysis" icon="chart-candlestick">
    * **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
  </Accordion>

  <Accordion title="DeFi Research & Analytics" icon="database">
    * **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
  </Accordion>

  <Accordion title="Market Research & Discovery" icon="magnifying-glass">
    * **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
  </Accordion>

  <Accordion title="Data Integration & Reporting" icon="file-chart-column">
    * **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
  </Accordion>
</AccordionGroup>

***

## Available Tools (43)

<AccordionGroup>
  <Accordion title="Core Market Data (7 tools)">
    Essential tools for cryptocurrency prices, market caps, and basic market information.

    **Price and Market Data**

    <AccordionGroup>
      <Accordion title="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
      </Accordion>

      <Accordion title="get_simple_price">
        Quick price lookups for specific coins in multiple currencies

        * **Use Cases**: Simple price checks, portfolio valuation, quick comparisons
      </Accordion>

      <Accordion title="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
      </Accordion>

      <Accordion title="get_id_coins">
        Complete metadata and market data for specific coins by ID

        * **Data**: Full coin details, market data, social links, developer data
      </Accordion>

      <Accordion title="get_global">
        Global cryptocurrency market overview and statistics

        * **Data**: Total market cap, total volume, market dominance, DeFi stats
      </Accordion>

      <Accordion title="get_coins_history">
        Historical data for a specific coin on a particular date

        * **Use Cases**: Point-in-time analysis, historical comparisons
      </Accordion>

      <Accordion title="get_search">
        Search for coins, categories, markets, and trending searches

        * **Scope**: Coins, exchanges, categories, NFTs
      </Accordion>
    </AccordionGroup>

    <Note>
      Always use `jq_filter` parameter to reduce response size and improve performance.
    </Note>
  </Accordion>

  <Accordion title="Discovery & Listing Tools (4 tools)">
    Tools for discovering cryptocurrencies and understanding the CoinGecko ecosystem.

    <AccordionGroup>
      <Accordion title="get_coins_list">
        Complete list of all supported coins with IDs, names, and symbols

        * **Parameters**: include\_platform (contract addresses), status (active/inactive)
      </Accordion>

      <Accordion title="get_new_coins_list">
        Latest 200 coins recently listed on CoinGecko

        * **Use Cases**: Discovery of new projects, early-stage research
      </Accordion>

      <Accordion title="get_list_coins_categories">
        All coin categories available on CoinGecko

        * **Categories**: DeFi, NFT, Gaming, Layer 1, Layer 2, etc.
      </Accordion>

      <Accordion title="get_search_trending">
        Currently trending search terms and coins

        * **Data**: Top searches, trending coins, trending NFTs
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="Historical Data & Charts (4 tools)">
    Comprehensive historical price data and charting information.

    <AccordionGroup>
      <Accordion title="get_range_coins_market_chart">
        Historical price, market cap, and volume data within date ranges

        * **Parameters**: coin ID, vs\_currency, from/to timestamps
      </Accordion>

      <Accordion title="get_range_coins_ohlc">
        OHLC (Open, High, Low, Close) candle data for specific time ranges

        * **Use Cases**: Technical analysis, candlestick charting
      </Accordion>

      <Accordion title="get_range_contract_coins_market_chart">
        Historical data for tokens by contract address

        * **Use Cases**: Token-specific analysis, contract-based tracking
      </Accordion>

      <Accordion title="get_coins_contract">
        Token data by blockchain platform and contract address

        * **Platforms**: Ethereum, BSC, Polygon, Arbitrum, etc.
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="DeFi & On-Chain Analytics (25 tools)">
    Advanced DeFi protocol data, liquidity pools, and on-chain metrics.

    **Network and DEX Data**

    <AccordionGroup>
      <Accordion title="get_onchain_networks">
        All supported blockchain networks for on-chain data
      </Accordion>

      <Accordion title="get_networks_onchain_dexes">
        Decentralized exchanges on specific networks
      </Accordion>

      <Accordion title="get_onchain_categories">
        On-chain data categories and classifications
      </Accordion>

      <Accordion title="get_pools_onchain_categories">
        Liquidity pool categories across DeFi protocols
      </Accordion>
    </AccordionGroup>

    **Pool Analysis Tools**

    <AccordionGroup>
      <Accordion title="get_networks_onchain_trending_pools">
        Trending liquidity pools on specific networks
      </Accordion>

      <Accordion title="get_networks_onchain_new_pools">
        Recently created liquidity pools
      </Accordion>

      <Accordion title="get_networks_onchain_pools">
        Comprehensive pool data including TVL, volume, APY
      </Accordion>

      <Accordion title="get_pools_networks_onchain_info">
        Detailed information about specific liquidity pools
      </Accordion>

      <Accordion title="get_pools_networks_onchain_trades">
        Recent trades and transactions for specific pools
      </Accordion>
    </AccordionGroup>

    **Token Analytics**

    <AccordionGroup>
      <Accordion title="get_tokens_networks_onchain_info">
        Comprehensive token information including supply, holders
      </Accordion>

      <Accordion title="get_tokens_networks_onchain_top_holders">
        Top token holders and distribution analysis
      </Accordion>

      <Accordion title="get_tokens_networks_onchain_pools">
        Liquidity pools containing specific tokens
      </Accordion>

      <Accordion title="get_tokens_networks_onchain_trades">
        Recent trading activity for specific tokens
      </Accordion>
    </AccordionGroup>

    <Warning>
      DeFi tools require specific network and address parameters. Use discovery tools first to find valid IDs.
    </Warning>
  </Accordion>

  <Accordion title="NFT Market Data (4 tools)">
    NFT collection data, market trends, and digital asset analytics.

    <AccordionGroup>
      <Accordion title="get_list_nfts">
        List of supported NFT collections with basic information

        * **Parameters**: order (market\_cap, volume, id), per\_page, asset\_platform\_id
      </Accordion>

      <Accordion title="get_id_nfts">
        Detailed NFT collection data including floor price, market cap

        * **Data**: Collection stats, social links, description, market metrics
      </Accordion>

      <Accordion title="get_nfts_market_chart">
        Historical market chart data for NFT collections

        * **Metrics**: Floor price, market cap, volume over time
      </Accordion>
    </AccordionGroup>

    <Info>
      NFT data includes floor prices, market caps, and trading volumes for major collections.
    </Info>
  </Accordion>
</AccordionGroup>

***

## 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

### Data Filtering and Search

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.
</Warning>

<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.
</Tip>

***

## Guardrails

In addition to the [14 universal guardrails](/civic/concepts/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.
</Note>

| Guardrail                              | Operation                      | Timing   | Description                                  |
| -------------------------------------- | ------------------------------ | -------- | -------------------------------------------- |
| Restrict to Vetted Coin IDs            | `get_id_coins`                 | Request  | Allowlist for coin ID queries                |
| Restrict Simple Price to Vetted Coins  | `get_simple_price`             | Request  | Allowlist for price queries                  |
| Restrict Coins History to Vetted Coins | `get_coins_history`            | Request  | Allowlist for historical data                |
| Restrict Market Chart to Vetted Coins  | `get_range_coins_market_chart` | Request  | Allowlist for market chart queries           |
| Restrict OHLC to Vetted Coins          | `get_range_coins_ohlc`         | Request  | Allowlist for candlestick queries            |
| Restrict Search to Vetted Coins        | `get_search`                   | Request  | Allowlist for search queries                 |
| Filter Search Results to Vetted Coins  | `get_search`                   | Response | Redacts non-vetted coins from search results |
| Filter Market Data to Vetted Coins     | `get_coins_markets`            | Response | Redacts non-vetted coins from market data    |
| Filter Trending to Vetted Coins        | `get_search_trending`          | Response | Redacts non-vetted coins from trending       |
| Filter New Coins to Vetted List        | `get_new_coins_list`           | Response | Redacts non-vetted coins from new listings   |
| Filter Gainers/Losers to Vetted Coins  | `get_coins_top_gainers_losers` | Response | Redacts non-vetted coins from gainers/losers |

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