Skip to main content
This stream provides real-time order book updates for a specified market. Upon subscription to this stream, you will receive publicOrderBookDelta messages whenever the order book changes:
{
    "data": {
        "orders": [
            {
                "orderType": "sell",
                "price": "3181.41",
                "quantity": "38.92"
            },
            {
                "orderType": "buy",
                "price": "3181.39",
                "quantity": "38.98"
            }
        ],
        "statusCode": 200
    },
    "resultType": "publicOrderBookDelta"
}
FieldTypeRequiredDescription
data.ordersarrayYesIncremental order book changes
data.orders[].orderTypestringYesOrder side: Order side: buy or sell
data.orders[].pricestringYesPrice level
data.orders[].quantitystringYesNew total quantity at this price level
data.statusCodenumberYes200
resultTypestringYespublicOrderBookDelta

Order Book Snapshot Request

There is one request called emitPublicOrderBook that returns a full order book snapshot with publicOrderBook response messages. This request is useful for:
  • Bootstrap order book state when first subscribing to the stream
  • Recover after temporary data loss or connection issues
  • Synchronize local book models with the current market state
  • Get the complete order book picture before processing delta updates

Request

{
  "message":"emitPublicOrderBook"
}
FieldTypeRequiredDescription
messagestringYesemitPublicOrderBook

Response

{
    "data": {
        "orders": [
            {
                "orderType": "buy",
                "price": "3181.39",
                "quantity": "38.98"
            },
            {
                "orderType": "sell",
                "price": "3181.41",
                "quantity": "38.92"
            }
        ],
        "statusCode": 200
    },
    "resultType": "publicOrderBook"
}
FieldTypeRequiredDescription
data.ordersarrayYesFull order book entries
data.orders[].orderTypestringYesOrder side: Order side: buy or sell
data.orders[].pricestringYesPrice level
data.orders[].quantitystringYesTotal quantity at this price level
data.statusCodenumberYes200
resultTypestringYespublicOrderBook