用途:通过已安装的 cg CLI 获取 CoinGecko 加密货币市场数据。
主要能力:查询价格、市值、热门币种、涨幅榜/跌幅榜、币种搜索,以及历史与 OHLC 数据。支持 JSON 等可解析输出,也支持按用户要求导出 CSV。
使用方式:先确认工具存在并查看非交互认证与套餐状态,执行 command -v cg、cg status -o json、cg commands -o json。以 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 获取当前 API 文档,并说明 CLI 路径不可用。不要暴露 API 密钥,也不要向市场数据端点发送私有钱包或账户数据;未经用户批准不要执行交互式 cg auth 或写入配置。输出面向人时以币种标题开头,用紧凑表格只显示所请求指标,并附来源行说明端点、时间戳、套餐或时间窗口;导出时标明行数与查询窗口,不复制 CSV 内容。