用途:通过 Hyperliquid 公开 /info 接口查询市场与账户数据,全程只读,不需要 API Key、不签名、不下单。
主要能力:共 12 个命令——dexs、markets、spots、candles、funding、l2、state、spot-balances、fills、orders、review、export。可查永续/现货行情、K线、资金费率、L2 盘口快照,查看钱包永续持仓、现货余额、成交与订单,生成结合近期成交与市场背景的交易复盘,以及导出 K线+资金费率的标准化 JSON 供回测准备。仅用标准库(urllib、json、argparse)。
使用方式:脚本位于 ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py,通过终端调用:python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py <command> [args],任意命令加 --json 输出机器可读结果。脚本读取 ${HERMES_HOME:-~/.hermes}/.env 中两个可选默认值:HYPERLIQUID_API_URL(默认 https://api.hyperliquid.xyz,测试网用 https://api.hyperliquid-testnet.xyz)与 HYPERLIQUID_USER_ADDRESS(state、spot-balances、fills、orders、review 的默认地址,未设置时把地址作为第一个位置参数传入)。当前工作目录的 .env 可作为开发回退。
适用场景:查询永续或现货行情、K线、资金费率、L2 盘口;检查钱包持仓、现货余额、成交、订单;做交易后复盘;查看 builder 部署的永续 dex 或 HIP-3 市场;导出标准化数据用于回测准备。
限制:公开 info 接口有速率限制,大范围历史查询可能返回被截断的窗口,需用更晚的 startTime 迭代;fills --hours 使用 userFillsByTime,仅暴露近期滚动窗口而非完整历史;historicalOrders 只返回近期订单;review 为启发式,无法还原意图、下单质量或真实滑点;export 只写标准化数据集,不是回测引擎,仍需自备滑点/成交模型;l2 是时点快照而非时间序列;现货别名如 @107 是有效标识符。--dex 仅适用于永续端点,省略时使用第一个永续 dex;HIP-3 市场币种带 dex 前缀,如 mydex:BTC。