Claude Marketplaces
SkillsMCP serversMarketplacesDigestTools
Submit

This week in Claude

Every Monday: Claude Code, Agent SDK, MCP, and the Anthropic platform moves worth your time.

Skills by category
Frontend DevelopmentBackend & APIsTesting & QASecurityDevOps & CI/CDGit & Pull RequestsDocumentationCode Review & QualityAI & Agent BuildingSkill Development
MCP servers by category
Sales & MarketingWeb & Browser AutomationDatabasesAI & LLM ToolsCloud & InfrastructureCommunication & MessagingDeveloper ToolsDesign & CreativeDocuments & KnowledgeSearch & Web Crawling
Marketplaces by category
AI Agents & OrchestrationLLM IntegrationDevelopment ToolsFrontend & UIBackend & APIsDatabasesTesting & Code QualityDevOps & CloudSecurity & ComplianceGit & Version Control
Claude Marketplaces

An independent directory of skills, plugins and MCP servers for Claude Code. Not affiliated with Anthropic.

Browse

  • Skills
  • MCP servers
  • Marketplaces
  • Weekly digest
  • Skill index
  • MCP index
  • Marketplace index

Site

  • About
  • Tools
  • Submit
  • Feedback
  • Privacy
  • llms.txt
  • Plugins reference

Maker

  • Snug
  • Agent Caffeine
  • knobs
  • Wax
  • Vectoys
  • mertduzgun.com
Crafted at
Skills/AI & Agent Building
starchild-ai-agent avatar

Coingecko

starchild-ai-agent/official-skills

Real-time crypto data without the hassle of API docs or rate limits. Pulls current prices, OHLC candles, market rankings, trending coins, and exchange data straight from CoinGecko's API. The skill documentation is unusually thorough, with explicit tool mapping tables that prevent common mistakes like calling similar-sounding tools from other services. Handles both individual coin lookups and bulk market data, plus NFT floor prices and DeFi metrics. Most useful when you need fresh market data for analysis or dashboards, since it automatically resolves coin symbols to CoinGecko's internal IDs and formats everything consistently.

installs
7.9K
GitHub stars
30
last updated
Aug 21, 2026
View on GitHubSave

Install

$ npx -y skills add starchild-ai-agent/official-skills --skill coingecko --agent claude-code

Installs into .claude/skills of the current project.

Files

logo.png

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

FunctionDescription
coin_price(coin_ids, timestamps=None, vs_currency='usd')Current or historical price. coin_ids = comma-string like "bitcoin,ethereum". timestamps = list of unix ts for historical (default: now).
coin_ohlc(coin_id, days=30, vs_currency='usd')OHLC bars for last N days. Returns list of [ts, o, h, l, c]. Granularity auto-selected: 1d=30min, 7-30d=4h, 30d+=4h.
coin_chart(coin_id, days=30, vs_currency='usd')Price + market_cap + total_volume timeseries. Returns {prices, market_caps, total_volumes} (each list of [ts, val]).

Discovery

FunctionDescription
cg_trending()Trending coins, NFTs, categories (last 24h).
cg_top_gainers_losers(vs_currency='usd', duration='24h')Top gainers/losers. duration = 1h/24h/7d/14d/30d/60d/1y.
cg_new_coins()Recently listed coins.
cg_search(query)Search coins/exchanges/categories by name.

Market Data

FunctionDescription
cg_global()Global crypto market: total market_cap, volume, dominance.
cg_global_defi()Global DeFi: TVL, dominance, top protocols.
cg_coins_markets(vs_currency='usd', order='market_cap_desc', per_page=100, page=1, sparkline=False, price_change_percentage='24h', category=None, ids=None)Top coins with full market data.
cg_coin_data(coin_id, localization=False, tickers=False, market_data=True, community_data=False, developer_data=False, sparkline=False)Detailed data for one coin.
cg_coin_tickers(coin_id, exchange_ids=None, include_exchange_logo=False, page=1, order='volume_desc', depth=False)Where a coin trades + volumes.
cg_coins_list(include_platform=False)All coin ids/symbols (for resolving).

Categories / Derivatives / NFTs

