Skip to main content

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

​
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

Connect to CoinGecko

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

No Authentication Required

CoinGecko server uses public API endpoints that don’t require authentication.
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

  • 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
  • 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
  • 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
  • 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)

Essential tools for cryptocurrency prices, market caps, and basic market information.Price and Market Data
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
Quick price lookups for specific coins in multiple currencies
  • Use Cases: Simple price checks, portfolio valuation, quick comparisons
Top 30 coins with largest price gains and losses by time duration
  • Timeframes: 1h, 24h, 7d, 14d, 30d, 60d, 1y
Complete metadata and market data for specific coins by ID
  • Data: Full coin details, market data, social links, developer data
Global cryptocurrency market overview and statistics
  • Data: Total market cap, total volume, market dominance, DeFi stats
Historical data for a specific coin on a particular date
  • Use Cases: Point-in-time analysis, historical comparisons
Always use jq_filter parameter to reduce response size and improve performance.
Tools for discovering cryptocurrencies and understanding the CoinGecko ecosystem.
Complete list of all supported coins with IDs, names, and symbols
  • Parameters: include_platform (contract addresses), status (active/inactive)
Latest 200 coins recently listed on CoinGecko
  • Use Cases: Discovery of new projects, early-stage research
All coin categories available on CoinGecko
  • Categories: DeFi, NFT, Gaming, Layer 1, Layer 2, etc.
Comprehensive historical price data and charting information.
Historical price, market cap, and volume data within date ranges
  • Parameters: coin ID, vs_currency, from/to timestamps
OHLC (Open, High, Low, Close) candle data for specific time ranges
  • Use Cases: Technical analysis, candlestick charting
Historical data for tokens by contract address
  • Use Cases: Token-specific analysis, contract-based tracking
Token data by blockchain platform and contract address
  • Platforms: Ethereum, BSC, Polygon, Arbitrum, etc.
Advanced DeFi protocol data, liquidity pools, and on-chain metrics.Network and DEX Data
All supported blockchain networks for on-chain data
Decentralized exchanges on specific networks
On-chain data categories and classifications
Liquidity pool categories across DeFi protocols
Pool Analysis Tools
Recently created liquidity pools
Comprehensive pool data including TVL, volume, APY
Detailed information about specific liquidity pools
Recent trades and transactions for specific pools
Token Analytics
Comprehensive token information including supply, holders
Top token holders and distribution analysis
Liquidity pools containing specific tokens
Recent trading activity for specific tokens
DeFi tools require specific network and address parameters. Use discovery tools first to find valid IDs.
NFT collection data, market trends, and digital asset analytics.
List of supported NFT collections with basic information
  • Parameters: order (market_cap, volume, id), per_page, asset_platform_id
Detailed NFT collection data including floor price, market cap
  • Data: Collection stats, social links, description, market metrics
Historical market chart data for NFT collections
  • Metrics: Floor price, market cap, volume over time
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
CoinGecko API has rate limits. For high-frequency access or commercial use, consider CoinGecko’s paid API plans.
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.
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
Configure guardrails via the Civic UI or ask the Configurator Agent: “Add guardrails to my CoinGecko server.”