Crypto Prices

核心用法

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 版本、依赖库升级可能导致模块异常，建议版本锁定与定期健康检查。

核心用法

crypto-prices 是一款专注于实时价格数据获取的文档型 Agent Skill，通过调用本地 crypto_prices.py 模块实现加密货币和贵金属价格的快速查询。用户可通过单条指令查询比特币、以太坊、瑞波币、SUI、Solana 等主流加密货币，以及黄金、白银等大宗商品价格。

该技能支持三种查询模式：单资产查询（fetch_live_price）返回完整价格数据包括 24 小时/7 天/30 天涨跌幅、市值、交易量、历史最高价等；批量查询（fetch_multiple_prices）可同时获取多种资产价格并格式化输出；极简查询（快速模式）仅返回符号、当前价格和 24 小时涨跌幅。技能内置 60 秒缓存机制，重复查询在缓存期内零成本。

显著优点

数据源权威可靠：采用 CoinGecko（全球最大加密货币数据平台之一）、Yahoo Finance（传统金融数据权威）、DexScreener（去中心化交易所数据聚合器）三重数据源，形成智能降级链路——优先使用缓存，其次是 Yahoo Finance（贵金属专用），然后是 CoinGecko 完整接口，最后是 CoinGecko 简化接口和 DexScreener 故障转移。

零依赖轻量设计：作为纯 Markdown 文档型 Skill，本身不包含任何可执行代码或第三方依赖，供应链攻击面为零。所有功能通过引导用户调用本地 Python 模块实现，安全性由用户本地环境保障。

防幻觉机制明确：文档强制规定"永远不要使用网页搜索获取价格"、"永远不要猜测或编造价格"，从源头杜绝大模型常见的实时数据幻觉问题，当所有数据源失效时明确提示"价格不可用"。

潜在缺点与局限性

本地模块依赖：技能本身不包含 crypto_prices.py 实现，依赖用户本地环境中已存在的该模块。若本地环境未配置或模块版本不兼容，技能将无法执行。这对于希望开箱即用的用户构成门槛。

API 速率限制：CoinGecko 免费版约 10 请求/分钟，DexScreener 约 60 请求/分钟。高频查询场景下可能触发限流，批量查询虽内置自动延迟，但仍存在获取延迟或失败风险。

数据源集中风险：所有价格数据依赖中心化 API 服务，若 CoinGecko 或 Yahoo Finance 服务中断或调整接口策略，可能影响数据获取。文档未说明离线缓存或数据持久化机制的具体实现细节。

资产覆盖有限：当前仅预定义 10 余种主流资产别名映射，对于小众代币或新兴加密资产，用户需自行确认模块是否支持及正确的输入格式。

适合的目标群体

• 加密货币投资者与交易者：需要快速获取实时价格进行仓位管理或市场监控
• 金融分析师与研究员：构建市场报告、撰写分析文章时需要可靠价格数据支撑
• 自动化脚本开发者：希望集成价格查询功能到本地工作流或通知系统的技术人员
• Agent 开发者：需要为 AI 助手配置防幻觉、可溯源的价格查询能力的系统构建者

使用风险

性能风险：依赖外部网络 API，查询延迟受网络状况和 API 响应速度影响，不适合高频实时交易决策场景。

数据时效性风险：60 秒缓存机制在极端行情下可能导致数据滞后，重大市场波动期间建议直接访问交易所获取最新成交数据。

依赖项风险：crypto_prices.py 模块的实现质量、更新频率和安全性直接影响该技能的可靠性，用户需自行维护该本地模块。

许可合规风险：当前 Skill 未声明开源许可证，商业使用场景下建议联系维护者（ryandeangraves）确认授权条款。