# 实时成交明细（Trade）订阅

## API说明

该Websocket是获取成交明细的实时推送            

## 请求频率

同一个Websocket连接，所有的请求（订阅、取消订阅、心跳）限制为**1分钟60次**，如果超出请求频率限制将会自动断连。如果断连次数过多被系统判定为恶意请求将会封禁apikey。请在使用过程中注意调用逻辑。

## 错误码说明

参考[Websocket错误码说明](/getting-started/error-codes/websocket.md)

## 接口地址

请参考[Websocket订阅地址](/websocket-api/endpoints.md)

## 请求数量

不同的套餐对应的单Websocket订阅的产品数量不一样，具体参考[Websocket限制说明](/getting-started/api-limitation/websocket.md)

## 请求（协议号：10000）

```json
{
    "code": 10000,
    "trace": "423afec425004bd8a5e02e1ba5f9b2b0",
    "data": {
        "codes": "BTCUSDT",
        "includeTy": false
    }
}
```

| 参数名          | 类型      | 必填 | 描述                                        | 示例值                                |
| ------------ | ------- | -- | ----------------------------------------- | ---------------------------------- |
| `code`       | Integer | 是  | 请求的协议号                                    | 实时成交明细订阅协议号：`10000`                |
| `trace`      | String  | 是  | 可追溯ID（随机字符串）                              | `423afec425004bd8a5e02e1ba5f9b2b0` |
| `data`       | JSON    | 是  | 订阅数据                                      |                                    |
| `<codes`     | String  | 是  | 订阅产品，多个用逗号分隔（一个websocket连接支持同时订阅最多600个产品） | `BTCUSDT`                          |
| `<includeTy` | Boolean | 否  | 是否推送trade类型。不传或者传false不推送                 | false                              |

## 应答（协议号：10001）

```json
{
    "code": 10001,
    "trace": "423afec425004bd8a5e02e1ba5f9b2b0",
    "msg": "ok"
}
```

| 字段名     | 类型      | 必填 | 描述          | 示例值                                |
| ------- | ------- | -- | ----------- | ---------------------------------- |
| `code`  | Integer | 是  | 响应协议号       | 订阅实时成交明细响应协议号：`10001`              |
| `trace` | String  | 是  | 订阅传入参数可追溯id | `423afec425004bd8a5e02e1ba5f9b2b0` |
| `msg`   | String  | 是  | 响应          | `ok`                               |

## 推送（协议号：10002）

```json
{
    "code": 10002,
    "data": {
        "p": "103482.94",
        "s": "BTCUSDT",
        "t": 1747552358393,
        "td": 2,
        "v": "0.00096",
        "vw": "99.3436224"
    }
}
```

| 字段名    | 类型      | 必填 | 描述       | 示例值                       |
| ------ | ------- | -- | -------- | ------------------------- |
| `code` | Integer | 是  | 推送协议号    | 实时成交明细推送协议号：`10002`       |
| `data` | JSON    | 是  | 推送数据实体   |                           |
| `<s`   | String  | 是  | 标的名称     | `BTCUSDT`                 |
| `<p`   | String  | 是  | 当前价格     | `103482.94`               |
| `<t`   | Long    | 是  | Trade时间戳 | `1747552358393`           |
| `<td`  | Integer | 是  | 交易方向     | `交易方向：0为默认值，1为Buy，2为SELL` |
| `<v`   | String  | 是  | 成交量      | `0.00096`                 |
| `<vw`  | String  | 是  | 成交额      | `99.3436224`              |
| `<tp`  | String  | 否  | 交易类型     | 参考下面交易类型说明                |

**交易类型**

港股

* `*` - 场外交易
* `D` - 碎股交易
* `M` - 非自动对盘
* `P` - 开市前成交盘
* `U` - 竞价交易
* `X` - 同一券商非自动对盘
* `Y` - 同一券商自动对盘
* \- 自动对盘

美股

* \- 自动对盘
* `A` - 收购
* `B` - 批量交易
* `D` - 分配
* `F` - 跨市扫盘单
* `G` - 批量卖出
* `H` - 离价交易
* `I` - 碎股交易
* `K` - 第 155 条交易（纽交所规则）
* `M` - 交易所收盘价
* `P` - 前参考价
* `Q` - 交易所开盘价
* `S` - 拆单交易
* `V` - 附属交易
* `W` - 平均价成交
* `X` - 跨市场交易
* `1` - 停售股票（常规交易）


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.infoway.io/websocket-api/subscribe-and-unsubscribe/trade-subscribe.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.