Crypto Price

核心用法

Crypto Price & Chart 是一个加密货币行情查询工具，通过调用 Hyperliquid API 或 CoinGecko API 获取实时价格数据，并自动生成暗色主题的K线蜡烛图。

基本调用方式：

python3 {baseDir}/scripts/get_price_chart.py <SYMBOL> [duration]

支持的时长格式包括 30m、3h、12h、24h（默认）、2d，覆盖从分钟级到日级的多种分析需求。输出包含当前价格、区间涨跌幅百分比，以及PNG格式图表路径。

显著优点

• 双源冗余设计：优先使用Hyperliquid API获取其生态代币（如HYPE），CoinGecko作为通用兜底，提升数据可用性
• 可视化输出：自动生成8×8暗色主题K线图，支持直接以图片形式展示，适合快速趋势判断
• 缓存机制：5分钟价格缓存减少API调用频次，平衡实时性与稳定性

潜在缺点与局限性

• 数据源依赖第三方API，Hyperliquid与CoinGecko均存在服务中断或速率限制风险
• 缓存策略可能导致极端行情下数据滞后
• 图表为固定尺寸PNG，无法交互缩放或查看历史明细
• 未明确标注数据源切换逻辑与优先级，用户难以感知当前数据来自哪一API

适合人群

• 需要快速查看代币价格与近期走势的短线交易者
• 在聊天场景中分享行情截图的社区运营者
• 对Hyperliquid生态代币有追踪需求的用户

常规风险

• 价格数据仅供参考，不构成投资建议
• 第三方API可能收集查询记录，存在隐私泄露隐患
• 自动生成文件存储于/tmp目录，多用户环境需注意权限隔离

核心用法：用户通过命令行调用Python脚本，传入代币符号（如BTC、ETH、HYPE）和可选时间周期（30m/3h/12h/24h/2d），系统自动从Hyperliquid API（优先）或CoinGecko API获取价格数据，生成8×8暗黑主题K线图表并保存至/tmp目录，同时返回JSON格式的价格、涨跌幅及图表路径。

显著优点：
1. 架构极简安全：仅使用Python标准库urllib进行HTTPS请求，无requests等第三方网络库依赖，攻击面极小；唯一外部依赖matplotlib为成熟可视化库，无已知CVE漏洞。
2. 零敏感信息设计：无需API Key即可访问CoinGecko公共端点，代码中无硬编码密钥、密码或私钥，彻底杜绝凭证泄露风险。
3. 数据源权威可信：CoinGecko为行业头部加密数据聚合平台，Hyperliquid为知名去中心化衍生品交易所，双源互补且均支持HTTPS加密传输。
4. 输出规范友好：自动缓存价格数据5分钟避免重复请求，图表以MEDIA标记格式输出便于Clawdbot直接渲染为图片，用户体验流畅。

潜在局限：
1. 功能单一性：仅限价格查询与基础K线图，无订单簿深度、链上指标、多时间框架对比等进阶功能。
2. 外部依赖风险：API服务可用性受CoinGecko/Hyperliquid运营状态影响，高峰期可能触发速率限制（当前无API Key配额较低）。
3. 临时文件管理：虽使用/tmp目录符合规范，但未实现自动清理机制，长期运行可能累积缓存文件。
4. 代币覆盖盲区：Hyperliquid优先策略意味着非该平台代币可能回退至CoinGecko，部分小市值代币数据延迟或缺失。

适合人群：加密货币投资者、交易员、社区运营者需要快速查询主流代币价格及可视化图表，且注重工具安全性和隐私保护的用户；尤其适合在封闭/安全敏感环境中运行的场景（如零第三方库依赖需求）。

常规风险：API响应延迟或故障可能导致价格数据陈旧；matplotlib渲染依赖系统字体，部分精简环境可能缺失中文/特殊字符显示支持；用户输入的代币符号若不规范（如大小写敏感问题）可能触发查询失败。