WebSocket API
The NBX WebSocket API provides real-time updates for market data, order books, and private trading events. WebSocket URL:wss://api.novig.com/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, and when an event goes live or leaves live play
- Private trading updates - Receive place, fill, and cancel notifications for your orders
- Heartbeat mechanism - Protocol-level keepalive to ensure connection health
Constraints
- Keepalive: the server sends a WebSocket protocol Ping every 15 seconds; a client that misses a full interval without a protocol Pong is disconnected. Standard clients respond automatically — see Heartbeat
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 (protocol Pings are answered automatically by standard clients)
- Handle reconnection if connection drops