Websocket

Hyperliquid 거래소에서는 실시간 데이터 스트리밍과 HTTP 요청 전송의 대안으로 사용할 수 있는 WebSocket 엔드포인트를 제공합니다. 네트워크별 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에도 예시가 여기에 있고, 예제 연결 코드가 여기에 있습니다.