跳到主要内容

K线频道

描述

获取产品的K线数据

首次订阅后,会先全量(snapshot)推送最近数据,然后推送增量数据(update)

请求示例
{
"op": "subscribe",
"args": [
{
"instType": "SPOT",
"channel": "candle1m",
"instId": "ETHUSDT"
}
]
}

请求参数

参数名参数类型是否必须描述
opString操作,subscribe unsubscribe
argsList<Object>请求订阅的频道列表
> instTypeString产品线类型, SPOT
> channelString频道名,candle1m,candle5m 5分钟,candle15m 15分钟,candle30m 30分钟,candle1H 1小时,candle4H 4小时,candle6H 6小时,candle12H 12小时
,candle1D 1天,candle3D 3天.candle1W 1周,candle1M 1月线,candle6Hutc 零时区 6小时线,candle12Hutc 零时区12小时线,candle1Dutc 零时区 1日线
,candle3Dutc 零时区 3日线,candle1Wutc 零时区 周线,candle1Mutc 零时区 月线
> instIdString产品id 例如:ETHUSDT
订阅返回示例
{
"event": "subscribe",
"arg": {
"instType": "SPOT",
"channel": "candle1m",
"instId": "ETHUSDT"
}
}

返回参数

返回字段参数类型字段说明
eventString事件,subscribe unsubscribe error
argObject订阅的频道
> instTypeString产品类型
> channelString频道名,candle1m,candle5m 5分钟,candle15m 15分钟,candle30m 30分钟,candle1H 1小时,candle4H 4小时,candle6H 6小时,candle12H 12小时
,candle1D 1天,candle3D 3天.candle1W 1周,candle1M 1月线,candle6Hutc 零时区 6小时线,candle12Hutc 零时区12小时线,candle1Dutc 零时区 1日线
,candle3Dutc 零时区 3日线,candle1Wutc 零时区 周线,candle1Mutc 零时区 月线
> instIdString
产品id 例如:ETHUSDT
codeString错误码,错误时才会返回
msgString错误消息
推送返回示例
{
"action": "snapshot",
"arg": {
"instType": "SPOT",
"channel": "candle1m",
"instId": "ETHUSDT"
},
"data": [
[
"1695672780000",
"2200.1",
"2200.1",
"2200.1",
"2200.1",
"0",
"0",
"0"
]
],
"ts": 1695702747821
}

推送数据参数

返回字段参数类型字段说明
actionString推送数据动作, snapshot or update
argObject订阅频道
> channelString频道名
> instTypeString产品类型
> instIdString产品id 例如:ETHUSDT
dataList<String>订阅的数据
> index[0]String开始时间,Unix时间戳的毫秒数格式,如 1597026383085
> index[1]String开盘价格
> index[2]String最高价格
> index[3]String最低价格
> index[4]String收盘价格
> index[5]String交易币成交量
> index[6]String计价币成交量
> index[7]Stringusdt交易量
> index[7]String折合USDT量

您的阅读体验如何?