CoinGecko 是一个加密货币行情查询技能，用于通过 CoinGecko 免费 API 获取加密货币价格、市值、图表和热门代币数据。
用途 该技能面向需要查询加密货币市场数据的场景，提供对 CoinGecko API 的具体调用参考。基础 URL 为 https://api.coingecko.com/api/v3，无需 API 密钥，速率限制约为每分钟 30 次调用。
主要能力
- 价格查询：GET /simple/price?ids={ids}&vs_currencies={currencies}&include_24hr_change=true&include_market_cap=true。ids 为逗号分隔的 CoinGecko ID，vs_currencies 支持 usd、btc、eth、bnb。
- 按合约地址查询代币价格：GET /simple/token_price/{platform}?contract_addresses={addresses}&vs_currencies=usd&include_24hr_change=true。支持的平台 ID 包括 binance-smart-chain（BSC）、ethereum、polygon-pos、arbitrum-one、optimistic-ethereum、base。
- 市值排名：GET /coins/markets?vs_currency=usd&order=market_cap_desc&per_page=20&page=1&sparkline=false，返回头部币种的价格、市值、成交量和 24 小时涨跌。
- 热门数据：GET /search/trending，返回热门币种、NFT 和分类，无需参数。
- 历史图表：GET /coins/{id}/market_chart?vs_currency=usd&days={days}，days 支持 1、7、14、30、90、365、max，返回价格、市值、总成交量的 [timestamp, value] 数组。
- 币种详情：GET /coins/{id}?localization=false&tickers=false&community_data=false&developer_data=false，返回完整元数据，包括描述、链接、合约地址和市场数据。
使用方式 该技能提供 CoinGecko ID 对照表，涵盖 BTC（bitcoin）、ETH（ethereum）、BNB（binancecoin）、SOL（solana）、USDT（tether）、USDC（usd-coin）、XRP（ripple）、ADA（cardano）、DOGE（dogecoin）、AVAX（avalanche-2）、DOT（polkadot）、MATIC（matic-network）、LINK（chainlink）、UNI（uniswap）、CAKE（pancakeswap-token）、ARB（arbitrum）、OP（optimism）、AAVE（aave）、LDO（lido-dao）、SHIB（shiba-inu）。对于未知代币，可通过 GET /search?query={name} 搜索。使用说明建议始终使用 curl -s 获取数据，然后解析 JSON 响应。
适用场景 适用于查询加密货币实时价格、市值排名、热门代币、历史走势以及币种详细信息的场景。
限制 对于 CoinGecko 未收录的链上代币价格，需回退到通过 swap_get_quote 获取 DEX 报价。该技能是具体的 API 参考，market-data 技能提供高层工作流指导。报告数据时应注明数据来源和新鲜度，例如“CoinGecko, fetched just now”。