核心用法
crypto-prices 是本地运行的实时价格查询工具，通过 crypto_prices.py 模块直接对接 CoinGecko、DexScreener、Yahoo Finance 等多个数据源。支持单资产查询与批量查询两种模式，返回包含当前价格、24h/7d/30d涨跌幅、市值、成交量、24h高低点、历史最高价等完整字段的结构化数据。
执行方式：进入 ~/clawd 目录后，通过 Python 命令行导入模块调用 fetch_live_price() 或 fetch_multiple_prices()，或使用 format_price_text() / format_prices_block() 获取格式化输出。
支持资产：BTC、ETH、XRP、SUI、SOL 等主流加密货币，以及黄金(XAU)、白银(XAG)等大宗商品。输入支持别名映射（如 "btc"→"bitcoin"）。
显著优点
1. 多层级数据保障：60秒本地缓存 → Yahoo Finance（贵金属专线）→ CoinGecko 完整/简易 API → DexScreener DEX 数据，四层降级策略确保高可用性
2. 反幻觉强制机制：明确禁止网络搜索（避免抓取陈旧新闻片段），禁止编造价格，失败时明确返回 "price unavailable"
3. 批量查询优化：内置自动延迟控制，规避 CoinGecko ~10次/分钟、DexScreener ~60次/分钟的速率限制
4. 字段完整度高：除实时价格外，提供多维市场指标（多日涨跌幅、ATH偏离度、24h高低点等），满足深度分析需求
潜在局限
- 地理/网络依赖：CoinGecko 在中国大陆等部分地区可能受网络限制，需依赖 DexScreener 降级
- 免费 tier 限制：CoinGecko API 免费版有调用频率上限，高频场景可能触发节流
- 数据粒度：仅提供聚合行情，不含订单簿深度或分笔成交数据
- 资产覆盖边界：非主流小市值代币可能未纳入支持列表
适合人群
- 加密资产投资者/交易员（需快速、可信的报价入口）
- 财经内容创作者（避免引用搜索抓取的错误/过时价格）
- 自动化报告/晨会系统（需要结构化批量数据）
- 任何对价格数据准确性有硬性要求的场景
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据延迟 | 缓存60秒，极端行情下非毫秒级实时 | 模块设计上已平衡性能与新鲜度 |
| API 服务中断 | 外部供应商故障 | 四层降级链（Cache→Yahoo→CoinGecko→DexScreener）|
| 输入歧义 | 用户输入非常规简称 | 预定义别名映射表覆盖常见场景 |