crypto-price

核心用法

crypto-price 是一款轻量级加密货币价格查询与可视化工具，用户通过命令行传入代币符号（如 BTC、ETH、HYPE）和可选时间周期（30m/3h/12h/24h/2d），即可获取实时价格数据并生成暗色主题 K 线图表。执行后返回 JSON 格式的价格、涨跌幅、图表路径及文本描述，支持通过 MEDIA: <path>> 指令直接渲染图片。

显著优点

双源冗余设计：优先调用 Hyperliquid API 获取平台原生代币数据，CoinGecko 作为通用 fallback，确保主流币种全覆盖。 零配置开箱即用：无需 API 密钥，依赖仅 matplotlib 单库，部署门槛低。 智能缓存机制：5 分钟本地缓存减少重复请求，指数退避重试（2s/4s/6s）提升稳定性。 专业图表输出：8×8 方形暗色 K 线图，符合交易软件视觉习惯，可直接用于分析分享。

潜在缺点与局限性

数据源依赖风险：完全依赖第三方公共 API，CoinGecko 免费版有速率限制，极端行情下可能出现延迟或不可用。 功能边界清晰：仅支持价格查询与基础图表，无技术指标（MA、RSI 等）、无多币种对比、无历史数据导出。 缓存时效固定：300 秒缓存无法调节，对高频交易场景不够灵活。 平台覆盖有限：Hyperliquid 优先策略对非该平台代币无额外优势。

适合的目标群体

• 加密货币投资者与交易者：快速查看持仓代币价格与走势
• 内容创作者与社群运营：生成标准化图表用于推文、报告
• 轻度 DeFi 用户：无需复杂工具即可获取市场数据
• Clawdbot 生态用户：作为对话式机器人的数据增强组件

使用风险

服务连续性：外部 API 变更或限流可能导致功能中断，建议关注官方公告。网络稳定性：15 秒超时在弱网环境可能触发失败。存储空间：/tmp 目录缓存文件需定期清理，长期运行可能累积。数据准确性：公共 API 价格可能与交易所实盘存在细微偏差，不宜作为交易唯一依据。