WebSocket API
The NBX WebSocket API provides real-time updates for market data, order books, and private trading events. WebSocket URL:wss://api.novig.us/tape
QA Environment: wss://api-qa.novig.us/tape
Key Features
- Real-time order book updates - Subscribe to public order book ticks (PLACE, CANCEL)
- Market lifecycle events - Get notified when markets open, close, start, or end
- Private trading updates - Receive fill and cancel notifications for your orders
- Heartbeat mechanism - Client-initiated ping/pong to keep the connection alive
Constraints
- Idle timeout: the connection is dropped after 300 seconds with no traffic in either direction. Any message (including server-sent data) resets the idle timer; clients should send pings during quiet periods (see Heartbeat)
- Rate Limits 10 messages per minute
Available Channels
Connection Flow
- Establish WebSocket connection with Authorization header
- Wait for connection to open
- Send subscription messages for desired channels
- Receive subscription confirmation
- Process incoming messages
- Send a ping if no message has been received from the server for ~30 seconds — the server replies with a pong, and either resets the 300s idle timer (any traffic in either direction will)
- Handle reconnection if connection drops