Websocket
Hyperliquid 交易所提供 WebSocket 端点,用于实时数据流传输,并作为发送 HTTP 请求的替代方案。各网络的 WebSocket URL 如下:
- 主网(Mainnet):
wss://api.hyperliquid.xyz/ws - 测试网(Testnet):
wss://api.hyperliquid-testnet.xyz/ws。
连接
要连接到 WebSocket API,请根据目标网络建立到相应 URL 的 WebSocket 连接。连接建立后,你就可以开始发送订阅消息以接收实时数据更新。
命令行示例:
$ wscat -c wss://api.hyperliquid.xyz/ws
Connected (press CTRL+C to quit)
> { "method": "subscribe", "subscription": { "type": "trades", "coin": "SOL" } }
< {"channel":"subscriptionResponse","data":{"method":"subscribe","subscription":{"type":"trades","coin":"SOL"}}}
重要提示:所有自动化用户都应处理来自服务器端的断开连接并进行优雅重连。与 API 服务器的连接可能会周期性地断开,且不会提前公告。重连期间遗漏的数据会包含在重连后的快照确认(snapshot ack)中。用户也可以使用相应的 info 请求手动查询任何遗漏的数据。
注意:本文档使用 Typescript 来定义许多消息类型。Python SDK 中的类型示例见这里,连接示例代码见这里。