用途:通过 CoinGecko API V3 查询加密货币市场数据,适用于价格查询、市值排行、历史走势、趋势币种与全局市场统计等场景。
主要能力:按币种 ID、符号或合约地址查询价格;获取市值、成交量与涨跌幅等市场数据;历史价格曲线与 OHLC K 线;搜索与趋势币种;全局市场统计(总市值、24h 成交量、BTC/ETH 占比、活跃币种数)。覆盖 Demo(免费)、Analyst、Lite 与 Pro 档位;链上 DEX 数据(GeckoTerminal)不在本技能范围,需参考备用文档。
使用方式:先检测 API Key,设置 CG_BASE 与 CG_AUTH。若存在 COINGECKO_PRO_API_KEY,则使用 Pro 地址与 x-cg-pro-api-key;否则若存在 COINGECKO_API_KEY,使用 Demo 地址与 x-cg-demo-api-key;否则无 Key 访问并提示更严格的限流。常用请求如: curl -s "$CG_BASE/simple/price?ids=bitcoin,ethereum&vs_currencies=usd&include_24hr_change=true&include_market_cap=true" "${CG_AUTH[@]}" 按合约查询: curl -s "$CG_BASE/simple/token_price/ethereum?contract_addresses=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&vs_currencies=usd&include_market_cap=true" "${CG_AUTH[@]}" 市值排行: curl -s "$CG_BASE/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=10&page=1&price_change_percentage=24h,7d" "${CG_AUTH[@]}" 历史与 K 线: curl -s "$CG_BASE/coins/bitcoin/market_chart?vs_currency=usd&days=7" "${CG_AUTH[@]}" curl -s "$CG_BASE/coins/bitcoin/ohlc?vs_currency=usd&days=7" "${CG_AUTH[@]}" 全局与趋势: curl -s "$CG_BASE/global" "${CG_AUTH[@]}" curl -s "$CG_BASE/search/trending" "${CG_AUTH[@]}"
币种与平台解析:优先使用已知 ID(如 bitcoin、ethereum、binancecoin、avalanche-2、polygon-ecosystem-token);符号不唯一时用 /search 消歧;合约查询需先推断平台 ID,不要默认以太坊;Base58 地址可能属 Solana 或 Tron,需向用户确认;测试网关键词应提示 CoinGecko 不索引测试网代币。
输出与限制:默认以 Markdown 表格展示,并按用户要求输出 JSON、CSV 等;价格与市值按规则格式化。限流方面,Demo 约 30 次/分钟、约 1 万次/月,Analyst 约 500 次/分钟、50 万次/月,Lite 约 500 次/分钟、100 万次/月,Pro 约 1000 次/分钟、300 万次/月,具体以官方为准。遇 429 应稍后重试并合并请求;/simple 接口对未知 ID 返回空对象而非 404;401/10005 表示当前档位不含该端点,可回退至 Demo 地址重试,但 10002 表示 Key 配置错误,不可用此回退。
适用场景:需要快速、结构化地获取加密货币市场行情数据时使用。缺失事实:该技能的具体安装方式与依赖未提供。