WebSocket API
Ticker Channel
Top-of-book snapshot and updates for a market
Channel name: ticker
Subscription
{ "op": "sub", "channel": "ticker", "params": { "market": "BTC-PERP" } }params.market is required.
Message Types
Snapshot
{
"channel": "ticker",
"filter": "BTC-PERP",
"type": "snapshot",
"data": {
"bid": { "px": "50000.00", "sz": "1.5" },
"ask": { "px": "50001.00", "sz": "1.2" }
},
"gsn": 12345,
"ts": "1234567890000000000"
}Update
Updates follow the same structure as snapshot messages.
Fields
| Field | Type | Description |
|---|---|---|
filter | string | Market ID (e.g. "BTC-PERP") |
data.bid.px | string | Best bid price |
data.bid.sz | string | Best bid size |
data.ask.px | string | Best ask price |
data.ask.sz | string | Best ask size |
gsn | number | Global sequence number |
ts | string | Timestamp in nanoseconds |
Price level fields (px, sz) match the v1PriceLevel schema used in the REST Order Book response.