{/* 此页面由 website/scripts/generate-skill-docs.py 从技能的 SKILL.md 自动生成。请编辑源文件 SKILL.md，而非此页面。 */}

Hyperliquid

Hyperliquid 市场数据、账户历史、交易复盘。

技能元数据


来源	可选 —— 使用 `hermes skills install official/blockchain/hyperliquid` 安装
路径	`optional-skills/blockchain/hyperliquid`
版本	`0.1.0`
作者	Hugo Sequier（Hugo-SEQUIER），Hermes Agent
许可证	MIT
平台	linux, macos, windows
标签	`Hyperliquid`, `Blockchain`, `Crypto`, `Trading`, `Perpetuals`, `Spot`, `DeFi`

参考：完整 SKILL.md

:::info 以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理所看到的指令。 :::

Hyperliquid 技能

通过公共 /info 端点查询 Hyperliquid 市场和账户数据。只读 —— 无需 API 密钥、无需签名、不能下单。

12 个命令：dexs, markets, spots, candles, funding, l2, state, spot-balances, fills, orders, review, export。仅使用标准库（urllib, json, argparse）。

使用时机

用户查询 Hyperliquid 永续或现货市场数据、蜡烛图、资金费率或 L2 订单簿
用户想查看钱包的永续仓位、现货余额、成交或订单
用户想要结合近期成交和市场背景的交易复盘
用户想查看构建者部署的永续 DEX 或 HIP-3 市场
用户想要标准化的 JSON 导出（蜡烛图 + 资金费率）用于回测准备

前提条件

仅标准库 —— 无需外部包，无需 API 密钥。

脚本读取 ~/.hermes/.env 以获取两个可选默认值：

HYPERLIQUID_API_URL —— 默认为 https://api.hyperliquid.xyz。设置为 https://api.hyperliquid-testnet.xyz 用于测试网。
HYPERLIQUID_USER_ADDRESS —— state, spot-balances, fills, orders 和 review 的默认地址。如果未设置，将地址作为第一个位置参数传递。

当前工作目录中的项目 .env 文件也受支持，作为开发者辅助手段。

辅助脚本：~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py

如何运行

通过 terminal 工具调用：

python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py <命令> [参数]

在任何命令后添加 --json 以获取机器可读的输出。

快速参考

hyperliquid_client.py dexs
hyperliquid_client.py markets [--dex DEX] [--limit N] [--sort volume|oi|funding_abs|change_abs|name]
hyperliquid_client.py spots [--limit N]
hyperliquid_client.py candles <币种> [--interval 1h] [--hours 24] [--limit N]
hyperliquid_client.py funding <币种> [--hours 72] [--limit N]
hyperliquid_client.py l2 <币种> [--levels N]
hyperliquid_client.py state [地址] [--dex DEX]
hyperliquid_client.py spot-balances [地址] [--limit N]
hyperliquid_client.py fills [地址] [--hours N] [--limit N] [--aggregate-by-time]
hyperliquid_client.py orders [地址] [--limit N]
hyperliquid_client.py review [地址] [--coin COIN] [--hours N] [--fills N]
hyperliquid_client.py export <币种> [--interval 1h] [--hours N] [--output PATH]

对于 state, spot-balances, fills, orders 和 review，当 HYPERLIQUID_USER_ADDRESS 在 ~/.hermes/.env 中设置时，地址可选。

操作步骤

1. 发现 DEX 和市场

python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py dexs
 
python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  markets --limit 15 --sort volume
 
python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  spots --limit 15

--dex 仅适用于永续端点；省略则使用第一个永续 DEX。
现货交易对可能显示为 PURR/USDC 或 @107 等别名。
HIP-3 市场在币种前加上 DEX 前缀，例如 mydex:BTC。

2. 获取历史市场数据

python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  candles BTC --interval 1h --hours 72 --limit 48
 
python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  funding BTC --hours 168 --limit 30

时间范围端点分页返回。对于更大的时间窗口，使用后续的 startTime 重复查询，或使用 export（见下文）。

3. 查看实时订单簿

python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  l2 BTC --levels 10

在查询订单簿深度、近期流动性或大额订单的潜在市场影响时使用。

4. 复盘账户

python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  state 0xabc...
 
python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  spot-balances

state 返回永续仓位；spot-balances 返回现货库存。用于查询”我的仓位如何？”、“我持有什么？”、“多少可以提取？“。

5. 查看成交和订单

python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  fills 0xabc... --hours 72 --limit 25
 
python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  orders --limit 25

6. 生成交易复盘

python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  review 0xabc... --hours 72 --fills 50
 
python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  review --coin BTC --hours 168

报告已实现盈亏、手续费、盈亏次数、币种细分、市场趋势以及每个交易永续合约的平均资金费率，外加启发式分析（手续费拖累、集中度、逆势亏损）。

对于更深入的交易后分析：从 review 开始找出问题币种或时间窗口 → 提取该期间的 fills 和 orders → 提取每个交易币种的 candles 和 funding → 将决策质量与结果质量分开评判。

7. 导出可复用的数据集

python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  export BTC --interval 1h --hours 168 --output ./btc-1h-7d.json
 
python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  export BTC --interval 15m --hours 72 --end-time-ms 1760000000000

输出 JSON 包含：模式版本、来源元数据、精确时间窗口、标准化的蜡烛图行、标准化的资金费率行、摘要统计。使用 --end-time-ms 实现可复现的时间窗口。

注意事项

公共信息端点有速率限制。大型历史查询可能返回截断的窗口；使用后续 startTime 值迭代获取。
fills --hours ... 使用 userFillsByTime，仅暴露近期的滚动窗口 —— 非完整归档历史。
historicalOrders 仅返回近期订单；非完整导出。
review 命令基于启发式判断。它无法根据成交数据重建交易意图、下单质量或真实滑点。
export 命令写入标准化数据集，而非回测引擎。您仍需要自己的滑点/成交模型。
现货别名如 @107 是有效的标识符，即使 UI 显示更友好的名称。
l2 是即时快照，非时间序列。

验证

python3 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  markets --limit 5

应打印按 24 小时名义交易量排序的顶级 Hyperliquid 永续市场。

好奇心花园🪴

探索

最近的笔记

note-template

getMoon.js

getWeather.js

Hyperliquid —— Hyperliquid 市场数据、账户历史、交易复盘