用途：通过已安装的 cg CLI 获取 CoinGecko 加密货币市场数据，包括价格、市值、热门币种、涨幅/跌幅榜、币种搜索及历史或 OHLC 数据。
主要能力：以 CLI 的机器可读命令目录（cg commands -o json）为支持操作的权威来源，可解析命令、参数、枚举值、输出格式、端点、鉴权要求与 paid_only 状态。支持批量 ID 查询；可用 -o json 输出可解析结果，仅在用户需要 CSV 产物时用 --export。可用 cg search <term> -o json 解析币种 ID，避免把符号当作唯一标识。
使用方式：先确认 CLI 存在并查看非交互式状态：command -v cg、cg status -o json、cg commands -o json。未经用户批准，不要运行交互式 cg auth 或写入配置。对不熟悉或配额敏感的请求先用 --dry-run 预览。更新须经批准，可先 cg update --dry-run，必要时用 --method 指定 homebrew、npm、go 或 script，之后复查版本与命令目录。
限制：cg 不覆盖全部 CoinGecko 端点；不支持合约地址价格、全局统计、NFT 详情、GeckoTerminal 或 logo 元数据时，应获取 https://docs.coingecko.com/llms.txt 的相关 API 文档并说明 CLI 路线不可用。遇到 429 应遵循返回的重置/退避时间，不要频繁重试。执行前检测 paid-only 命令；当前层级无法满足时应说明并提供受支持路线。浏览器回退仅用于可视化历史页面，不用于鉴权、层级、限流、无效输入或歧义错误，也不能替代 JSON/CSV 等机器可读证据。切勿泄露 API 密钥，也不要向市场数据端点发送私有钱包或账户数据。普通人类可读输出用紧凑表格并保留足够精度，导出时报告行数与查询/窗口，不回显 CSV。