hyperliquid-reader
通过 opencli 读取 Hyperliquid（app.hyperliquid.xyz）的永续合约和现货市场数据（仅限只读的公开信息 API）。当用户需要 Hyperliquid 永续合约或现货市场、标记价/预言机价格/中间价、24 小时涨跌幅、资金费率（每小时或年化 APR）、未平仓合约量、成交量、L2 订单簿、OHLCV K 线、历史资金费率，或进行跨平台资金费率比较（Hyperliquid 与 Binance、Bybit）以开展资金费率套利时使用。 触发词：“BTC 的 Hyperliquid 资金费率”“HL 永续合约市场”“BTC 永续合约资金费率”“Hyperliquid 订单簿”“HL 未平仓量”“Hyperliquid 与 Binance 的资金费率套利”“Hyperliquid 的 SOL K 线”“Hyperliquid 现货市场”“Hyperliquid 上的 PURR 价格”“hyperliquid”“hyperliquid.xyz”“HL DEX”。 仅限读取市场数据——不得执行账户、下单或交易操作。
Hyperliquid Reader - Hyperliquid 永续合约市场数据与资金费率查询技能
技能概述
hyperliquid-reader 是一个只读的 Hyperliquid 行情查询技能：通过 opencli 调用 Hyperliquid 公开 info API，一次性获取永续与现货市场的价格、资金费率（小时费率与年化 APR）、持仓量、成交量、订单簿和 K 线数据，并支持对比 Hyperliquid 与币安、Bybit 的资金费率价差——无需 API key、无需连接钱包。
适用场景
- 永续合约行情速览：查看 BTC、ETH、SOL 等标的的 mark/mid 价格、24 小时涨跌、资金费率、持仓量（OI）与成交额，按费率或涨跌排序找出最活跃、费率最极端的合约。
- 跨所资金费率套利筛选：用 funding-compare 同屏对比 Hyperliquid、币安、Bybit 三个 venue 的年化资金费率及价差，快速定位费率错位最大的品种作为套利线索。
- 开仓前的深度与走势分析：读取订单簿前 N 档计算点差，拉取 1 分钟到 1 个月共 14 种周期的 K 线回顾走势，或调取历史资金费率评估持仓成本。
核心功能
- 永续与现货市场快照：一条命令返回每个合约的 mark / oracle / mid 价格、24h 涨跌幅、小时资金费率与年化 APR、持仓量（币本位与名义美元）、24h 成交额、溢价率和最大杠杆；现货侧提供 PURR/USDC 等交易对的价格、市值与流通量。
- 资金费率分析与跨所对比：资金费率同时以小时费率和年化 APR 两种口径呈现（APR = 小时费率 × 24 × 365），funding-compare 按各交易所自身的结算周期分别年化，输出 HL-vs-币安 / HL-vs-Bybit 价差并按绝对价差排序；另可查询任意币种的历史资金费率序列。
- 订单簿与 K 线数据读取：订单簿默认每边 10 档、最多 20 档，可指定有效位数聚合价位；K 线覆盖 1m 到 1M 共 14 种周期、单次最多 5000 根，输出 OHLCV 与成交笔数，支持表格 / JSON / YAML / Markdown / CSV 五种输出格式。
常见问题
查询 Hyperliquid 数据需要 API key 或连接钱包吗？
不需要。所有命令都只请求 Hyperliquid 完全公开的 info API（POST https://api.hyperliquid.xyz/info），无需注册、无需私钥、无需运行客户端，因此该技能免费可用，也不会触及任何账户信息。
hyperliquid-reader 能帮我下单交易吗？
不能，这是刻意的安全边界。该技能仅读取市场数据（行情、资金费率、订单簿、K 线），插件没有提供任何下单、撤单、转账或账户读取的接口——下单需要钱包签名的写操作和独立端点，本技能从不调用。
资金费率为正或为负是什么意思？APR 怎么算？
正费率表示多头付钱给空头，负费率表示空头付钱给多头。Hyperliquid 的费率按小时结算，年化 APR = 小时费率 × 24 × 365；对比币安 / Bybit 时，funding-compare 会按各交易所自己的结算周期（通常 4 小时或 8 小时）分别年化后再计算价差。注意：价差只是套利筛选信号，实际收益还要扣除手续费与提币摩擦。