跳到主要內容

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​

信息

以下是 Hermes 在觸發此技能時加載的完整技能定義。這是技能激活時代理看到的指令。

Hyperliquid 技能

通過公共 /info 端點查詢 Hyperliquid 市場和賬戶數據。 只讀 — 無需 API 密鑰，無需簽名，不下單。

12 個命令：dexs, markets, spots, candles, funding, l2, state, spot-balances, fills, orders, review, export。僅使用標準庫 (urllib, json, argparse)。

何時使用​

  • 用戶詢問 Hyperliquid 永續合約或現貨市場數據、K 線、資金費率或 L2 訂單簿
  • 用戶希望檢查錢包的永續合約持倉、現貨餘額、成交記錄或訂單
  • 用戶希望結合近期成交記錄與市場上下文進行交易後回顧
  • 用戶希望檢查構建者部署的永續合約 DEX 或 HIP-3 市場
  • 用戶希望導出規範化的 JSON 數據集（K 線 + 資金費率）以準備回測

前置條件​

僅使用標準庫 — 無需外部包，無需 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 <command> [args]

向任何命令添加 --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 <coin> [--interval 1h] [--hours 24] [--limit N]
hyperliquid_client.py funding <coin> [--hours 72] [--limit N]
hyperliquid_client.py l2 <coin> [--levels N]
hyperliquid_client.py state [address] [--dex DEX]
hyperliquid_client.py spot-balances [address] [--limit N]
hyperliquid_client.py fills [address] [--hours N] [--limit N] [--aggregate-by-time]
hyperliquid_client.py orders [address] [--limit N]
hyperliquid_client.py review [address] [--coin COIN] [--hours N] [--fills N]
hyperliquid_client.py export <coin> [--interval 1h] [--hours N] [--output PATH]

對於 state, spot-balances, fills, orders 和 review，如果在 ~/.hermes/.env 中設置了 HYPERLIQUID_USER_ADDRESS，則地址參數是可選的。

流程​

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 包含：模式版本、源元數據、確切時間窗口、 規範化 K 線行、規範化資金費率行、摘要統計信息。使用 --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 永續合約市場。