FunctionDescription
cg_categories(order='market_cap_desc')Top categories with market_cap and volume.
cg_categories_list()Just category ids/names.
cg_derivatives(include_tickers='unexpired')All derivatives tickers across exchanges (~27k rows). Returns {tickers, count, filter}; see "Derivatives: fields & full-market OI" below.
cg_derivatives_exchanges(order='open_interest_btc_desc', per_page=50)Derivatives exchange rankings.
cg_nfts_list(order='market_cap_usd_desc', per_page=100, page=1)Top NFT collections.
cg_nft(nft_id)NFT collection detail.
cg_nft_by_contract(asset_platform, contract_address)NFT by contract address.

Exchanges

FunctionDescription
cg_exchanges(per_page=100, page=1)Exchange rankings.
cg_exchange(exchange_id)One exchange's detail.
cg_exchange_tickers(exchange_id, ...)Tickers on an exchange.
cg_exchange_volume_chart(exchange_id, days=30)Exchange volume history.

Contracts / Tokens (by platform)

FunctionDescription
cg_token_price(platform, contract_addresses, vs_currencies='usd', include_market_cap=False, include_24hr_vol=False, include_24hr_change=False, include_last_updated_at=False)Price by contract address on a platform.
cg_coin_by_contract(platform, contract_address)Coin metadata by contract.
cg_asset_platforms(filter=None)Supported chains.
cg_vs_currencies()Supported quote currencies.
cg_exchange_rates()BTC-denominated rates for fiat/major coins.

🚫 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 insteadHow to tell them apart
cg_coins_market_datacg_coins_marketsmarket_data=Coinglass derivatives. markets=CoinGecko spot.
cg_ohlc_historycoin_ohlcohlc_history=Coinglass futures candles. coin_ohlc=CoinGecko spot candles.
cg_pair_market_datacg_coin_tickerspair_market_data=Coinglass futures pair. coin_tickers=CoinGecko spot pairs.
cg_supported_exchangescg_exchangessupported_exchanges=Coinglass futures. exchanges=CoinGecko spot.
cg_taker_exchangescg_exchangetaker=Coinglass volume. exchange=CoinGecko exchange info.
cg_aggregated_taker_volumecg_coin_tickerstaker_volume=Coinglass. coin_tickers=CoinGecko volume across exchanges.
defillama_chainscg_global_defiFor 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 typeYou MUST callWhy
K线 / OHLC / candlestick / open high low closecoin_ohlc(coin_id, days)Price data is real-time; training data is stale
走势图 / price chart / 价格趋势coin_chart(coin_id, days)Same reason
当前价格 / price right nowcoin_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 keywordTool to callExample
价格 / 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 / loserscg_top_gainers_losers()cg_top_gainers_losers()
新币 / 新上线 / new coins / recently addedcg_new_coins()cg_new_coins()
总市值 / BTC市占率 / global / 晨报 / 市场概况cg_global()cg_global()
DeFi总市值 / DeFi TVL / DeFi dominancecg_global_defi()cg_global_defi()
板块 / sector / category / L1 / L2 / Meme / AI coinscg_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 / 研究 / fundamentalscg_coin_data(coin_id)cg_coin_data(coin_id="solana", community_data=True)
对比两个币 / compare / XX vs YYcg_coin_data() × 2call once per coin
NFT排名 / NFT市场 / floor price / top NFTscg_nfts_list()cg_nfts_list()
某个NFT (BAYC/Punks/Azuki)cg_nft(nft_id)cg_nft(nft_id="bored-ape-yacht-club")
交易所详情 / Binance详情 / exchange datacg_exchange(exchange_id)cg_exchange(exchange_id="binance")
交易所列表 / exchange rankingcg_exchanges()cg_exchanges()
交易对 / trading pairs / 流动性分布cg_coin_tickers(coin_id)cg_coin_tickers(coin_id="bitcoin")
交易所交易量趋势 / volume chartcg_exchange_volume_chart(exchange_id)cg_exchange_volume_chart(exchange_id="binance", days=30)
合约地址价格 / token price on-chaincg_token_price(platform, contract)cg_token_price(platform="ethereum", contract_addresses="0xa0b...")
搜索币 / 找币 / coin lookup / searchcg_search(query)cg_search(query="pepe")
永续合约交易所 / derivatives exchange / OI排名cg_derivatives_exchanges()cg_derivatives_exchanges()
合约ticker / perpetual / funding / basiscg_derivatives()cg_derivatives()
交易所对比 + 永续交易所cg_exchanges() + cg_derivatives_exchanges()both calls

