SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场hyperliquid-reader

hyperliquid-reader

数据与分析

查看项目

更新于 10-15 12:47

技能介绍

Hyperliquid Reader（只读）用于读取 Hyperliquid 这一链上永续/现货 DEX 的市场数据，数据来源为 opencli 以及本仓库 opencli-plugins/hyperliquid 目录下的 hyperliquid 插件（该插件独立于 opencli 内置适配器，通过 opencli 的 monorepo 子路径语法安装）。

用途与定位 该技能仅做只读行情数据读取，读取 Hyperliquid 完全公开的 info API 用于分析：市场表格、资金费率、订单簿和 K 线。它不读取个人账户，不进行下单、改单、撤单，也不转移资金。插件中不存在交易路径——下单需要钱包签名操作，指向另一个端点，本适配器从不调用。

工作原理 每条命令向 https://api.hyperliquid.xyz/info 发送一次 POST 请求，请求体为 { "type": "..." }，并对响应做规范化处理。无需 API 密钥、无需钱包、无需登录、无需运行应用——info API 是公开的。

安装与准备 当前环境状态检查命令： !(command -v opencli && opencli hyperliquid markets --coin BTC -f json 2>&1 | head -3 && echo "READY" || echo "SETUP_NEEDED") 2>/dev/null || echo "NOT_INSTALLED" 若显示 READY，可直接进入使用。否则：

  • NOT_INSTALLED：安装 opencli，命令为 npm install -g @jackwener/opencli，需要 Node.js >= 24（hyperliquid 插件声明 engines.node >= 24）。
  • SETUP_NEEDED：安装 Hyperliquid 插件，命令为 opencli plugin install github:himself65/finance-skills/hyperliquid。安装即完成全部设置，无需认证、无需启动步骤。可用 opencli hyperliquid markets --coin BTC 验证。 常见安装问题：opencli: command not found 需执行 npm install -g @jackwener/opencli（Node ≥ 24）；Unknown command: hyperliquid 需安装插件；hyperliquid info 429 为限流，等待几秒后重试。

主要能力与命令

  • 永续市场概览/按成交量排序：opencli hyperliquid markets，支持 --sort、--limit、--coin。
  • 单个永续的价格+资金费率+未平仓量：opencli hyperliquid markets --coin BTC。
  • 现货对概览：opencli hyperliquid spot-markets，支持 --sort、--limit、--pair、--canonical-only。
  • 所有当前中间价：opencli hyperliquid mids，支持 --coin <substring>。
  • 某币种订单簿：opencli hyperliquid book --coin ETH，支持 --depth、--n-sig-figs。
  • OHLCV K 线：opencli hyperliquid candles --coin BTC --interval 1h，支持 --limit。
  • 某币种历史资金费率：opencli hyperliquid funding-history --coin BTC，支持 --hours、--limit。
  • 资金费率套利对比（HL vs Binance vs Bybit）：opencli hyperliquid funding-compare，支持 --coin、--sort、--limit。

使用方式与关键规则 通用模式示例： 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

币种符号为裸永续名称——BTC、ETH、SOL、HYPE（无交易所前缀）。现货对为 BASE/USDC（如 PURR/USDC）；book/candles 可传永续币种或现货对。 markets 是“某资产/市场表现如何”的默认视角，每行包含标记价/预言机价/中间价、24 小时涨跌、小时资金费率+年化、未平仓量（币数与名义价值）、24 小时成交量。用 --coin 过滤单个资产。 资金费率有两种表示：fundingHrPct 为原始小时费率百分比；fundingAprPct 将其年化（小时 × 24 × 365）。跨资产比较 carry 时以 APR 为主；关注“下一小时要付多少”时用小时值。 funding-compare 是资金费率套利筛选器，按各交易所自身间隔年化（HL 为小时，Binance/Bybit 通常为 4 小时），并报告 hlVsBinancePct / hlVsBybitPct 价差。默认排序按 HL 与 Binance 价差绝对值（错位最大者优先）。正的 hlVsBinancePct 表示 HL 多头比 Binance 多头支付更多。 book 默认每边 10 档，可用 --depth（最大 20）增加，或用 --n-sig-figs 2..5 聚合价格档位。从最优买价和卖价计算价差/中间价。 candles 拉取最近 --limit 根 --interval K 线（默认 1h，100 根）。有效间隔：1m 3m 5m 15m 30m 1h 2h 4h 8h 12h 1d 3d 1w 1M。最大 5000。 -f json 用于程序化处理/喂给其他技能；-f md 或 -f table 用于人类可读输出。 只读行情数据。无账户读取，无下单、改单、撤单，无转账——插件有意不暴露写入端点，不要寻找变通方法。

