跳转到主要内容

​
接口说明

该接口支持订阅产品的最新盘口(实时逐笔深度、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 存在单边深度是空的情况，例如股票涨停跌停时，单边盘口可能是空的
外汇、贵金属、原油加密货币港股美股沪深A股
深度说明最大1 档最大5档最大10档最大1档最大5档

​
接口限制

1、请务必阅读：Websocket限制说明 2、请务必阅读：错误码说明

​
接口地址

1、美股、港股、A股、大盘数据接口地址：
  • 基本路径: /quote-stock-b-ws-api
  • 完整URL: wss://quote.alltick.co/quote-stock-b-ws-api
2、外汇、贵金属、加密货币、原油、CFD指数、商品接口地址：
  • 基本路径: /quote-b-ws-api
  • 完整URL: wss://quote.alltick.co/quote-b-ws-api

​
请求示例

1、美股、港股、A股、大盘数据请求示例： 每次建立连接时，必须在URL中附加您的认证token，如下所示： wss://quote.alltick.co/quote-stock-b-ws-api?token=您的token 连接成功后，您可以根据需要订阅特定的股票市场数据。详细的调用方法请参考下面的文档说明。 2、外汇、贵金属、加密货币、原油、CFD指数、商品请求示例： 每次建立连接时，必须在URL中附加您的认证token，如下所示： wss://quote.alltick.co/quote-b-ws-api?token=您的token 连接成功后，您可以根据需要订阅特定的外汇、加密货币、贵金属、商品数据。详细的调用方法请参考下面的文档说明。

​
请求-协议号：22002

​
json定义

字段名称类型必填项说明
cmd_id协议号integer是最新盘口请求协议号固定：22002
seq_id响应idinteger是订阅请求标识，响应回传(自定义，每次请求可重复)
trace可追溯idstring是请求日志信息可追溯id(自定义，每次请求不可重复)
symbol_list产品列表array是具体格式见下面symbol定义

​
symbol定义

字段名称类型必填项说明
code代码string是具体内容，请查阅code列表：点击code列表
注意：code值大小写要与产品列表中的code保持一致
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定义

字段名称类型说明
code代码string具体内容，请查阅code列表：点击code列表
seq报价序号integer
tick_time报价时间戳integer单位毫秒
bidsbid深度string见下面bids定义
asksask深度string见下面asks定义

​
bids定义

字段名称类型说明
price买一价，买盘价格string
volume买一量，买盘量string1、部分CFD指数不提供volume
2、外汇、贵金属、能源、股票，加密货币数据均提供volume

​
asks定义

字段名称类型说明
price卖一价，卖盘价格string
volume卖一量，卖盘量string1、部分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网站

官方网站：https://alltick.co/