Real-Time Data

DexBuilder provides real-time Prediction Markets data through the WebSocket Broker. Public market-data channels do not require authentication.

Connection

Prediction Markets:

wss://broker.dexbuilder.com/ws/dex-builder/prediction

For Event Contracts, use the separate product connection:

wss://broker.dexbuilder.com/ws/dex-builder/event-contracts

The examples below use the Prediction Markets channel prefix pred. Event Contracts uses the corresponding ec prefix. A subscription request contains a request timestamp t, a client id, an operation, a channel, and channel-specific items.

{
  "t": 1720000000123,
  "id": "sub-1",
  "op": "subscribe",
  "ch": "pred.bbo",
  "payload": {
    "items": [
      {
        "token_id": "ge_token-yes"
      }
    ]
  }
}

The server acknowledges the request and then sends channel data. Public channels require items; all: true is reserved for private channels.

Public Channels

Channel	Subscription item	Use
`pred.trades`	`condition_id`	Matched trades
`pred.depth`	`token_id`, `level`	Full order-book snapshots
`pred.bbo`	`token_id`	Best bid/ask and last price
`pred.status`	`market_id`	Market status and outcome prices
`pred.cpi`	`symbol`, `interval`	Reference price updates
`pred.candlestick`	`symbol`, `interval`	Candlestick updates
`pred.oc_price`	`slug` or `market_id`	Price-to-beat and final-price updates

Response Envelope

{
  "t": 1720000000124,
  "trace_id": "trace-1",
  "type": "update",
  "ch": "pred.bbo",
  "err": null,
  "result": {
    "condition_id": "ge_condition-1",
    "token_id": "ge_token-yes",
    "bid_px": "0.4400",
    "ask_px": "0.4600",
    "last_px": "0.4500",
    "ts": 1720000000123
  }
}

Channels with cached state can send type: "snapshot" before subsequent update messages. Order-book snapshots contain full bids and asks arrays; they are not deltas.

CPI Example

Subscribe to a crypto reference price:

{
  "t": 1720000000123,
  "id": "cpi-1",
  "op": "subscribe",
  "ch": "pred.cpi",
  "payload": {
    "items": [
      {
        "symbol": "btcusdt",
        "interval": "1m"
      }
    ]
  }
}

Example update:

{
  "t": 1720000000124,
  "trace_id": "trace-1",
  "type": "update",
  "ch": "pred.cpi",
  "err": null,
  "result": {
    "symbol": "btcusdt",
    "interval": "1m",
    "price": "100000.10",
    "price_timestamp": "1720000000123",
    "ts": 1720000000123
  }
}

Connection Recovery

When a connection is interrupted:

reconnect with backoff;
restore public subscriptions;
use REST endpoints such as /api/v4/prediction/markets and /api/v4/prediction/tokens/{token_id}/ticker to refresh authoritative state;
deduplicate repeated updates using the channel key and timestamp.

See WebSocket Protocol, Public Channels, and WebSocket Authentication for the complete protocol.

Getting Started

PerpDEX

Prediction Markets

Event Contracts

Connection

Public Channels

Response Envelope

CPI Example

Connection Recovery

​Connection

​Subscribe to a Public Channel

​Public Channels

​Response Envelope

​CPI Example

​Connection Recovery

Connection

Subscribe to a Public Channel

Public Channels

Response Envelope

CPI Example

Connection Recovery