Public channel for updates related to market updates (level 2 price data).

SUBSCRIBE

<wss-channel> market

Book Message

Emitted When:

  • First subscribed to a market/
  • When there is a trade that affects the book

Structure

NameTypeDescription
event_typestring”book”
asset_idstringasset ID (token ID)
marketstringcondition ID of market
timestampstringunix timestamp the current book generation in milliseconds (1/1,000 second)
hashstringhash summary of the orderbook content
buysOrderSummary[]list of type (size, price) aggregate book levels for buys
sellsOrderSummary[]list of type (size, price) aggregate book levels for sells

Where a OrderSummary object is of the form:

NameTypeDescription
pricestringsize available at that price level
sizestringprice of the orderbook level
Response
{
  "event_type": "book",
  "asset_id": "65818619657568813474341868652308942079804919287380422192892211131408793125422",
  "market": "0xbd31dc8a20211944f6b70f31557f1001557b59905b7738480ca09bd4532f84af",
  "buys": [
    { "price": ".48", "size": "30" },
    { "price": ".49", "size": "20" },
    { "price": ".50", "size": "15" }
  ],
  "sells": [
    { "price": ".52", "size": "25" },
    { "price": ".53", "size": "60" },
    { "price": ".54", "size": "10" }
  ],
  "timestamp": "123456789000",
  "hash": "0x0...."
}

Price_change Message

Emitted When:

  • A new order is placed
  • An order is cancelled

Structure

NameTypeDescription
event_typestring”price_change”
asset_idstringasset ID (token ID)
marketstringcondition ID of market
pricestringprice level affected
sizestringnew aggregate size for price level
sidestringbuy/sell
timestampstringtime of event
Response
{
  "asset_id": "71321045679252212594626385532706912750332728571942532289631379312455583992563",
  "changes": [
    {
      "price": "0.4",
      "side": "SELL",
      "size": "3300"
    },
    {
      "price": "0.5",
      "side": "SELL",
      "size": "3400"
    },
    {
      "price": "0.3",
      "side": "SELL",
      "size": "3400"
    }
  ],
  "event_type": "price_change",
  "market": "0x5f65177b394277fd294cd75650044e32ba009a95022d88a0c1d565897d72f8f1",
  "timestamp": "1729084877448",
  "hash": "3cd4d61e042c81560c9037ece0c61f3b1a8fbbdd"
}

Tick_size_change Message

Emitted When:

  • The minimum tick size of the market changes. This happens when the book’s price reaches the limits: price > 0.96 or price < 0.04

Structure

NameTypeDescription
event_typestring”price_change”
asset_idstringasset ID (token ID)
marketstringcondition ID of market
old_tick_sizestringprevious minimum tick size
new_tick_sizestringcurrent minimum tick size
sidestringbuy/sell
timestampstringtime of event
Response
{
"event_type": "tick_size_change",
"asset_id": "65818619657568813474341868652308942079804919287380422192892211131408793125422",\
"market": "0xbd31dc8a20211944f6b70f31557f1001557b59905b7738480ca09bd4532f84af",
"old_tick_size": "0.01",
"new_tick_size": "0.001",
"timestamp": "100000000"
}