K线频道
描述
获取产品的K线数据
首次订阅后,会先全量(snapshot)推送最近数据,然后推送增量数据(update)
请求示例
{
"op": "subscribe",
"args": [
{
"instType": "SPOT",
"channel": "candle1m",
"instId": "ETHUSDT"
}
]
}
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
op | String | 是 | 操作,subscribe unsubscribe |
args | List<Object> | 是 | 请求订阅的频道列表 |
> instType | String | 是 | 产品线类型, SPOT |
> channel | String | 是 | 频道名,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 零时区 月线 |
> instId | String | 是 | 产品id 例如:ETHUSDT |
订阅返回示例
{
"event": "subscribe",
"arg": {
"instType": "SPOT",
"channel": "candle1m",
"instId": "ETHUSDT"
}
}
返回参数
返回字段 | 参数类型 | 字段说明 |
---|---|---|
event | String | 事件,subscribe unsubscribe error |
arg | Object | 订阅的频道 |
> instType | String | 产品类型 |
> channel | String | 频道名,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 零时区 月线 |
> instId | String | 是 产品id 例如:ETHUSDT |
code | String | 错误码,错误时才会返回 |
msg | String | 错误消息 |
推送返回示例
{
"action": "snapshot",
"arg": {
"instType": "SPOT",
"channel": "candle1m",
"instId": "ETHUSDT"
},
"data": [
[
"1695672780000",
"2200.1",
"2200.1",
"2200.1",
"2200.1",
"0",
"0",
"0"
]
],
"ts": 1695702747821
}
推送数据参数
返回字段 | 参数类型 | 字段说明 |
---|---|---|
action | String | 推送数据动作, snapshot or update |
arg | Object | 订阅频道 |
> channel | String | 频道名 |
> instType | String | 产品类型 |
> instId | String | 产品id 例如:ETHUSDT |
data | List<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] | String | usdt交易量 |
> index[7] | String | 折合USDT量 |