基于 CoinGecko 和 Hyperliquid 双数据源，为加密货币投资者提供实时价格查询与专业 K 线图表生成，数据缓存 5 分钟保障效率。
说明：
## 核心用法
crypto-price 是一款轻量级加密货币价格查询与可视化工具，用户通过命令行传入代币符号（如 BTC、ETH、HYPE）和可选时间周期（30m/3h/12h/24h/2d），即可获取实时价格数据并生成暗色主题 K 线图表。执行后返回 JSON 格式的价格、涨跌幅、图表路径及文本描述，支持通过 `MEDIA: >` 指令直接渲染图片。
## 显著优点
**双源冗余设计**：优先调用 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 价格可能与交易所实盘存在细微偏差，不宜作为交易唯一依据。
会员专属