输出格式（-f）

  • Table：-f table（默认），适合人类可读终端输出。
  • JSON：-f json，适合程序化处理、LLM 上下文。
  • YAML：-f yaml，结构化、可读。
  • Markdown：-f md，适合报告。
  • CSV：-f csv，适合电子表格导出。

输出列

  • markets：coin, markPx, midPx, oraclePx, change24hPct, fundingHrPct, fundingAprPct, openInterest, oiNotional, dayNtlVlm, premiumPct, maxLeverage
  • spot-markets：pair, base, markPx, midPx, change24hPct, dayNtlVlm, circulatingSupply, marketCap, canonical
  • mids：coin, mid
  • book：side, level, px, sz, orders
  • candles：time, open, high, low, close, volume, trades
  • funding-history：coin, fundingRatePct, fundingAprPct, premiumPct, time
  • funding-compare：coin, hlAprPct, binanceAprPct, bybitAprPct, hlVsBinancePct, hlVsBybitPct, nextHlFunding

结果呈现建议 先给头条数字，再给表格。对 markets --coin BTC：先用文字说明标记价、24 小时涨跌、资金费率 APR 和未平仓量。对完整 markets 输出：先给数量以及涨幅最大/资金费率最高的名称。 用 carry 术语表述资金费率——例如“BTC 永续资金费率为 +10.9% APR（多头付给空头）”。正资金费率 ⇒ 多头付空头；负 ⇒ 空头付多头。 对 funding-compare，先呈现错位最大的——说明币种、两个交易所的 APR 和价差，并记住价差是年化的；真实套利还需支付交易所/提现摩擦成本，因此应作为筛选器呈现，而非保证的收益。 对 book，先报告价差——最优买价、最优卖价、中间价和以 bps 计的价差，而不是直接倾倒每一档。除非被要求，不要粘贴 20 档。 对 candles，描述走势——首/末收盘、最高/最低和方向；仅当用户想要序列时才展示完整 OHLCV 表。 展示前积极过滤——markets 约有 180 个永续，mids 约有 700 个市场；除非用户要求完整列表，否则按相关排序限制在前 15-20 个。 为交易决策做交叉参考——Hyperliquid 是链上场所；股票/期权背景可搭配 tradingview-reader 技能。对资金费率/基差交易，funding-compare 加 markets（premium、OI）是核心视图。

诊断 opencli hyperliquid markets --coin BTC 成功返回 BTC 行即确认 opencli、插件和公开 API 均可访问。若报 Unknown command: hyperliquid，重装插件（见安装步骤）。hyperliquid info 4xx/5xx 为上游 API 问题——稍等后重试。

错误参考

  • Unknown command: hyperliquid：插件未安装，执行 opencli plugin install github:himself65/finance-skills/hyperliquid。
  • hyperliquid info 429：被限流，等待几秒后重试。
  • hyperliquid info 422/500：请求体格式错误或上游问题，检查 coin/interval，稍后重试。
  • No perp market for coin "X"：符号错误或未上市，运行 opencli hyperliquid markets（或 mids）查找确切符号。

参考文件 references/commands.md——每条命令的全部标志、输出模式和分析工作流（资金费率 carry、基差/套利、现货快照）。