> For the complete documentation index, see [llms.txt](https://docs.infoway.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infoway.io/websocket-api/subscribe-and-unsubscribe/trade-subscribe.md).

# 实时成交明细（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` - 停售股票（常规交易）