Derivatives: fields & full-market OI

cg_derivatives() returns {"tickers": [...], "count": N, "filter": "unexpired"}. Each ticker:

FieldMeaning / unit
marketExchange, e.g. "Binance (Futures)"
index_idBase coin, e.g. "BTC" — group by this for per-coin totals
contract_type"perpetual" or "futures" (dated)
open_interestUSD notional
volume_24hUSD
funding_rateAlready a percent per funding interval: 0.006162 = 0.0062%. Do NOT multiply by 100
basis, spreadPercent
priceString — cast with float()

Full-market open interest (use this when CoinGlass coins-markets is unavailable on the platform plan):

from collections import defaultdict
t = cg_derivatives()["tickers"]
perp = [x for x in t if x["contract_type"] == "perpetual" and x.get("open_interest")]
by_coin = defaultdict(float)
for x in perp:
    by_coin[x["index_id"]] += x["open_interest"]
total = sum(by_coin.values())          # ~$217B as of 2026-09

Caveats:

  • Current snapshot only, no history. For OI history use the coinglass skill (per-coin history, summed).
  • Exchange-reported and includes small exchanges, so it runs well above CoinGlass (~$217B vs ~$117B on the same day). Always cite "CoinGecko" as the source, and never plot it on the same chart as CoinGlass or other third-party figures.
  • Funding differs by exchange and margin type (USDT vs USDC vs coin-margined); if you report one per-coin number, use an OI-weighted average and say so.

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


SKILL.md on GitHub

Sponsors

SnugThe clipboard manager you and your agent can use, safelyAgent CaffeineClose your lid, come back to finished workWaxBlock anything with supervision, without erasing your iPhoneOpen StepsSponsoredFree and open-source skills that make AI coding agents easier to understand, verify, and control.

Details

Repository
github.com/starchild-ai-agent/official-skills
Categories
AI & Agent Building, Sales & Marketing, Finance & Trading

More from starchild-ai-agent/official-skills

All 43
  • Twitter7.9K
  • Skill Creator7.8K
  • Twelvedata7.7K
  • Skillmarketplace7.1K
  • Orderly Onboarding7K
  • Project Builder5.2K
  • Browser Preview4.6K
  • Charting4.4K
  • Composio4.3K
  • Coder4.1K
  • Slide Creator4.1K
  • Wallet Policy4.1K
  • Community Publish4K
  • Preview Dev4K
  • Web Crawler3.9K
  • Chart3.9K
  • User Onboarding3K
  • Agentx2.8K
  • Video2.7K
  • Byok Custom Model2.7K
  • Chatgpt Codex Onboarding2.5K
  • Xai Grok Onboarding2.3K
  • Image Edit2.3K
  • Image Portrait2.2K

Recommended

More AI & Agent Building
1starchild-ai-agent avatartwitterstarchild-ai-agent/official-skillsTwitter/X data: fetch tweets, search, user profiles, followers, replies, trends. Use for any x.com or twitter.com URL or lookup (e.g. summarize this tweet, rece7.9Kinstalls
2starchild-ai-agent avatarskill-creatorstarchild-ai-agent/official-skillsScaffold new skills with valid frontmatter, directory layout, and a starter SKILL.md. Use when building a new reusable workflow or wrapping a new API (e.g. crea7.8Kinstalls
3starchild-ai-agent avatartwelvedatastarchild-ai-agent/official-skillsStocks, forex, and commodities prices: real-time quotes and historical bars. Use when looking up traditional-market prices (e.g. AAPL quote, EUR/USD chart, gold7.7Kinstalls
4callstackincubator avataragent-devicecallstackincubator/agent-deviceagent device7.7Kinstalls
5starchild-ai-agent avatarskillmarketplacestarchild-ai-agent/official-skillsSearch, install, and publish skills across official, community, and global registries. Use when finding or sharing skills (e.g. install a "funding rate" skill, 7.1Kinstalls
6inferen-sh avatarai-social-media-contentinferen-sh/skills7Kinstalls