核心用法
crypto-prices 技能封装了一套本地 Python 价格抓取模块，通过标准化接口（fetch_live_price、fetch_multiple_prices 等）提供比特币、以太坊、XRP、SUI、黄金、白银等资产的实时行情。用户只需传入资产名称或常用别名（如 btc、xau），模块即自动完成多层级供应商调用与缓存管理。
显著优点
- 多源冗余保障：内置 Cache → Yahoo Finance（贵金属）→ CoinGecko（完整/精简）→ DexScreener（DEX 备份）五级降级链，单点故障不影响服务。
- 数据维度丰富：除最新价外，返回 24h/7d/30d 涨跌幅、市值、24h 成交量、24h 高低点、历史最高价及回撤百分比。
- 性能优化：60 秒本地缓存避免重复请求，批量查询自动处理延迟，CoinGecko 与 DexScreener 速率限制内安全运行。
- 防幻觉设计：严格禁止网络搜索或猜测价格，所有数据均来自可验证 API，失败时明确提示“price unavailable”。
潜在局限
- 本地依赖：需确保
~/clawd/crypto_prices.py存在且依赖库完好，环境迁移需重新部署。 - 供应商限制：CoinGecko 免费层约 10 req/min，高频调用可能触发限流；极端行情下 DexScreener 小币种深度不足。
- 资产覆盖：当前支持列表有限，长尾代币需手动确认映射或扩展模块。
适合人群
- 高频需要报价的加密货币交易员、分析师、内容创作者
- 需嵌入实时价格至日报/晨报、Discord/Telegram 机器人的自动化工作流
- 对价格数据准确性要求极高、拒绝搜索引擎 stale snippet 的专业用户
常规风险
- API 密钥泄露：若未来模块引入私钥，需确保文件权限 600 并避免日志打印。
- 供应商数据偏差：不同交易所价格存在价差，CoinGecko/DexScreener 聚合算法可能延迟反映极端行情。
- 本地环境漂移：Python 版本、依赖库升级可能导致模块异常，建议版本锁定与定期健康检查。