# 平台成交详情频道

### 描述

平台成交频道(taker订单)

实时推送

<div className="api-aligning">

```json title="请求示例"
{
    "op": "subscribe",
    "args": [
        {
            "instType": "USDT-FUTURES",
            "channel": "trade",
            "instId": "BTCUSDT"
        }
    ]
}
```

### 请求参数

| 参数名 | 参数类型 | 是否必须 | 描述                                                                                | 
| :---- | :---- | :---- |:----------------------------------------------------------------------------------|
| op | String | 是 | 操作, subscribe unsubscribe                                                         |
| args | List&lt;Object&gt; | 是 | 请求订阅的频道列表                                                                         |
| &gt; instType | String | 是 | 产品类型<br/>`USDT-FUTURES` U本位合约<br/>`COIN-FUTURES` 币本位合约<br/>`USDC-FUTURES` USDC合约  |
| &gt; channel | String | 是 | 频道名                                                                               |
| &gt; instId | String | 是 | 产品ID<br/>如：ETHUSDT                                                                |

</div>

<div className="api-br-10"></div>

<div className="api-aligning">

```json title="订阅返回示例"
{
    "event": "subscribe",
    "arg": {
        "instType": "USDT-FUTURES",
        "channel": "trade",
        "instId": "BTCUSDT"
    }
}
```

### 返回参数

| 返回字段 | 参数类型 | 字段说明                                                                              | 
| :---- | :---- |:----------------------------------------------------------------------------------|
| event | String | 事件                                                                                |
| arg | Object | 订阅的频道                                                                             |
| &gt; instType | String | 产品类型<br/>`USDT-FUTURES` U本位合约<br/>`COIN-FUTURES` 币本位合约<br/>`USDC-FUTURES` USDC合约  |
| &gt; channel | String | 频道名                                                                               |
| &gt; instId | String | 产品ID<br/>如：ETHUSDT                                                                |
| code | String | 错误码                                                                               |
| msg | String | 错误消息                                                                              |

</div>

<div className="api-br-10"></div>

<div className="api-aligning">

```json title="推送返回示例"
{
    "action": "snapshot",
    "arg": {
        "instType": "USDT-FUTURES",
        "channel": "trade",
        "instId": "BTCUSDT"
    },
    "data": [
        {
            "ts": "1695716760565",
            "price": "27000.5",
            "size": "0.001",
            "side": "buy",
            "tradeId": "1111111111"
        },
        {
            "ts": "1695716759514",
            "price": "27000.0",
            "size": "0.001",
            "side": "sell",
            "tradeId": "1111111111"
        }
    ],
    "ts": 1695716761589
}
```

### 推送数据参数

| 返回字段          | 参数类型               | 字段说明                                                                             | 
|:--------------|:-------------------|:---------------------------------------------------------------------------------|
| action        | String             | 推送动作                                                                             |
| arg           | Object             | 订阅成功的频道                                                                          |
| &gt; instType | String             | 产品类型<br/>`USDT-FUTURES` U本位合约<br/>`COIN-FUTURES` 币本位合约<br/>`USDC-FUTURES` USDC合约 |
| &gt; channel  | String             | 频道名                                                                              |
| &gt; instId   | String             | 产品ID, 如：ETHUSDT                                                                  |
| data          | List&lt;Object&gt; | 订阅的数据                                                                            |
| &gt; ts       | String             | 成交时间，Unix时间戳的毫秒数格式，如 1597026383085                                               |
| &gt; price    | String             | 成交价格                                                                             |
| &gt; size     | String             | 成交数量                                                                             |
| &gt; side     | String             | 成交方向, sell/buy                                                                   |
| &gt; tradeId  | String             | 成交id                                                                             |
| ts            | String             | 数据推送时间                                                                           |

</div>