用途：通过 CoinGecko API V3 查询加密货币市场数据，适用于价格查询、行情排行、历史走势、K 线数据、币种搜索与热门币种、全局市场统计等场景。
主要能力：按币种 ID、符号或合约地址查询价格；获取含排名、成交量、涨跌幅的市场数据；历史价格图表与 OHLC 数据；搜索与热门币种；全局市值、成交量及 BTC/ETH 占比统计。覆盖 Demo（免费）、Analyst、Lite、Pro 档位。
使用方式：先检测 API Key。若存在 COINGECKO_PRO_API_KEY，使用 https://pro-api.coingecko.com/api/v3 与 x-cg-pro-api-key 头；否则若存在 COINGECKO_API_KEY，使用 https://api.coingecko.com/api/v3 与 x-cg-demo-api-key 头；都没有则无密钥访问，速率限制更严。CoinGecko 使用字符串 ID（如 bitcoin、ethereum），需先解析正确 ID；符号不唯一，可用 /search 消歧。合约查询需先推断平台，不要默认以太坊。常用调用如 /simple/price、/simple/token_price/{platform_id}、/coins/markets、/coins/{id}/market_chart、/coins/{id}/ohlc、/global、/search、/search/trending。默认以 Markdown 表格输出，用户指定格式时改用 JSON、CSV 或纯文本。
限制：Demo 约 30 次/分钟、约 1 万次/月，Analyst/Lite/Pro 依套餐而定；部分端点（如 /search/trending、/global）在低档位 Pro 基础 URL 上返回 401/10005，需回退到 Demo 基础 URL。CoinGecko 不索引测试网代币。未知币种 ID 或合约地址时 /simple/* 返回空对象而非 404，应视为未找到并用 /search 解析。遇到 429 应等待后重试，并尽量用逗号分隔 ID 批量查询。链上 DEX 数据、NFT 详情等未覆盖端点可参考 https://docs.coingecko.com/llms.txt。