Hyperliquid（只读）

使用 Info HTTP 接口实现 Hyperliquid 的只读行情数据查询：

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

优先采用 HTTP 快照 方式实现 v1 版本；WebSocket 流式订阅可在后续版本中添加。

支持的用户输入风格

以下输入方式视为等效：

• 自然语言：“Hyperliquid quote BTC”、“top movers 24h”、“book ETH”、“1h candles for SOL last 48”
• 终端风格：hl quote BTC、hl movers --top 10 --window 24h
• 斜杠风格：/hl quote BTC、/hl overview

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

标准命令（v1）

行情数据：

• quote ：显示标记价格（mark）、中间价（mid）、预言机价格（oracle）、24 小时涨跌幅（prevDayPx）、24 小时名义交易量（notional volume）、未平仓合约量（open interest，仅永续合约）、资金费率（funding，仅永续合约）、溢价率（premium）、冲击价格（impact prices）
• movers [--window 24h] [--top N]：按 24 小时百分比涨跌幅（markPx 对比 prevDayPx）排序
• funding-top|funding-bottom [--n N]：按资金费率排序（仅永续合约）
• book ：显示买卖盘各前 20 层（含价差 spread）
• candles --interval <1m|...|1M> (--last N | --start --end )
• overview：精简仪表板：热门涨跌幅榜、高资金费率榜、高未平仓合约量榜、高交易量榜

账户信息（只读）：

• positions ：显示永续合约持仓及保证金汇总
• balances ：显示现货余额
• orders ：显示当前挂单
• fills [--n N]：显示最近成交记录

已保存的账户别名（本地存储于 ~/.clawdbot/hyperliquid/config.json）：

• account list
• account add "sub account 1" HL:0x... [--default]
• account remove "sub account 1"
• account default "sub account 1"

自然语言等效表达也应支持：

• “store this address HL:0x... as sub account 1”
• “show me positions of sub account 1”

数据源

永续合约：

• metaAndAssetCtxs（首选）：全部永续合约的 universe 及 asset 上下文
• l2Book
• candleSnapshot

现货（可选，后续支持）：

• spotMetaAndAssetCtxs、spotMeta

请求体结构与字段含义详见 references/hyperliquid-api.md。

实现建议

使用已封装的脚本：

• scripts/hyperliquid_api.mjs：轻量级 HTTP 客户端 + 工具函数（含安全默认值与超时控制）
• scripts/hyperliquid_chat.mjs：将用户输入解析为意图（intent）与参数（args），调用 API 工具函数，并输出紧凑、适合聊天场景的响应

响应时需注意：

• 优先采用简洁的项目符号（bullet）格式输出。
• 明确标注单位与时间范围。
• 对缺失字段做容错处理（例如 midPx 可能为 null）。

快速手动测试

本地运行：

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