行情频道
描述
获取产品的最新成交价、买一价、卖一价和24小时交易量等信息。定时推送频率:100ms 至 300ms
请求示例
{
"op": "subscribe",
"args": [
{
"instType": "SPOT",
"channel": "ticker",
"instId": "ETHUSDT"
}
]
}
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
op | String | 是 | 操作,subscribe unsubscribe |
args | Array | List<Object> | 是 请求订阅的频道列表 |
> instType | String | 是 | 产品线类型, SPOT |
> channel | String | 是 | 频道名, ticker |
> instId | String | 是 | 产品id 例如:ETHUSDT |
订阅返回示例
{
"event": "subscribe",
"arg": {
"instType": "SPOT",
"channel": "ticker",
"instId": "ETHUSDT"
}
}
返回参数
返回字段 | 参数类型 | 字段说明 |
---|---|---|
event | String | 事件 |
arg | Object | 订阅的频道 |
> instType | String | 产品类型, SPOT |
> channel | String | 频道名, ticker |
> instId | String | 产品id 例如:ETHUSDT |
code | String | 错误码,错误时才会返回 |
msg | String | 错误消息 |
推送返回示例
{
"action": "snapshot",
"arg": {
"instType": "SPOT",
"channel": "ticker",
"instId": "ETHUSDT"
},
"data": [
{
"instId": "ETHUSDT",
"lastPr": "2200.10",
"open24h": "0.00",
"high24h": "0.00",
"low24h": "0.00",
"change24h": "0.00",
"bidPr": "1792",
"askPr": "2200.1",
"bidSz": "0.0084",
"askSz": "19740.8811",
"baseVolume": "0.0000",
"quoteVolume": "0.0000",
"openUtc": "0.00",
"changeUtc24h": "0",
"ts": "1695702438018"
}
],
"ts": 1695702438029
}
推送数据参数
返回字段 | 参数类型 | 字段说明 |
---|---|---|
arg | Object | 订阅成功的频道 |
> instType | String | 产品类型, SPOT |
> channel | String | 频道名, ticker |
> instId | String | 产品id 例如:ETHUSDT |
action | String | 推送数据动作: snapshot |
data | List<Object> | 订阅的数据 |
> instId | String | 产品id 例如:ETHUSDT |
>lastPr | String | 最新成交价 |
>askPr | String | 卖一价 |
>bidPr | String | 买一价 |
> open24h | String | 24小时开盘价 |
> high24h | String | 24小时最高价 |
> low24h | String | 24小时最低价 |
> baseVolume | String | 24小时成交量,以左币为单位 |
> quoteVolume | String | 24小时成交量,以右币为单位 |
> ts | String | 数据产生时间,Unix时间戳的毫秒数格式,如 1597026383085 |
openUtc | String | 零时区 开盘价 |
changeUtc24h | String | UTC0时涨跌幅, 0.01表示1% |
>bidSz | String | 买一量 |
>askSz | String | 卖一量 |
>change24h | String | 24小时涨跌幅, 0.01表示1% |