用 opencli 只读获取 Hyperliquid…

当需要 Hyperliquid 的永续或现货市场数据（标记价、资金费率、持仓量、订单簿、K 线、历史资金费率）或与 Binance/Bybit 的资金费率对比时，用 opencli 的 hyperliquid 插件只读拉取公开 info API。

适用场景

解决思路

1. 先检查环境是否就绪：运行 `command -v opencli && opencli hyperliquid markets --coin BTC -f json`，若输出 READY 则跳到第 2 步。
2. 若显示 NOT_INSTALLED，安装 opencli：`npm install -g @jackwener/opencli`（需要 Node.js >= 24，插件声明 engines.node >= 24）。
3. 若显示 SETUP_NEEDED，安装 Hyperliquid 插件：`opencli plugin install github:himself65/finance-skills/hyperliquid`；无需认证、无需启动步骤，用 `opencli hyperliquid markets --coin BTC` 验证。
4. 按需求选择命令：永续市场概览用 `opencli hyperliquid markets`（支持 --sort、--limit、--coin）；单个永续的价格+资金费率+持仓量用 `opencli hyperliquid markets --coin BTC`；现货对概览用 `opencli hyperliquid spot-markets`（--sort、--limit、--pair、--canonical-only）；全部中间价用 `opencli hyperliquid mids`（--coin <子串>）；订单簿用 `opencli hyperliquid book --coin ETH`（--depth、--n-sig-figs）；K 线用 `opencli hyperliquid candles --coin BTC --interval 1h`（--limit）；历史资金费率用 `opencli hyperliquid funding-history --coin BTC`（--hours、--limit）；跨交易所资金费率对比用 `opencli hyperliquid funding-compare`（--coin、--sort、--limit）。
5. 执行命令时用 `-f json` 或 `-f yaml` 获取结构化输出，例如 `opencli hyperliquid markets --sort fundingAprPct --limit 15 -f json`、`opencli hyperliquid funding-compare --sort hlVsBinancePct --limit 20 -f md`、`opencli hyperliquid candles --coin BTC --interval 4h --limit 50 -f csv`、`opencli hyperliquid book --coin ETH --depth 5 -f json`。
6. 币种符号使用裸永续名（如 BTC、ETH、SOL、HYPE，无交易所前缀）；现货对为 BASE/USDC（如 PURR/USDC）；book/candles 可传永续币或现货对。
7. 用 `markets` 作为“某资产/市场表现如何”的默认视角，它一行包含 mark/oracle/mid 价格、24h 涨跌、小时资金费率+APR、持仓量（币与名义值）、24h 成交量；用 --coin 过滤单个资产。
8. 资金费率有两种表示：`fundingHrPct` 是原始小时费率百分比，`fundingAprPct` 是年化（小时 × 24 × 365）；跨资产比较 carry 时用 APR，问“下一小时要付多少”时用小时值。
9. 用 `funding-compare` 做资金费率套利筛选：它按各交易所自身间隔年化（HL 每小时，Binance/Bybit 通常 4 小时），并报告 `hlVsBinancePct` / `hlVsBybitPct` 价差；默认按 HL 与 Binance 价差的绝对值排序（错位最大者在前）；正的 `hlVsBinancePct` 表示 HL 多头比 Binance 多头支付更多。
10. `book` 默认每边 10 档，可用 `--depth`（最大 20）增加，或用 `--n-sig-figs 2..5` 聚合价格档位；从最优买卖价计算价差/中间价。
11. `candles` 拉取最近 `--limit` 根 `--interval` K 线（默认 1h、100 根）；有效间隔：1m 3m 5m 15m 30m 1h 2h 4h 8h 12h 1d 3d 1w 1M；最大 5000。
12. 输出格式：`-f json` 用于程序化处理/喂给其他技能；`-f md` 或 `-f table` 用于人类可读输出；`-f yaml` 结构化可读；`-f csv` 导出表格。
13. 展示结果时先给头条数字再给表格：对 `markets --coin BTC` 先用文字说明标记价、24h 涨跌、资金费率 APR、持仓量；对完整 `markets` 输出先给数量和涨跌/资金费率最高的名字。
14. 用 carry 语言描述资金费率，例如“BTC 永续资金费率为 +10.9% APR（多头付给空头）”；正费率 ⇒ 多头付空头，负费率 ⇒ 空头付多头。
15. 对 `funding-compare` 先呈现错位最大的：币种、两个交易所的 APR、价差；记住价差是年化的，真实套利还要付交易所/提现摩擦成本，所以只作为筛选而非保证收益。
16. 对 `book` 报告价差：最优买价、最优卖价、中间价、以 bps 计的价差，再（或代替）逐档列出；除非被要求，不要粘贴 20 档。
17. 对 `candles` 描述走势：首/末收盘、最高/最低、方向；仅当用户要完整序列时才展示完整 OHLCV 表。
18. 展示前积极过滤：`markets` 约 180 个永续、`mids` 约 700 个市场；除非用户要完整列表，否则按相关排序截取前 15-20 个。
19. 做交易决策时交叉参考：Hyperliquid 是链上场所，股票/期权上下文可搭配 `tradingview-reader` 技能；资金费率/基差交易的核心视图是 `funding-compare` 加 `markets`（premium、OI）。
20. 诊断：运行 `opencli hyperliquid markets --coin BTC`，成功的 BTC 行说明 opencli、插件和公开 API 均可达；若报 `Unknown command: hyperliquid` 则重装插件；`hyperliquid info 4xx/5xx` 是上游 API 问题，稍等重试。
21. 错误处理：`Unknown command: hyperliquid` → 安装插件；`hyperliquid info 429` → 限流，等几秒重试；`hyperliquid info 422/500` → 请求体格式错误或上游问题，检查 coin/interval 后重试；`No perp market for coin "X"` → 符号错误/未上市，运行 `opencli hyperliquid markets`（或 `mids`）找准确符号。
22. 绝不调用任何写操作：本技能只读市场数据，不读账户、不下单/改单/撤单、不转账；插件有意不暴露写端点。

适用边界 · 注意事项

• 需要读取个人账户、下单/改单/撤单或转移资金时——本技能只读市场数据，插件无写端点。
• 未安装 opencli 或 Node.js < 24 时无法使用（插件要求 Node >= 24）。
• 需要非 Hyperliquid 链上场所或非公开/需认证数据时，本技能仅覆盖 Hyperliquid 公开 info API。