用途:通过已安装的 CoinGecko CLI(cg)获取加密货币市场数据,包括价格、市值、热门币种、涨幅/跌幅榜、币种搜索以及历史与 OHLC 数据。
主要能力:以 cg 的机器可读命令目录作为支持操作的事实来源,可查询命令、参数、枚举值、输出格式、端点、认证要求与付费状态。
使用方式:先确认 cg 存在并检查非交互式认证/套餐状态,可运行 command -v cg、cg status -o json、cg commands -o json。不要未经用户批准运行交互式 cg auth 或写入配置。从 cg commands -o json 选择命令、标志、枚举、输出格式、端点、认证要求与 paid_only 状态;仅当目录缺少细节时使用 cg <command> --help。用户给出名称或含义不明的符号时,用 cg search <term> -o json 解析 CoinGecko ID,不要默认符号唯一。对不熟悉或配额敏感的请求先用 --dry-run 预览;可解析查询用 -o json,仅在用户要求 CSV 时用 --export。
限制与边界:命令支持时批量 ID 合并请求;遇到 429 应遵守报告的 reset/backoff,不要激进重试。执行前检测付费专属命令,若当前套餐无法满足应说明并提供受支持路径。cg 不覆盖所有 CoinGecko 端点,合约地址价格、全局统计、NFT 详情、GeckoTerminal 或 logo 元数据等不支持场景需查阅 https://docs.coingecko.com/llms.txt 并说明 CLI 路径不可用。切勿泄露 API 密钥,也不要向市场数据端点发送私有钱包或账户数据。
输出:普通人类可读输出以 ### 🪙 <coin> (<id>) 开头,用紧凑表格展示所请求指标,并附一行来源(端点加时间戳、套餐或窗口)。导出时用 ### ✅ Exported <row count> rows 并链接产物,不复述 CSV。限流时用 ### ⚠️ Rate limited — retry after <time> 或 ### ⏳ Rate limited — retrying after <time>,付费端点用 ### ⚠️ Paid endpoint — current tier: <tier>。请求的 JSON/CSV、精确 ID、URL、值、命令与诊断信息应原样返回。