> ## Documentation Index
> Fetch the complete documentation index at: https://alltick.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 最新成交价(实时逐笔Tick数据、当前价、最新价)批量订阅

> 该接口支持批量订阅产品的最新成交价(实时逐笔Tick数据，也是当前价、最新价)，不支持历史成交价格(历史逐笔tick数据)。

## 接口说明

该接口支持批量订阅产品的最新成交价(实时逐笔Tick数据，也是当前价、最新价)，不支持历史成交价格(历史逐笔tick数据)。

该接口特性为对于每一个websocket连接，每发送一次该请求，后台会默认覆盖上一次订阅请求（例如，如果您最初订阅了A、B、C这三只产品，想要追加订阅E、F、G，则需要重新发送一次A、B、C、E、F、G），订阅成功后会进行推送数据。

注意：

1、订阅一次成功后，不需要再频繁的发起订阅请求，要求每10秒发送一次心跳，接口就会实时推送数据，在30秒内如果没有收到心跳请求，就会认为超时，断开请求者的websocket连接

2、接入时，客户可增加断开自动重连的逻辑，确保因网络等原因断开可自动重连

## 接口限制

1、请务必阅读：[Websocket限制说明](/zh/getting-started/websocket-interface-limitations)

2、请务必阅读：[错误码说明](/zh/getting-started/error-code-description)

## 接口地址

**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

连接成功后，您可以根据需要订阅特定的外汇、加密货币、贵金属、商品数据。详细的调用方法请参考下面的文档说明。

## 请求-协议号：22004

#### json定义

| 字段           | 名称    | 类型      | 必填项 | 说明                        |
| ------------ | ----- | ------- | --- | ------------------------- |
| cmd\_id      | 协议号   | integer | 是   | 逐笔订阅请求协议号固定：22004         |
| seq\_id      | 响应id  | integer | 是   | 订阅请求标识，响应回传(自定义，每次请求可重复)  |
| trace        | 可追溯id | string  | 是   | 请求日志信息可追溯id(自定义，每次请求不可重复) |
| symbol\_list | 产品列表  | array   | 是   | 具体格式见下面symbol定义           |

#### symbol定义

| 字段   | 名称 | 类型     | 必填项 | 说明                                                                                                                                                                                                                     |
| ---- | -- | ------ | --- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | 代码 | string | 是   | 具体内容，请查阅code列表：[点击code列表](https://docs.google.com/spreadsheets/d/1avkeR1heZSj6gXIkDeBt8X3nv4EzJetw4yFuKjSDYtA/edit?gid=495387863#gid=495387863)<br /><span style={{ color: 'red' }}>注意：code值大小写要与产品列表中的code保持一致</span> |

### 数据结构(json)

```json theme={null}
{
    "cmd_id":22004,
    "seq_id":123,
    "trace":"3baaa938-f92c-4a74-a228-fd49d5e2f8bc-1678419657806",
    "data":{
        "symbol_list": [
            {
                "code": "BTCUSDT"
            },
            {
                "code": "ETHUSDT"
            }
        ]
    }
}
```

## 应答-协议号：22005

### 数据结构(json)

```json theme={null}
{
    "ret":200,
    "msg":"ok",
    "cmd_id":22005,
    "seq_id":123,
    "trace":"3baaa938-f92c-4a74-a228-fd49d5e2f8bc-1678419657806",
    "data":{
    }    
}
```

## 推送-协议号：22998

#### data定义

| 字段               | 名称    | 类型      | 说明                                                                                                                                                                                               |
| ---------------- | ----- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| code             | 代码    | string  | 具体内容，请查阅code列表：[点击code列表](https://docs.google.com/spreadsheets/d/1avkeR1heZSj6gXIkDeBt8X3nv4EzJetw4yFuKjSDYtA/edit?gid=495387863#gid=495387863)                                                  |
| seq              | 报价序号  | integer |                                                                                                                                                                                                  |
| tick\_time       | 报价时间戳 | integer | 单位毫秒                                                                                                                                                                                             |
| price            | 成交价   | string  | 最新成交价                                                                                                                                                                                            |
| volume           | 成交量   | string  | 最新一口成交价对应的成交量                                                                                                                                                                                    |
| turnover         | 成交额   | string  | 成交额                                                                                                                                                                                              |
| trade\_direction | 成交方向  | string  | 交易方向：<br />1、0为默认值，1为Buy，2为SELL<br />2、外汇、贵金属、能源默认只会返回1<br />3、股票、加密货币根据市场情况会返回0、1、2<br />4、详细说明：<br />0:表示中性盘，即以买一价与卖一价之间的价格撮合成交。<br />1:表示主动买入，即以卖一价或者更高价格成交的股票<br />2:表示主动卖出，即以买一价或者更低价格成交的股票 |

### 数据结构（json）

```json theme={null}
{
    "cmd_id":22998,
    "data":{
	"code": "1288.HK",
        "seq": 1782180168224,
        "tick_time": 1782180164000,
        "price": "651.12",
        "volume": "300",
        "turnover": "12345.6",
        "trade_direction": 1
    }
}
```

#### AllTick网站

<Note>
  官方网站：<a href="https://alltick.co/">[https://alltick.co/](https://alltick.co/)</a>
</Note>

<script src="/seo-keywords.js" />