# Fill Channel
### Description
Push real-time fill data.
Push rules:
1. No push on first-time subscription
2. Push when spot/leveraged/futures orders are filled
```json title="Request Example"
{
"op": "subscribe",
"args": [
{
"instType": "UTA",
"topic": "fill"
}
]
}
```
### Request Parameters
| Parameters | Type | Description |
|:--------------|:-----------------------|:-----------------------------------------------|
| op | String | Operation:
`subscribe` /`unsubscribe` |
| args | List<Object> | Subscribed channel |
| > instType | String | Product type
`UTA` Unified trading account |
| > topic | String | Topic
`fill` |
```json title="Response Example"
{
"event": "subscribe",
"arg": {
"instType": "UTA",
"topic": "fill"
},
"connId": "xxxxxxxxxx"
}
```
### Response Parameters
| Parameters | Type | Description |
|:-----------------|:-----------------|:-------------------------------------------------------|
| event | String | Operation
`subscribe` / `unsubscribe` / `error` |
| arg | Object | Subscribed channel |
| > instType | String | Product type
`UTA` |
| > topic | String | Topic
`fill` |
| code | String | Error code |
| msg | String | Error message |
| connId | String | Connection ID |
```json title="Push Data"
{
"data": [
{
"symbol": "BTCUSDT",
"orderType": "market",
"updatedTime": "1736378720623",
"side": "buy",
"orderId": "1288888888888888888",
"execPnl": "0",
"feeDetail": [
{
"feeCoin": "USDT",
"fee": "0.569958"
}
],
"execTime": "1736378720623",
"tradeScope": "taker",
"tradeSide": "open",
"execId": "1288888888888888888",
"execLinkId": "1288888888888888888",
"execPrice": "94993",
"holdSide": "long",
"execValue": "949.93",
"category": "usdt-futures",
"execQty": "0.01",
"clientOid": "1288888888888888889",
"isRPI": "no"
}
],
"arg": {
"instType": "UTA",
"topic": "fill"
},
"action": "snapshot",
"ts": 1733904123981
}
```
### Push Parameters
| Parameters | Type | Description |
|:-------------------|:-------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| arg | Object | Subscribed channel |
| > instType | String | product type
`UTA` Unified trading account |
| > topic | String | Topic
`fill` fill |
| action | String | Action
`snapshot` Full data |
| data | List<Object> | Subscribed data |
| > category | String | Product type
`spot` Spot trading
`margin` Margin trading
`usdt-futures` USDT futures
`coin-futures` Coin-M futures
`usdc-futures` USDC futures |
| > orderId | String | Order ID |
| > clientOid | String | Client Order ID |
| > execId | String | Fill ID |
| > execLinkId | String | Execution correlation ID |
| > symbol | String | Symbol name |
| > orderType | String | Order type
`limit`/`market` |
| > side | String | Trade side
`buy`/`sell` |
| > holdSide | String | Position direction
`long`: Long
`short`: Short |
| > tradeSide | String | Trade side
`open`/`close`
Detailed enumerations can be obtained on the Enumeration page. |
| > execPrice | String | Fill price |
| > execQty | String | Fill quantity
_The unit is base coin_ |
| > execValue | String | Fill value
_The unit is quote coin_ |
| > execPnl | String | Execution profit and loss |
| > tradeScope | String | Trade scope
`taker`/`maker` |
| > feeDetail | String | Fee detail |
| >> feeCoin | String | Fee coin |
| >> fee | String | Total fee |
| > execTime | String | Execution timestamp
A Unix timestamp in milliseconds. e.g.,`1622697148123` |
| > updatedTime | String | Updated timestamp
A Unix timestamp in milliseconds. e.g.,`1622697148123` |
| > isRPI | String | Whether it is an RPI fill
`yes` Yes
`no` No |