集合竞价信息频道
描述
获取产品的集合竞价信息。定时推送频率:100ms 至 300ms
请求示例
{
"op": "subscribe",
"args": [
{
"instType": "SPOT",
"channel": "auction",
"instId": "BTCUSDT"
}
]
}
请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| op | String | 是 | 操作,subscribe unsubscribe |
| args | List<Object> | 是 | 请求订阅的频道列表 |
| > instType | String | 是 | 产品线类型 |
| > channel | String | 是 | 频道名: auction |
| > instId | String | 是 | 产品id 例如:BTCUSDT |
订阅返回示例
{
"event": "subscribe",
"arg": {
"instType": "SPOT",
"channel": "auction",
"instId": "BTCUSDT"
}
}
返回参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| event | String | 事件,subscribe unsubscribe error |
| arg | Object | 订阅的频道 |
| > instType | String | 产品类型 |
| > channel | String | 频道名 |
| > instId | String | 是 产品id 例如:BTCUSDT |
| code | String | 错误码,错误时才会返回 |
| msg | String | 错误消息 |
推送返回示例
{
"action": "snapshot",
"arg": {
"instType": "SPOT",
"channel": "auction",
"instId": "BTCUSDT"
},
"data": [
{
"stage": "stage_1",
"stageEndTime": "1728876900000",
"estOpeningPrice": null,
"matchedVolume": null,
"auctionEndTime": "1728877500000"
}
],
"ts": 1695711090682
}
推送数据参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| arg | Object | 订阅成功的频道 |
| > instType | String | 产品类型 |
| > channel | String | 频道名 |
| > instId | String | 产品id 例如:ETHUSDT |
| action | String | 推送数据动作, snapshot or update |
| data | List<Object> | 订阅的数据 |
| > stage | String | 集合竞价阶段pre_market 盘前stage_1 第一阶段stage_2 第二阶段stage_3 第三阶段success 竞价成功failure 竞价失败 |
| > stageEndTime | String | 当前阶段结束时间 Unix毫秒时间戳 |
| > estOpeningPrice | String | 预估开盘价 |
| > matchedVolume | String | 撮合量 单位为集合竞价币种 |
| > auctionEndTime | String | 集合竞价结束时间 |