# Liquidation Channel

### Description

Liquidation Channel.

Data is pushed once per second (1s/interval). Each push contains the aggregated liquidation data for the previous second: only the record with the highest liquidation quantity for long and short positions respectively per trading pair is included. Both Unified Trading Account and Classic Account liquidation data are covered. For any given trading pair within a single second, at most 2 records are delivered (1 for long, 1 for short).

<div className="api-aligning">

```json title="Request Example"
{
    "args": [
        {
            "instType": "usdt-futures",
            "topic": "liquidation"
        }
    ],
    "op": "subscribe"
}
```

### Request Parameters

| Parameters    | Type               | Required | Description                                                                                                        |
|---------------|--------------------|----------|--------------------------------------------------------------------------------------------------------------------|
| op            | String             | Yes      | Operation <br/> `subscribe` Subscribe <br/> `unsubscribe` Unsubscribe                                              |
| args          | List&lt;Object&gt; | Yes      | Subscribed channel                                                                                                 |
| &gt; instType | String             | Yes      | Product type<br/>`usdt-futures` USDT futures <br/> `coin-futures` Coin-M futures <br/> `usdc-futures` USDC futures |
| &gt; topic    | String             | Yes      | Topic <br/> `liquidation` Liquidation channel                                                                      |

</div>

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

<div className="api-aligning">

```json title="Response Example"
{
  "event": "subscribe",
  "arg": {
    "instType": "usdt-futures",
    "topic": "liquidation"
  },
  "connId": "xxxxxxxxxx"
}
```

### Response Parameters

| Parameters    | Type   | Description                                                                                                        |
|---------------|--------|--------------------------------------------------------------------------------------------------------------------|
| event         | String | Event                                                                                                              |
| arg           | Object | Subscribed channel                                                                                                 |
| &gt; instType | String | Product type<br/>`usdt-futures` USDT futures <br/> `coin-futures` Coin-M futures <br/> `usdc-futures` USDC futures |
| &gt; topic    | String | Topic <br/> `liquidation` Liquidation channel                                                                      |
| 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",
      "side": "buy",
      "price": "89000",
      "amount": "37.722858",
      "ts": "1736371332162"
    }
  ],
  "arg": {
    "instType": "usdt-futures",
    "topic": "liquidation"
  },
  "action": "update",
  "ts": 1736371332162
}
```

### Push Parameters

| Parameters    | Parameter Type     | Description                                                                                                        |
|---------------|--------------------|--------------------------------------------------------------------------------------------------------------------|
| arg           | Object             | Subscribed successful channel                                                                                      |
| &gt; instType | String             | Product type<br/>`usdt-futures` USDT futures <br/> `coin-futures` Coin-M futures <br/> `usdc-futures` USDC futures |
| &gt; topic    | String             | Topic <br/> `liquidation` Liquidation channel                                                                      |
| action        | String             | Data push action <br/> `snapshot` Full data <br/> `update` Incremental data                                        |
| data          | List&lt;Object&gt; | Subscribed data                                                                                                    |
| &gt;[symbol](/docs/catalog/market/market-data#get-instruments)    | String             | Symbol name                                                                                                        |
| &gt;side      | String             | Position side<br/>`buy`Long position liquidation<br/>`sell`Short position liquidation                              |
| &gt;price     | String             | Liquidation price                                                                                                  |
| &gt;amount    | String             | Liquidation amount   <br/> Unit: quote coin. For example, `37.722858` means 37.722858 quote coins of the position were liquidated.                                                                       |
| &gt;ts        | String             | Liquidation time (Unix millisecond timestamp)                                                                      |

</div>