最新盘口(实时逐笔深度、Order Book)订阅
English / 中文
接口说明
该接口支持订阅产品的最新盘口(实时逐笔深度、Order Book)数据,不支持历史盘口和历史逐笔tick数据。
该接口特性:对于每一个websocket连接,每发送一次该请求,后台会默认覆盖上一次订阅请求(例如,如果您最初订阅了A、B、C这三只产品,想要追加订阅E、F、G,则需要重新发送一次A、B、C、E、F、G),订阅成功后会进行推送数据。
注意:
1、订阅一次成功后,不需要再频繁的发起订阅请求,要求每10秒发送一次心跳,接口就会实时推送数据,在30秒内如果没有收到心跳请求,就会认为超时,断开请求者的websocket连接
2、接入时,客户可增加断开自动重连的逻辑,确保因网络等原因断开可自动重连
3、以下是每类产品最大的盘口深度:
3.1 不活跃的产品存在小于下面列的最大档的情况,属于正常情况
3.2 存在单边深度是空的情况,例如股票涨停跌停时,单边盘口可能是空的
深度说明
最大1 档 (只有委托价,没有量)
最大5档
最大10档
最大1档
最大5档
接口限制
1、请务必阅读:Websocket限制说明
2、请务必阅读:错误码说明
接口地址
1、美股、港股、A股、大盘数据接口地址:
基本路径: /quote-stock-b-ws-api
完整URL: wss://quote.alltick.io/quote-stock-b-ws-api
2、外汇、贵金属、加密货币、原油、CFD指数、商品接口地址:
基本路径: /quote-b-ws-api
完整URL: wss://quote.alltick.io/quote-b-ws-api
请求示例
1、美股、港股、A股、大盘数据请求示例:
每次建立连接时,必须在URL中附加您的认证token,如下所示:
wss://quote.alltick.io/quote-stock-b-ws-api?token=您的token
连接成功后,您可以根据需要订阅特定的股票市场数据。详细的调用方法请参考下面的文档说明。
2、外汇、贵金属、加密货币、原油、CFD指数、商品请求示例:
每次建立连接时,必须在URL中附加您的认证token,如下所示:
wss://quote.alltick.io/quote-b-ws-api?token=您的token
连接成功后,您可以根据需要订阅特定的外汇、加密货币、贵金属、商品数据。详细的调用方法请参考下面的文档说明。
请求-协议号:22002
json定义
cmd_id
协议号
integer
是
最新盘口请求协议号固定:22002
seq_id
响应id
integer
是
订阅请求标识,响应回传(自定义,每次请求可重复)
trace
可追溯id
string
是
请求日志信息可追溯id(自定义,每次请求不可重复)
symbol_list
产品列表
array
是
具体格式见下面symbol定义
symbol定义
depth_level
深度层级
uint32
否
如果没有depth_level字段时,后台只会提供一层的报价,请求的层级大于实际报价层级,或者如果没有depth_level字段时,则后台按实际报价有多少层给多少层
数据结构(json)
{
"cmd_id":22002,
"seq_id":123,
"trace":"3baaa938-f92c-4a74-a228-fd49d5e2f8bc-1678419657806",
"data":{
"symbol_list": [
{
"code": "BTCUSDT",
"depth_level": 5
},
{
"code": "ETHUSDT",
"depth_level": 5
}
]
}
}
应答-协议号:22003
数据结构(json)
{
"ret":200,
"msg":"ok",
"cmd_id":22003,
"seq_id":123,
"trace":"3baaa938-f92c-4a74-a228-fd49d5e2f8bc-1678419657806",
"data":{
}
}
推送-协议号:22999
data定义
seq
报价序号
string
tick_time
报价时间戳
string
单位毫秒
bids
bid深度
string
见下面bids定义
asks
ask深度
string
见下面asks定义
bids定义
price
买一价,买盘价格
string
volume
买一量,买盘量
string
1、外汇、贵金属、CFD指数不提供volume 2、股票,加密货币数据均提供volume
asks定义
price
卖一价,卖盘价格
string
volume
卖一量,卖盘量
string
1、外汇、贵金属、CFD指数不提供volume 2、股票,加密货币数据均提供volume
数据结构(json)
{
"cmd_id":22999,
"data":{
"code": "HK-1288",
"seq": "1605509068000001",
"tick_time": "1605509068",
"bids": [
{
"price": "9.12",
"volume": "9.12"
}
],
"asks": [
{
"price": "147.12",
"volume": "147.12"
}
]
}
}
AllTick网站
最后更新于
这有帮助吗?