# Fast Fill Channel

### Description

This channel only pushes order fill data for users in UTA mode.<br/>
This channel does not currently push strategy and copy trading fill data.

For Reality (rtoken) orders, this channel now pushes fills executed both onshore (internal) and offshore (external). Previously, only onshore fills were pushed.

Push rules:
1. No push on first-time subscription
2. Push when spot/leveraged/futures orders are filled in the unified trading account

<div className="api-aligning">

```json title="Request Example"
{
    "op": "subscribe",
    "args": [
        {
            "instType": "UTA",
            "topic": "fast-fill",
            "symbol": "default"
        }
    ]
}
```

### Request Parameters


| Parameters    |  Type         | Required | Description                                    |
|:--------------|:-----------------------|:---------|:-----------------------------------------------|
| op            | String                 | Yes      | Operation: <br/> `subscribe` /`unsubscribe`    |
| args          | List&lt;Object&gt;     | Yes      | Subscribed channel list                        |
| &gt; instType | String                 | Yes      | Product type<br/>`UTA` Unified trading account |
| &gt; topic    | String                 | Yes      | Topic <br/>`fast-fill` Fast fill               |
| &gt; symbol   | String                 | No       | Symbol name<br/>`default` All symbols          |

</div>

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

<div className="api-aligning">

```json title="Response Example"
{
    "event": "subscribe",
    "arg": {
        "instType": "UTA",
        "topic": "fast-fill"
    },
    "connId": "xxxxxxxxxx"
}
```
### Response Parameters

| Parameters    |  Type   | Description                                            | 
|:-----------------|:-----------------|:-------------------------------------------------------|
| event            | String           | Operation <br/>`subscribe` / `unsubscribe` / `error`   |
| arg              | Object           | Subscribed channel                                     |
| &gt; instType    | String           | Product type <br/>`UTA` Unified trading account        |
| &gt; topic       | String           | Topic <br/>`fast-fill` Fast fill                       |
| code             | String           | Error code                                             |
| msg              | String           | Error message                                          |
| connId           | String           | Connection ID                                          |


</div>

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


<div className="api-aligning">

```json title="Push Data"
{
  "data":
    {
      "symbol": "BTCUSDT",
      "updatedTime": "1736378720623",
      "side": "buy",
      "orderId": "1288888888888888888",
      "execTime": "1736378720623",
      "tradeScope": "taker",
      "execId": "1288888888888888888",
      "execPrice": "94993",
      "holdSide": "long",
      "category": "usdt-futures",
      "execQty": "0.01",
      "clientOid": "1288888888888888889"
    },
  "arg": {
    "instType": "UTA",
    "topic": "fast-fill"
  },
  "action": "update",
  "ts": 1736378720653
}
```



### Push Parameters

| Parameters         | Type   | Description                                                                                                                                                                   | Remarks |
|:-------------------|:-------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------|
| arg                | Object | Subscribed channel                                                                                                                                                            |         |
| &gt; instType      | String | Product type <br/>`UTA` Unified trading account                                                                                                                               |         |
| &gt; topic         | String | Topic <br/>`fast-fill` Fast fill                                                                                                                                              |         |
| action             | String | Push data action<br/>`update` Incremental                                                                                                                                     |         |
| data               | Object  | Subscribed data                                                                                                                                                               |         |
| &gt; category      | String | Business line <br/> `spot` Spot trading <br/> `margin` Margin trading <br/> `usdt-futures` USDT futures <br/> `coin-futures` Coin-M futures <br/> `usdc-futures` USDC futures |         |
| &gt; orderId       | String | Order ID                                                                                                                                                                      |         |
| &gt; clientOid     | String | Client Order ID                                                                                                                                                               |         |
| &gt; symbol        | String | Symbol name                                                                                                                                                                   |         |
| &gt; execId        | String | Fill ID                                                                                                                                                                       |         |
| &gt; side          | String | Trade side<br/>`buy` Buy<br/>`sell` Sell                                                                                                                                      |         |
| &gt; holdSide      | String | Position direction <br/>`long` Long <br/>`short` Short                                                                                                                        |         |
| &gt; execPrice     | String | Fill price                                                                                                                                                                    |         |
| &gt; execQty       | String | Fill quantity                                                                                                                                                                 |         |
| &gt; tradeScope    | String | Trade scope<br/>`taker` Taker<br/>`maker` Maker                                                                                                                               |         |
| &gt; execTime      | String | Execution timestamp <br/>A Unix timestamp in milliseconds. e.g.,`1622697148123`                                                                                               |         |
| &gt; updatedTime   | String | Updated timestamp<br/>A Unix timestamp in milliseconds. e.g.,`1622697148123`                                                                                                  |         |



</div>