用途:通过 OpenFinance 在 Hyperliquid 上进行永续合约与现货交易,并获取实时行情与历史数据。
前提:需先完成 openfinance-setup(API 密钥 + EVM 钱包委托)。交易前钱包需有 USDC,并通过 GET /agent/trading/deposit-address 获取充值地址,转入 USDC 后链上路由自动处理。永续下单需保证金位于永续账户,非现货账户,可用 POST /agent/trading/transfer 在两者间划转。
账户与资金:GET /agent/trading/account 查永续账户摘要(marginSummary 与持仓);/account/spot 查现货余额;/portfolio 合并视图;/rate-limit 查 API 限额;POST /agent/trading/transfer 以 body {amount, toPerp} 划转 USDC。
行情:REST 提供 /market/mids、/market/metas、/market/perp-metas(含资产索引与 szDecimals)、/market/spot-metas、/market/l2-book/:coin、/market/token/:tokenId、/market/all-dexs-asset-ctxs。历史 K 线需直接请求 https://api.hyperliquid.xyz/info,POST body 用 type: candleSnapshot 及 coin、interval、startTime、endTime,最多返回最近 5000 根。实时数据可连 wss://api.hyperliquid.xyz/ws 订阅 allDexsAssetCtxs、allMids、l2Book、trades、candle 等频道,用户级频道需签名。
下单与订单管理:POST /agent/trading/orders 下单,需 a(资产索引,来自 perp-metas)、b、p、s、r、t;tif 支持 Gtc、Ioc、Alo;grouping 支持 na、normalTpsl、positionTpsl。可查开放订单、详情、历史与单笔状态;DELETE /agent/trading/orders 批量撤单,PUT /agent/trading/orders/:oid 改单。
TWAP:POST /agent/trading/twap 拆分大单,GET /agent/trading/twap/fills 查成交切片,DELETE /agent/trading/twap/:twapId 终止。
杠杆与保证金:POST /agent/trading/leverage 设置杠杆与保证金模式(须在下杠杆单前设置);POST /agent/trading/margin 对逐仓持仓增减保证金。成交与资金费可通过 /fills、/fills/by-time、/funding 查询。
限制与注意:sz 以基础资产计价而非 USD;limit_px 价位精度因资产而异,需查 perp-metas 的 szDecimals;Hyperliquid 会拒绝偏离中间价过远的报价(价格带约 5–10%);现货与永续余额分离;allDexsAssetCtxs 数组无资产名,需先用 /market/metas 建立索引映射;WS 缓存启动后首条消息可能有数秒延迟。MCP 工具名与路由对应,如 hyperliquid_place_order、hyperliquid_cancel_order 等。