WebSocket Overview

The websocket server can be found at wss://bitnomial.com/exchange/ws. The sandbox websocket server can be found at wss://bitnomial.com/exchange/sandbox/ws. It uses a bidirectional feed with all messages encoded as JSON objects. Each message has a type field which allows the consumer to handle it appropriately.

Product Codes

A few messages in the WebSocket protocol use product codes. The product codes are designed to be flexible so that clients don't necessarily have to spell out 10s or 100s of product symbols if they don't want to. To that end, there are a few different ways each product code can be interpreted:

1. Symbol: If the product code exactly matches a product symbol it will apply only to that product.
2. Futures: If the product code exactly matches a future base symbol (eg. "BUS"), then that will apply to all futures that share the same base symbol.
3. Options: If the product code exactly matches a base symbol with an "O" appeneded to it (eg. "BUSO"), then that will apply to all options with an underlying future having that base symbol.

Book Mechanics

When subscribing to the Book channel, refer to the Book Mechanics in the BTP Pricefeed Docs.

Available Channels

There are currently 4 channels available on the Bitnomial WebSocket feed:

• Trade - Trade execution messages
• Book - Order book snapshots and level updates
• Block - Block trade execution messages
• Status - Market state updates