WebSocket

WebSocket-Endpunkte stehen für das Streaming von Echtzeitdaten sowie als Alternative zum Senden von HTTP-Anfragen an der Hyperliquid-Börse zur Verfügung. Die WebSocket-URLs nach Netzwerk lauten:

• Mainnet: wss://api.hyperliquid.xyz/ws
• Testnet: wss://api.hyperliquid-testnet.xyz/ws.

Verbindungsaufbau

Um eine Verbindung zur WebSocket-API herzustellen, bauen Sie eine WebSocket-Verbindung zur jeweiligen URL des gewünschten Netzwerks auf. Nach der Verbindung können Sie Subskriptionsnachrichten senden, um Echtzeit-Datenaktualisierungen zu empfangen.

Beispiel über die Kommandozeile:

$ 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"}}}

Wichtig: Alle automatisierten Nutzer sollten serverseitige Verbindungsabbrüche behandeln und die Verbindung kontrolliert wiederherstellen. Trennungen von den API-Servern können regelmäßig und ohne Vorankündigung auftreten. Während der Wiederverbindung verpasste Daten sind in der Snapshot-Bestätigung bei der Wiederverbindung enthalten. Nutzer können verpasste Daten auch manuell über die entsprechende Info-Anfrage abfragen.

Hinweis: Dieses Dokument verwendet Typescript zur Definition vieler Nachrichtentypen. Das Python SDK enthält ebenfalls Beispiele hier und Beispielcode für die Verbindung hier.