CoinGecko Skill

🚫 CRITICAL: STOP — READ THIS BEFORE CALLING ANY TOOL

The #1 error is calling Coinglass tools instead of CoinGecko tools. They have similar names but are COMPLETELY DIFFERENT systems.

WRONG → RIGHT Tool Substitution Table

❌ NEVER call this	✅ Call this instead	How to tell them apart
cg_coins_market_data	cg_coins_markets	market_data=Coinglass derivatives. markets=CoinGecko spot.
cg_ohlc_history	coin_ohlc	ohlc_history=Coinglass futures candles. coin_ohlc=CoinGecko spot candles.
cg_pair_market_data	cg_coin_tickers	pair_market_data=Coinglass futures pair. coin_tickers=CoinGecko spot pairs.
cg_supported_exchanges	cg_exchanges	supported_exchanges=Coinglass futures. exchanges=CoinGecko spot.
cg_taker_exchanges	cg_exchange	taker=Coinglass volume. exchange=CoinGecko exchange info.
cg_aggregated_taker_volume	cg_coin_tickers	taker_volume=Coinglass. coin_tickers=CoinGecko volume across exchanges.
defillama_chains	cg_global_defi	For DeFi stats from CoinGecko, use cg_global_defi().

Also FORBIDDEN:

• ❌ web_search / web_fetch — ALL data is available via native CoinGecko tools above. NEVER use web_search for crypto market data.
• ❌ bash for data processing — CoinGecko tools return clean data. No bash needed.
• ❌ NEVER answer with training data — all prices, rankings, OHLC are stale. CALL THE TOOL.

⚠️ MANDATORY TOOL CALLS — You MUST call a tool before answering these

Request type	You MUST call	Why
K线 / OHLC / candlestick / open high low close	coin_ohlc(coin_id, days)	Price data is real-time; training data is stale
走势图 / price chart / 价格趋势	coin_chart(coin_id, days)	Same reason
当前价格 / price right now	coin_price(coin_ids)	Training data has no live prices

DO NOT return any numeric market data (prices, OHLC values, percentages) without calling a tool first.

⚡ Question → Tool Map (match first keyword, call immediately)

Question keyword	Tool to call	Example
价格 / price / 多少钱 (single coin)	coin_price(coin_id)	coin_price(coin_ids="bitcoin")
K线 / OHLC / candlestick / 蜡烛图	coin_ohlc(coin_id, days)	coin_ohlc(coin_id="ethereum", days=7)
走势 / trend / price chart / 价格历史	coin_chart(coin_id, days)	coin_chart(coin_id="solana", days=30)
热门 / trending / 趋势币	cg_trending()	cg_trending()
涨幅最大 / 跌幅最大 / gainers / losers	cg_top_gainers_losers()	cg_top_gainers_losers()
新币 / 新上线 / new coins / recently added	cg_new_coins()	cg_new_coins()
总市值 / BTC市占率 / global / 晨报 / 市场概况	cg_global()	cg_global()
DeFi总市值 / DeFi TVL / DeFi dominance	cg_global_defi()	cg_global_defi()
板块 / sector / category / L1 / L2 / Meme / AI coins	cg_categories()	cg_categories()
板块内个币 / Meme前10 / AI币排名 / DeFi币排名	cg_coins_markets(category=X)	cg_coins_markets(category="meme-token", per_page=10)
市值排名 / top 10 / ranking / 前10币	cg_coins_markets(per_page=N)	cg_coins_markets(per_page=10)
ATH / 历史最高 / 社区 / dev / 研究 / fundamentals	cg_coin_data(coin_id)	cg_coin_data(coin_id="solana", community_data=True)
对比两个币 / compare / XX vs YY	cg_coin_data() × 2	call once per coin
NFT排名 / NFT市场 / floor price / top NFTs	cg_nfts_list()	cg_nfts_list()
某个NFT (BAYC/Punks/Azuki)	cg_nft(nft_id)	cg_nft(nft_id="bored-ape-yacht-club")
交易所详情 / Binance详情 / exchange data	cg_exchange(exchange_id)	cg_exchange(exchange_id="binance")
交易所列表 / exchange ranking	cg_exchanges()	cg_exchanges()
交易对 / trading pairs / 流动性分布	cg_coin_tickers(coin_id)	cg_coin_tickers(coin_id="bitcoin")
交易所交易量趋势 / volume chart	cg_exchange_volume_chart(exchange_id)	cg_exchange_volume_chart(exchange_id="binance", days=30)
合约地址价格 / token price on-chain	cg_token_price(platform, contract)	cg_token_price(platform="ethereum", contract_addresses="0xa0b...")
搜索币 / 找币 / coin lookup / search	cg_search(query)	cg_search(query="pepe")
永续合约交易所 / derivatives exchange / OI排名	cg_derivatives_exchanges()	cg_derivatives_exchanges()
合约ticker / perpetual / funding / basis	cg_derivatives()	cg_derivatives()
交易所对比 + 永续交易所	cg_exchanges() + cg_derivatives_exchanges()	both calls

🌳 Decision Tree

How many coins?
├─ ONE coin
│   ├─ Just price? → coin_price()
│   ├─ ATH/community/dev/deep? → cg_coin_data()
│   ├─ OHLC candles? → coin_ohlc()
│   ├─ Price trend? → coin_chart()
│   └─ Unknown ID? → cg_search() first
├─ MULTIPLE coins / ranking
│   ├─ Sector aggregate (板块总市值)? → cg_categories()
│   ├─ Sector individual (Meme前10)? → cg_coins_markets(category=X)
│   └─ General ranking? → cg_coins_markets(per_page=N)
├─ NFTs → cg_nfts_list() or cg_nft(nft_id)
├─ Exchange → cg_exchange(id) or cg_exchanges()
├─ Global → cg_global() or cg_global_defi()
└─ Token by contract → cg_token_price()

Common Category IDs

meme-token, artificial-intelligence, layer-1, layer-2, decentralized-finance-defi, gaming, real-world-assets-rwa

Output Formatting

• Prices: always use $ sign → $66,697
• Percentages: always use % → +4.2%
• NFT floor in ETH: show USD too → 5.17 ETH ($10,534)

Important Notes

• CoinGecko uses slug IDs: "bitcoin", "ethereum", "solana". Symbols (BTC, ETH, SOL) auto-resolve.
• If unsure about a coin ID → cg_search(query="coin name") first.
• Most questions need only 1-2 tool calls. Do NOT chain 3+ calls.

Common Issues

coin_price failed with invalid ID

Solution: Use cg_search(query="coin name") to find the correct CoinGecko ID first, or use the symbol directly (e.g., 'COMP').

---