名称： hyperliquid
描述： 只读的 Hyperliquid 市场数据助手（支持永续合约与现货，现货为可选功能），支持自然语言请求和确定性命令解析（终端风格 hl ... 与斜杠风格 /hl ...）。用于通过 https://api.hyperliquid.xyz/info 获取报价（标记/中间/预言机/资金费率/持仓量/成交量）、涨跌幅排行、资金费率排行、L2 订单簿和 K 线快照，并将结果格式化以便在聊天中展示。

Hyperliquid (只读)

使用 Info HTTP 端点实现只读的 Hyperliquid 市场数据查询：

• POST https://api.hyperliquid.xyz/info
• Content-Type: application/json

v1 版本优先使用 HTTP 快照 流程。WebSocket 流式传输功能可后续添加。

支持的用户输入风格

以下输入方式视为等效：

• 自然语言：“Hyperliquid 报价 BTC”、“24 小时涨跌幅排行”、“ETH 订单簿”、“SOL 过去 48 小时 1 小时 K 线”
• 终端风格：hl quote BTC, hl movers --top 10 --window 24h
• 斜杠风格：/hl quote BTC, /hl overview

优先解析 /hl 和 hl 前缀（确定性）。若无前缀，则回退到从自然语言中提取意图。

标准命令 (v1)

市场数据：
- quote <币种>：显示标记价/中间价/预言机价、24 小时涨跌幅 (prevDayPx)、24 小时名义成交量、持仓量（永续合约）、资金费率（永续合约）、溢价、冲击价格
- movers [--window 24h] [--top N]：按 24 小时涨跌幅百分比（标记价 vs 前一日价格）排名
- funding-top|funding-bottom [--n N]：按资金费率排名（仅永续合约）
- book <币种>：显示买卖双方各前 20 档（及价差）
- candles <币种> --interval <1m|...|1M> (--last N | --start <毫秒时间戳> --end <毫秒时间戳>)
- overview：简明仪表板：涨跌幅排行、资金费率排行、持仓量排行、成交量排行

账户（只读）：
- positions <HL:0x..|0x..|标签>：显示永续合约持仓及保证金摘要
- balances <HL:0x..|0x..|标签>：显示现货余额
- orders <HL:0x..|0x..|标签>：显示未成交订单
- fills <HL:0x..|0x..|标签> [--n N]：显示最近成交记录

保存的账户别名（本地存储在 ~/.clawdbot/hyperliquid/config.json）：
- account list
- account add "子账户 1" HL:0x... [--default]
- account remove "子账户 1"
- account default "子账户 1"

自然语言等效命令也应支持：
- “将地址 HL:0x... 存储为子账户 1”
- “显示子账户 1 的持仓”

数据源

永续合约：
- metaAndAssetCtxs（首选）：所有永续合约的品种信息与资产上下文
- l2Book
- candleSnapshot

现货（后续可选）：
- spotMetaAndAssetCtxs, spotMeta

请求体及字段含义请参阅 references/hyperliquid-api.md。

实现指南

使用内置脚本：

• scripts/hyperliquid_api.mjs：轻量 HTTP 客户端及辅助函数（含安全默认值和超时设置）
• scripts/hyperliquid_chat.mjs：将用户文本解析为意图和参数，调用 API 辅助函数，并输出简洁的聊天友好型响应

响应时请注意：
- 优先使用简短的要点输出。
- 显示单位及时间范围。
- 优雅处理缺失字段（例如，midPx 有时为 null）。

快速手动测试

本地运行：

node skills/hyperliquid/scripts/hyperliquid_chat.mjs "hl quote BTC"
node skills/hyperliquid/scripts/hyperliquid_chat.mjs "/hl movers --top 5"