Websocket
WebSocketエンドポイントは、リアルタイムデータストリーミングおよびHyperliquid取引所における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サーバーからの切断は、予告なしに定期的に発生する可能性があります。再接続中に失われたデータは、再接続時のスナップショットackに含まれます。また、ユーザーは対応するinfoリクエストを使用して、失われたデータを手動でクエリすることもできます。
注:このドキュメントでは、多くのメッセージ型の定義にTypescriptを使用しています。Python SDKにも例がこちらにあり、接続コードの例はこちらにあります。