---
title: Liquidations (WebSocket)
description: Real-time liquidation events via WebSocket.
---

# Liquidations (WebSocket)

<div class="type-header">
<span class="type-tag">LIQUIDATION</span>
</div>

Subscribe to live liquidation events as individual ticks.

## Subscribe

<CodeBlock lang="JSON">
<pre>{
  <span class="s-p">"jsonrpc"</span>: <span class="s-s">"2.0"</span>,
  <span class="s-p">"id"</span>: <span class="s-n">0</span>,
  <span class="s-p">"method"</span>: <span class="s-s">"public/subscribe"</span>,
  <span class="s-p">"params"</span>: {
    <span class="s-p">"channels"</span>: [
      {
        <span class="s-p">"type"</span>: <span class="s-s">"LIQUIDATION"</span>,
        <span class="s-p">"category"</span>: <span class="s-s">"*"</span>,
        <span class="s-p">"exchange"</span>: <span class="s-s">"BINANCE_FUTURES"</span>,
        <span class="s-p">"symbol"</span>: <span class="s-s">"BTCUSDT"</span>
      }
    ],
    <span class="s-p">"compression"</span>: <span class="s-s">"brotli"</span>,
    <span class="s-p">"version"</span>: <span class="s-s">"v2"</span>
  }
}</pre>
</CodeBlock>

## Response

<CodeBlock lang="JSON">
<pre>{
  <span class="s-p">"points"</span>: [
    {
      <span class="s-p">"series"</span>: {
        <span class="s-p">"type"</span>: <span class="s-s">"LIQUIDATION"</span>,
        <span class="s-p">"symbol"</span>: <span class="s-s">"BTCUSDT"</span>,
        <span class="s-p">"exchange"</span>: <span class="s-s">"BINANCE_FUTURES"</span>,
        <span class="s-p">"normalizedSymbol"</span>: <span class="s-s">"BTC-USDT"</span>,
        <span class="s-p">"category"</span>: <span class="s-s">"PERPETUAL"</span>,
        <span class="s-p">"side"</span>: <span class="s-s">"SELL"</span>,
        <span class="s-p">"coin"</span>: <span class="s-s">"BTC"</span>,
        <span class="s-p">"inverse"</span>: <span class="s-n">false</span>
      },
      <span class="s-p">"liquidation"</span>: {
        <span class="s-p">"id"</span>: <span class="s-s">"394820175"</span>,
        <span class="s-p">"price"</span>: <span class="s-n">89750.5</span>,
        <span class="s-p">"amount"</span>: <span class="s-n">0.15</span>,
        <span class="s-p">"timestamp"</span>: {
          <span class="s-p">"seconds"</span>: <span class="s-n">1769058900</span>,
          <span class="s-p">"nanoseconds"</span>: <span class="s-n">420000000</span>
        }
      }
    }
  ]
}</pre>
</CodeBlock>

### Response fields

| Field | Type | Description |
| --- | --- | --- |
| `series.side` | Side | Liquidation side -- `BUY` or `SELL` |
| `liquidation.id` | string | Exchange liquidation ID |
| `liquidation.price` | double | Liquidation price |
| `liquidation.amount` | double | Liquidation size in base asset |
| `liquidation.timestamp` | Timestamp | Liquidation event time (seconds + nanoseconds) |