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 - Keep-alive system to ensure connection health
Constraints
- Timeout: 300 seconds without heartbeat
- Rate Limits 10 messages per minute
Available Channels
| Channel | Description |
|---|---|
tape | Global order book updates for all markets |
lifecycle | Market lifecycle events (OPEN, END, CLOSE, START) |
private | Private fill and cancel updates for your orders |
{marketId} | Order book updates for a specific market |
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
- Respond to ping messages with pong
- Handle reconnection if connection drops