> ## Documentation Index
> Fetch the complete documentation index at: https://orderly.network/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Liquidation push

> Subscribe to real-time liquidation event notifications via WebSocket.

Push interval: push on addition/removal/update from list within 1s

```json theme={null}
{
  "id": "clientID12",
  "topic": "liquidation",
  "event": "subscribe"
}
```

**Parameters**

| Name  | Type   | Required | Description               |
| ----- | ------ | -------- | ------------------------- |
| id    | string | Y        | id generate by client     |
| event | string | Y        | `subscribe`/`unsubscribe` |
| topic | string | N        | `liquidation`             |

<RequestExample>
  ```json Response theme={null}
  {
    "id": "clientID12",
    "event": "subscribe",
    "success": true,
    "ts": 1682243349558
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Subscribed Message theme={null}
  {
     "topic":"liquidation",
     "ts":1684926668235,
     "data":[
        {
           "liquidationId":1,
           "timestamp":1684821114917,
           "type":"liquidated",
           "positionsByPerp":[
              {
                 "symbol":"PERP_NEAR_USDC",
                 "positionQty":12.6,
                 "liquidatorFee":0.0175
              }
           ]
        },
        ...
     ]
  }
  ```
</ResponseExample>