coingecko

CoinGecko

CoinGecko provides comprehensive crypto market data including spot prices, OHLC candles, market cap, trending coins, sector performance, and global stats.

When to Use CoinGecko

Use CoinGecko for:

• Price queries - Current prices, historical prices, OHLC data
• Market overview - Market cap, volume, trending coins, top gainers/losers
• Coin information - Detailed coin data, tickers, trading pairs
• Exchange data - Exchange listings, volumes, trading pairs
• NFT data - NFT collections, floor prices, market stats
• Global metrics - Total market cap, dominance, DeFi stats
• Categories - Sector performance (DeFi, Gaming, Layer 1, etc.)

Common Workflows

Get Coin Price

coin_price(coin_id="bitcoin")  # Supports symbols like BTC, ETH, SOL
coin_price(coin_id="ethereum", vs_currencies="usd,eur")

Historical Data

coin_ohlc(coin_id="bitcoin", vs_currency="usd", days=7)  # OHLC candles
coin_chart(coin_id="ethereum", vs_currency="usd", days=30)  # Price chart data

Market Discovery

cg_trending()  # Trending coins in the last 24h
cg_top_gainers_losers()  # Top movers
cg_new_coins()  # Recently listed coins
cg_coins_markets(vs_currency="usd", order="market_cap_desc", per_page=100)

Coin Information

cg_coin_data(id="bitcoin")  # Detailed coin data
cg_coin_tickers(id="ethereum")  # All trading pairs
cg_search(query="solana")  # Search for coins

Exchange Data

cg_exchanges()  # All exchanges
cg_exchange(id="binance")  # Specific exchange
cg_exchange_tickers(id="binance")  # Exchange trading pairs
cg_exchange_volume_chart(id="binance", days=7)

Global Metrics

cg_global()  # Total market stats
cg_global_defi()  # DeFi specific stats
cg_categories()  # Sector performance

Contract Address Queries

cg_token_price(contract_addresses=["0x..."], vs_currencies="usd")
cg_coin_by_contract(contract_address="0x...", platform="ethereum")

Important Notes

• Coin IDs: CoinGecko uses slug IDs (e.g., "bitcoin", "ethereum", "solana"). The tools auto-resolve common symbols like BTC, ETH, SOL.
• API Key: Requires COINGECKO_API_KEY environment variable (Pro API)
• Rate Limits: Be mindful of API rate limits. Use batch endpoints when querying multiple coins.
• vs_currencies: Most endpoints support multiple currencies (usd, eur, btc, eth, etc.). Use cg_vs_currencies() to see all supported currencies.

Symbol Resolution

Common symbols are automatically resolved:

• BTC → bitcoin
• ETH → ethereum
• SOL → solana
• USDT → tether
• USDC → usd-coin
• BNB → binancecoin

Important: If unsure about a coin ID, always use cg_search(query="coin name") first to find the exact CoinGecko ID before calling price tools.