最新成交价(实时逐笔Tick数据、当前价、最新价)批量订阅
English / 中文
接口说明
该接口支持批量订阅产品的最新成交价(实时逐笔Tick数据,也是当前价、最新价),不支持历史成交价格(历史逐笔tick数据)。
该接口特性为对于每一个websocket连接,每发送一次该请求,后台会默认覆盖上一次订阅请求(例如,如果您最初订阅了A、B、C这三只产品,想要追加订阅E、F、G,则需要重新发送一次A、B、C、E、F、G),订阅成功后会进行推送数据。
注意:
1、订阅一次成功后,不需要再频繁的发起订阅请求,要求每10秒发送一次心跳,接口就会实时推送数据,在30秒内如果没有收到心跳请求,就会认为超时,断开请求者的websocket连接
2、接入时,客户可增加断开自动重连的逻辑,确保因网络等原因断开可自动重连
接口限制
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
连接成功后,您可以根据需要订阅特定的外汇、加密货币、贵金属、商品数据。详细的调用方法请参考下面的文档说明。
请求-协议号:22004
json定义
cmd_id
协议号
integer
是
逐笔订阅请求协议号固定:22004
seq_id
响应id
integer
是
订阅请求标识,响应回传(自定义,每次请求可重复)
trace
可追溯id
string
是
请求日志信息可追溯id(自定义,每次请求不可重复)
symbol_list
产品列表
array
是
具体格式见下面symbol定义
symbol定义
数据结构(json)
{
"cmd_id":22004,
"seq_id":123,
"trace":"3baaa938-f92c-4a74-a228-fd49d5e2f8bc-1678419657806",
"data":{
"symbol_list": [
{
"code": "BTCUSDT"
},
{
"code": "ETHUSDT"
}
]
}
}
应答-协议号:22005
数据结构(json)
{
"ret":200,
"msg":"ok",
"cmd_id":22005,
"seq_id":123,
"trace":"3baaa938-f92c-4a74-a228-fd49d5e2f8bc-1678419657806",
"data":{
}
}
推送-协议号:22998
data定义
seq
报价序号
string
tick_time
报价时间戳
string
单位毫秒
price
成交价
string
最新成交价
volumn
成交量
string
最新一口成交价对应的成交量
turnover
成交额
string
成交额: 1、外汇、贵金属、能源不返回成交额,可自行根据每次推送的数据计算,计算公式:turnover = price * volume 2、股票、加密货币正常返回成交额。
trade_direction
成交方向
string
交易方向: 1、0为默认值,1为Buy,2为SELL 2、外汇、贵金属、能源默认只会返回0 3、股票、加密货币根据市场情况会返回0、1、2 4、详细说明: 0:表示中性盘,即以买一价与卖一价之间的价格撮合成交。 1:表示主动买入,即以卖一价或者更高价格成交的股票 2:表示主动卖出,即以买一价或者更低价格成交的股票
数据结构(json)
{
"cmd_id":22998,
"data":{
"code": "1288.HK",
"seq": "1605509068000001",
"tick_time": "1605509068",
"price": "651.12",
"volume": "300",
"turnover": "12345.6",
"trade_direction": 1
}
}
AllTick网站
最后更新于
这有帮助吗?