CoinGecko Skill

Script Usage

Script-mode skill — read this file, then invoke from a bash block:

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/​data/​workspace/​skills/​coingecko")
from exports import coin_price, cg_trending, cg_global

print(coin_price(coin_ids="bitcoin,ethereum"))
print(cg_trending())
EOF

Read exports.py for the full list of available functions. Common ones: coin_price, coin_ohlc, coin_chart, cg_trending, cg_top_gainers_losers, cg_new_coins, cg_global, cg_global_defi, cg_categories, cg_derivatives, cg_coins_markets, cg_coin_data, cg_coin_tickers, cg_search, cg_token_price, cg_coin_by_contract.

CoinGecko Skill

Function Reference (signatures)

All public functions are in exports.py. coin_id is the CoinGecko id (e.g. bitcoin, ethereum) — use cg_search(query) first if unsure. vs_currency defaults to usd.

Prices & Charts

Discovery

Market Data

Categories / Derivatives / NFTs

Exchanges

Contracts / Tokens (by platform)

🚫 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

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

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

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

🌳 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').

---