Hyperliquid (只读)

使用信息HTTP端点：

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

为Hyperliquid实现只读市场数据查询。首选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解析/hlhl首先（确定性的）。如果没有前缀，则回退到从自然语言中提取意图。

规范命令 (v1)

市场数据：

• quote <币种>：显示标记价/中间价/预言机价、24小时涨跌幅（prevDayPx）、24小时名义交易量、未平仓合约（永续合约）、资金费率（永续合约）、溢价、冲击价格
• movers [--window 24h] [--top N]：按24小时百分比变化排名（markPx 对比 prevDayPx）
• 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..|label>：显示未成交订单
• fills <HL:0x..|0x..|label> [--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（首选）：所有永续合约的 universe + 资产上下文
• l2Book
• candleSnapshot

现货（后续可选）：

• spotMetaAndAssetCtxsspotMeta请参阅

references/hyperliquid-api.md以了解请求体和字段含义。实施指南

使用捆绑的脚本：

scripts/hyperliquid_api.mjs

• ：精简的 HTTP 客户端 + 辅助函数（安全默认值、超时设置）scripts/hyperliquid_chat.mjs
• ：将用户文本解析为意图 + 参数，调用 API 辅助函数，并打印简洁的、适合聊天的响应响应时：

首选简短的要点输出。

• 显示单位和时间范围。
• 优雅地处理缺失字段（例如，midPx 有时为 null）。
• 快速手动测试

本地运行：

Run locally:

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