# 成交明细

推送规则：首次订阅不推送，订单发生成交时推送

### 描述

订阅成交明细信息

推送规则：首次订阅不推送，订单发生成交时推送

<div className="api-aligning">

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

### 请求参数

| 参数名 | 参数类型 | 是否必须 | 描述                                                                          | 
| :---- | :---- |:-----|:----------------------------------------------------------------------------|
| op | String | 是    | 操作, subscribe unsubscribe                                                   |
| args | List&lt;Object&gt; | 是    | 请求订阅的频道列表                                                                   |
| &gt; channel | String | 是    | 频道名                                                                         |
| &gt; instType | String | 是    | 产品类型                                                                        |
| &gt; instId | String | 否    | 产品名或default，交割合约参考：https://www.bitget.com/zh-CN/api-doc/common/release-note |

</div>

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

<div className="api-aligning">

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

### 返回参数

| 返回字段 | 参数类型 | 字段说明        | 
| :---- | :---- |:------------|
| event | String | 事件          |
| arg | Object | 订阅的频道       |
| &gt; channel | String | 频道名         |
| &gt; instType | String | 产品类型        |
| &gt; instId | String | 产品名或default |
| code | String | 错误码，错误时才会返回 |
| msg | String | 错误消息        |

</div>

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

<div className="api-aligning">

```json title="推送返回示例"
{
    "action":"snapshot",
    "arg":{
        "instType":"USDT-FUTURES",
        "channel":"fill",
        "instId":"default"
    },
    "data":[
        {
            "orderId":"111",
            "clientOid":"111",
            "tradeId":"222",
            "symbol":"BTCUSDT",
            "side":"buy",
            "orderType":"market",
            "posMode":"one_way_mode",
            "price":"51000.5",
            "baseVolume":"0.01",
            "quoteVolume":"510.005",
            "profit":"0",
            "tradeSide":"open",
            "tradeScope":"taker",
            "feeDetail":[
                {
                    "feeCoin":"USDT",
                    "deduction":"no",
                    "totalDeductionFee":"0",
                    "totalFee":"-0.183717"
                }
            ],
            "cTime":"1703577336606",
            "uTime":"1703577336606"
        }
    ],
    "ts":1703577336700
}
```

### 推送数据参数

| 返回字段                                   | 参数类型               | 字段说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 
|:---------------------------------------|:-------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| action                                 | String             | 推送动作, 'snapshot'                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| arg                                    | Object             | 订阅成功的频道                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| &gt; channel                           | String             | 频道名                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| &gt; instType                          | String             | 产品类型<br/>`USDT-FUTURES` U本位合约<br/>`COIN-FUTURES` 币本位合约<br/>`USDC-FUTURES` USDC合约                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| &gt; instId                            | String             | 产品ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| data                                   | List&lt;Object&gt; | 订阅的数据                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| &gt; orderId                           | String             | 订单ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| &gt; clientOid                         | String             | 自定义订单ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| &gt; tradeId                           | String             | 成交ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| &gt; symbol                            | String             | 交易对名称                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| &gt; side                              | String             | 买卖方向<br/>`buy`: 买<br/>`sell`: 卖<br/>**注**：对于此频道，双向持仓下, **开多、平空**时为`buy`, **开空，平多**时为`sell`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| &gt; orderType                         | String             | 订单类型<br/>`limit ` 限价单<br/>`market` 市价单                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| &gt; posMode                           | String             | 持仓模式<br/>`one_way_mode` 单向持仓<br/>`hedge_mode` 双向持仓                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| &gt; price                             | String             | 成交价格                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| &gt; baseVolume                        | String             | 基础币成交额                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| &gt; quoteVolume                       | String             | 计价币成交额                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| &gt; profit                            | String             | 盈利                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| &gt; tradeSide                         | String             | 交易类型<br/>`open` 开（开平仓模式）<br/>`close` 平（开平仓模式）<br/>`reduce_close_long` 双向持仓强制减多<br/>`reduce_close_short` 双向持仓强制减空<br/>`offset_close_long` 双向持仓轧差强制减多<br/>`offset_close_short` 双向持仓轧差强制减空<br/>`burst_close_long` 双向持仓爆仓平多<br/>`burst_close_short` 双向持仓爆仓平空<br/>`delivery_close_long` 双向持仓多头交割<br/>`delivery_close_short` 双向持仓空头交割<br/>`dte_sys_adl_close_long` 双向持仓ADL减多仓<br/>`dte_sys_adl_close_short` 双向持仓ADL减空仓<br/>`buy_single` 单向持仓买<br/>`sell_single` 单向持仓卖<br/>`reduce_buy_single` 单向持仓强制减仓买<br/>`reduce_sell_single` 单向持仓强制减仓卖<br/>`burst_buy_single` 单向持仓爆仓买<br/>`burst_sell_single` 单向持仓爆仓卖<br/>`delivery_sell_single` 单向持仓交割卖<br/>`delivery_buy_single` 单向持仓交割买<br/>`dte_sys_adl_buy_in_single_side_mode` 单向持仓ADL减仓买<br/>`dte_sys_adl_sell_in_single_side_mode` 单向持仓ADL减仓卖 |
| &gt; tradeScope                        | String             | 交易者标识<br/>`taker`: 吃单方<br/>`maker`: 挂单方                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| &gt; feeDetail                         | List&lt;Object&gt;             | 手续费明细                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| &nbsp;&nbsp;&gt;&gt; deduction         | String            | 是否折扣                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| &nbsp;&nbsp;&gt;&gt; totalDeductionFee | String             | 折扣手续费                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| &nbsp;&nbsp;&gt;&gt; totalFee          | String             | 总手续费                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| &nbsp;&nbsp;&gt;&gt; feeCoin           | String             | 手续费币种                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| &gt; cTime                             | String             | 创建时间，Unix时间戳的毫秒数格式，如 1597026383085                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| &gt; uTime                             | String             | 更新时间，Unix时间戳的毫秒数格式，如 1597026383085                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

</div>
