WebSocket Market Streams
Kline streams
Stream Description
Live candles are built from the tick stream as it arrives. Historical candles come from
GET /v1/klines, which is built from the trade
server's own bars.
Stream Name
<SYMBOL>@kline_<interval>
Intervals: 1m, 5m, 15m, 30m, 1h, 2h, 4h, 1d
Update Speed
on every tick that changes the candle, plus a final message when the candle closes.
Response Example
JSON
{"e":"kline","E":1789012345678,"s":"XAUUSD","k":{"t":1789012320000,"T":1789012379999,"s":"XAUUSD","i":"1m","o":"2331.02","c":"2331.15","h":"2331.40","l":"2330.95","v":38,"n":38,"x":false}}| Field | Type | Description |
|---|---|---|
e |
STRING | "kline" |
E |
LONG | Event time, Unix ms. |
s |
STRING | Symbol. |
k |
OBJECT | The candle. |
k.t |
LONG | Candle open time, Unix ms. |
k.T |
LONG | Candle close time (last ms of the interval), Unix ms. |
k.s |
STRING | Symbol. |
k.i |
STRING | Interval. |
k.o |
DECIMAL | Open. |
k.c |
DECIMAL | Close — the latest price while x is false. |
k.h |
DECIMAL | High. |
k.l |
DECIMAL | Low. |
k.v |
LONG | Tick volume: ticks counted in the candle so far. |
k.n |
LONG | Number of ticks. Identical to k.v — MT5's volume for most instruments is the tick count. Both are present for Binance shape compatibility. |
k.x |
BOOLEAN | true on the final message for a closed candle. |
Notes
- Prices are bid prices, matching MT5 chart convention.
- Real traded volume is not on this stream.
GET /v1/klinescarries it asrealVolume, and it is0on most forex and CFD symbols. - Candle buckets are aligned to the Unix epoch in UTC.
1dcandles open at 00:00 UTC, which is not the broker's trading day — the same caveat as the REST endpoint. - A candle whose interval sees no ticks is not emitted. Gaps are normal over weekends and closures.
- Candles only exist from the moment the service starts tracking the symbol. Backfill from
GET /v1/klinesand then switch to the stream; expect the first live candle after you subscribe to be partial.