WebSocket

Gli endpoint WebSocket sono disponibili per lo streaming di dati in tempo reale e come alternativa all'invio di richieste HTTP sull'exchange Hyperliquid. Gli URL WebSocket per rete sono:

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

Connessione

Per connettersi all'API WebSocket, stabilire una connessione WebSocket all'URL corrispondente in base alla rete desiderata. Una volta stabilita la connessione, è possibile iniziare a inviare messaggi di sottoscrizione per ricevere aggiornamenti dei dati in tempo reale.

Esempio dalla riga di comando:

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

Importante: tutti gli utenti automatizzati dovrebbero gestire le disconnessioni provenienti dal lato server e riconnettersi in modo corretto. La disconnessione dai server API può avvenire periodicamente e senza preavviso. I dati non ricevuti durante la riconnessione saranno presenti nell'ack dello snapshot alla riconnessione. Gli utenti possono inoltre interrogare manualmente eventuali dati mancanti utilizzando la corrispondente richiesta info.

Nota: questo documento utilizza Typescript per definire molti dei tipi di messaggio. Anche l'SDK Python contiene esempi qui e codice di esempio per la connessione qui.