Skip to main content
Version: Next

K-Line Subscription

Subscribe to real-time K-line data push for futures.

Subscription Format

{symbol}@kline_{interval} (e.g.: BTCUSD@kline_1m)

Supported Time Intervals

1m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1mo

Subscribe Request

Can subscribe to multiple pairs and intervals simultaneously

{
"action": "subscribe",
"streams": [
"BTCUSD@kline_1m",
"ETHUSD@kline_5m"
]
}

Push Data Fields

FieldTypeDescription
eventstringEvent type: data
channelstringChannel: kline
data.symbolstringContract symbol
data.intervalstringK-line interval
data.tint64K-line opening time (milliseconds)
data.ostringOpen price
data.hstringHigh price
data.lstringLow price
data.cstringClose price (latest price of current K-line)
data.vstringVolume
data.isClosedboolIs K-line closed (true=closed, false=in progress)
timeint64Push timestamp (milliseconds)

Push Example

{
"event": "data",
"channel": "kline",
"data": {
"symbol": "BTCUSD",
"interval": "1m",
"t": 1736163000000,
"o": "50000.00",
"h": "50150.00",
"l": "49980.00",
"c": "50120.00",
"v": "1000000",
"isClosed": false
},
"time": 1736163000000
}

Unsubscribe

{
"action": "unsubscribe",
"streams": ["BTCUSD@kline_1m"]
}