# Liquidation

## Trading with Liquidation Data — Analysis & Signal Guide

A practical guide for traders who want to use the liquidation features in this system to analyze markets, predict price moves, and find trading signals.

***

### Table of Contents

1. What Is Liquidation and Why Does It Matter?
2. Data Sources & Collection
3. Two Modes: Live vs Depth
4. Reading the Liquidation Chart
5. Market Analysis & Prediction
6. Trading Signals from Liquidation Data
7. Combining with Other Data
8. Practical Examples
9. Glossary

***

### 1. What Is Liquidation and Why Does It Matter?

**Liquidation** (forced liquidation) happens when a leveraged trader's margin can no longer sustain the position. The exchange forcefully closes the position by executing a market order.

| Type                  | When It Happens         | Market Effect                                    |
| --------------------- | ----------------------- | ------------------------------------------------ |
| **Long liquidation**  | Price **drops** sharply | Exchange sells the position → more sell pressure |
| **Short liquidation** | Price **rises** sharply | Exchange buys to close → more buy pressure       |

#### Why should you care?

**1. The Domino Effect (Cascade)** Each liquidation creates a forced buy/sell order that pushes price further in the same direction, which triggers more liquidations. This chain reaction is called a **cascade** and can cause violent price moves far beyond what fundamentals justify.

**2. Price Gets "Pulled" Toward Liquidation Clusters** Market makers and whales know where liquidation orders are stacked. They often push prices toward these zones to capture the liquidity that gets released — a phenomenon known as a **liquidation magnet**.

**3. Measuring Collective Pain** Liquidation volume measures how wrong the market consensus was. A $500M long liquidation event means half a billion dollars was forced out of long positions — that's a massive sentiment reset.

<figure><img src="/files/7dOB0Z1Matavs2ikhyKw" alt=""><figcaption></figcaption></figure>

***

### 2. Data Sources & Collection

The system collects **forced liquidation events** in real-time from the three largest perpetual futures exchanges:

| Exchange            | Latency |
| ------------------- | ------- |
| **Binance Futures** | \~100ms |
| **Bybit Futures**   | \~100ms |
| **Hyperliquid**     | \~5s    |

***

### 3. Two Modes: Live vs Depth

#### 3.1. Live Mode — "What Already Happened."

<div data-full-width="true"><figure><img src="/files/l6YJKXl76CFqLi6gn9Nc" alt=""><figcaption></figcaption></figure></div>

Shows **actual liquidation events** that occurred in the past 24 hours.

* **Source:** Real-time events from all 3 exchanges
* **Update frequency:** Individual events every \~1s, aggregated chart every \~5s
* **Use for:** Monitoring current liquidation activity, gauging market "heat."

**When to use Live:**

* You want to know if the market is **actively** liquidating positions right now
* Tracking a big move (BTC drops 5%, how many longs got wiped?)
* Comparing long vs short liquidation volume during the current session

#### 3.2. Depth Mode — "What Could Happen."

<div data-full-width="true"><figure><img src="/files/nLsrBtoUx9zOEtGeYSPe" alt=""><figcaption></figcaption></figure></div>

Estimates **potential liquidation zones** based on Open Interest and leverage distribution modeling.

* **Source:** OI + Long/Short ratio from 3 exchanges, polled every \~15s
* **Update frequency:** Chart recomputed every \~2s (using live orderbook mid price)
* **Use for:** Finding price zones where large liquidations would trigger, predicting support/resistance

**When to use Depth:**

* Finding price levels with heavy **pending** liquidation orders (not yet triggered)
* Assessing cascade risk if the price moves 1%, 2%, or 5%
* Locating "price magnets" — zones the market is likely to be pulled toward

#### Quick comparison

|            | Live                          | Depth                                   |
| ---------- | ----------------------------- | --------------------------------------- |
| Data       | Historical, already occurred  | Estimated, could occur                  |
| Update     | Events 1s, chart 5s           | Chart 2s                                |
| Source     | Liquidation events            | Open Interest + leverage model          |
| Similar to | Coinglass "Live Liquidations" | Coinglass "Liquidation Heatmap / Depth" |

***

### 4. Reading the Liquidation Chart

The chart divides the price range into **200 buckets** from `priceMin` to `priceMax`.

#### 4.1. Bar Chart (Volume at Each Price)

<figure><img src="/files/UrL3OE604fWuRQifDp38" alt=""><figcaption></figcaption></figure>

* **Left of current price:** Red bars = volume of long positions liquidated (or estimated to be liquidated) at each price level
* **Right of current price:** Green bars = volume of short positions
* **Tall bars** = many positions concentrated at that price → **strong liquidation zone**

#### 4.2. Cumulative Lines

* **Red line** (`cumulativeLong`): Starts at 0 at current price, increases going **left** (lower prices) → tells you "if price drops to X, how many total BTC of longs will be liquidated."
* **Green line** (`cumulativeShort`): Starts at 0 at current price, increases going **right** (higher prices) → same for shorts

These lines are the most useful for quickly seeing the **total exposure** on each side.

#### 4.3. Key Metadata

<figure><img src="/files/2hxgOgi1WWUYEarOT6vs" alt=""><figcaption></figcaption></figure>

| Field                      | What It Tells You                                                |
| -------------------------- | ---------------------------------------------------------------- |
| Total Liquidations         | Total coin volume of long/short liquidations                     |
| Nearest Cluster Long Zone  | % distance from current price to the nearest dense long liq zone |
| Nearest Cluster Short Zone | % distance to the nearest dense short liq zone                   |
| Liq @ Threshold            | If price moves 1%, 2%, 5% — how much volume gets liquidated      |
| L/S Ratio                  | Long/short OI ratio (Depth only)                                 |
| 1h Rate                    | Number of liquidation events in the past hour (Live only)        |
| Activity                   | The single biggest liquidation in the 24h window (Live only)     |

***

### 5. Market Analysis & Prediction

#### 5.1. Identifying the Price Magnet

<div data-full-width="true"><figure><img src="/files/8LR5Hrip2HUAfIkmzm8S" alt=""><figcaption></figcaption></figure></div>

Price tends to get **pulled** toward the largest liquidation cluster because:

* Whales and market makers want to trigger liquidations to harvest the released liquidity
* A liquidation cascade creates natural momentum toward that zone

**How to identify:**

1. On the Depth chart, find the largest cluster on each side
2. Compare volumes:
   * Long cluster > 1.5× short cluster → **Magnet direction: DOWN** (price wants to drop toward the long cluster)
   * Short cluster > 1.5× long cluster → **Magnet direction: UP** (price wants to rise toward the short cluster)
3. The `magnetLevel` The field gives you the exact price

**Example:** BTC is at $70,000. Largest long liq cluster at $67,000 (4,000 BTC). Largest short liq cluster at $73,000 (1,500 BTC). → Magnet pulls DOWN to $67,000 because the long cluster is 2.7× larger.

#### 5.2. Assessing Cascade Risk

The system automatically classifies cascade risk based on how much liquidation volume sits within ±2% of the current price:

| Cascade Risk | Condition                       | What It Means                                          |
| ------------ | ------------------------------- | ------------------------------------------------------ |
| **High**     | >30% of total volume within ±2% | Dangerous — a small move can trigger a massive cascade |
| **Moderate** | 15–30% within ±2%               | Be cautious — significant cascade potential            |
| **Low**      | <15% within ±2%                 | Normal — liquidations are spread out, low domino risk  |

**Action:** When cascade risk is HIGH, avoid opening new positions in the direction of the nearest cluster. If you're already positioned, tighten stops.

#### 5.3. Threshold Analysis (What-If Scenarios)

The system pre-computes: if price moves by 1%, 2%, or 5%, how much gets liquidated?

| Field                     | Meaning                         |
| ------------------------- | ------------------------------- |
| `liqAtThresholds[0]` (1%) | Liq volume from a 1% price move |
| `liqAtThresholds[1]` (2%) | Liq volume from a 2% price move |
| `liqAtThresholds[2]` (5%) | Liq volume from a 5% price move |

Each threshold includes `longQty`, `shortQty`, `longUsd`, and `shortUsd`.

**How to use:**

* If a **2% drop** would liquidate $500M in longs, but a **2% rise** would only liquidate $200M in shorts → **asymmetric risk favoring shorts** (bearish signal)
* The 5% threshold shows worst-case scenarios for black swan events
* Compare the 1% and 2% values — if 2% is dramatically larger than 1%, there's a "cliff" of liquidations just beyond 1%

#### 5.4. Open Interest & Long/Short Ratio

Depth mode provides OI context:

| Metric           | Meaning                                  | How to Use                                                                                 |
| ---------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------ |
| `totalOI`        | Total Open Interest in base asset        | Rising OI + rising price = bullish conviction. Rising OI + falling price = bearish buildup |
| `longShortRatio` | Fraction of accounts that are long (0–1) | >0.65 = crowded long (squeeze risk). <0.35 = crowded short                                 |
| `oiByExchange`   | OI breakdown per exchange                | See where leverage is concentrated                                                         |

***

### 6. Trading Signals from Liquidation Data

#### Signal 1: Liquidation Cascade Alert

**Description:** When price enters a dense liquidation zone, each liquidation creates more forced orders → price accelerates → more liquidations.

**How to detect:**

* `cascadeRisk` = `"high"`
* `nearestLongCluster` or `nearestShortCluster` < 2%
* Live: **1h Rate**> 20 = active cascade in progress

**Trading implications:**

* **Cascade down** (longs getting wiped): Strong bearish momentum. Don't try to catch the falling knife. Wait until `liqRate1h` the drops fall below 10 and the cluster has been swept.
* **Cascade up** (shorts getting squeezed): Short squeeze in progress. Don't short into it. Wait for exhaustion.

#### Signal 2: Liquidation Clusters as Hidden Support/Resistance

**Description:** A large pending liquidation cluster (Depth) acts as a magnet — price will be pulled toward it. But once the cluster is swept, the zone becomes strong support/resistance.

**The lifecycle:**

1. **Before sweep:** Cluster acts as a **magnet** — price tends to move toward it
2. **During sweep:** Cascade occurs — violent price action, high `liqRate1h`
3. **After sweep:** Zone becomes **support/resistance** because all leveraged positions have been flushed out

**How to trade:**

* **Pre-sweep:** Trade in the direction of the magnet (but be ready to exit quickly)
* **Post-sweep:** The swept zone is a high-probability reversal area. Look for entries here with stops below/above the cluster

#### Signal 3: Long/Short Imbalance

**Description:** When the long/short ratio becomes extreme, the market is primed for a squeeze.

| Signal                 | Condition                          | Action                                      |
| ---------------------- | ---------------------------------- | ------------------------------------------- |
| **Long squeeze risk**  | `longShortRatio` > 0.65            | Be cautious with longs, consider hedging    |
| **Short squeeze risk** | `shortRatio` > 0.65 (ratio < 0.35) | Be cautious with shorts, watch for breakout |
| **Balanced**           | Ratio between 0.45–0.55            | No imbalance signal                         |

**Enhancement:** Combine with threshold data. If crowded long AND 2% drop would trigger massive liq → high probability of long squeeze.

#### Signal 4: Liquidation Void (Fast Move Zone)

**Description:** A price range with very little liquidation volume between two dense clusters. Price can move through this zone **extremely fast** because there's no "brake" — no liquidations to create counter-pressure.

**How to spot:** On the chart, look for flat/empty bars between two tall clusters.

**Trading implication:** If price breaks into a void, expect a rapid move to the next cluster. Don't place tight stops inside the void — they'll get run through.

#### Signal 5: Asymmetric Threshold (Directional Bias)

**Description:** Compare the liquidation volume that would be triggered by a drop vs a rise at the same percentage.

**Example at 2% threshold:**

* 2% drop → $800M long liq
* 2% rise → $200M short liq
* **Ratio: 4:1 bearish asymmetry**

**Interpretation:** The market has 4× more liquidation fuel to the downside. This means:

* A downward cascade would be more violent than an upward one
* Market makers have more incentive to push price down (more liquidity to harvest)
* The downside is the "path of least resistance" for a forced move

***

### 7. Combining with Other Data

Liquidation data is most powerful when combined with other signals from the system:

#### 7.1. Liquidation + Orderbook

| Combination                         | Meaning                                                                   |
| ----------------------------------- | ------------------------------------------------------------------------- |
| Liq cluster nearby + thin bid wall  | **Very dangerous** — price can punch through easily, cascade likely       |
| Liq cluster nearby + thick bid wall | Wall may block cascade, but if wall breaks → cascade is even more violent |
| Liq cluster far + tight spread      | Safe — stable market conditions                                           |

#### 7.2. Liquidation + Absorption / Iceberg

* **Absorption** near a liquidation cluster = Someone is absorbing the forced sell orders → strong support forming
* **Iceberg orders** near a cluster = Large accumulation underway, likely by smart money anticipating the cascade

#### 7.3. Liquidation + VPIN

| VPIN        | Liq Activity | Interpretation                                                        |
| ----------- | ------------ | --------------------------------------------------------------------- |
| High (>0.7) | High         | **Informed traders** are deliberately pushing price into the liq zone |
| High        | Low          | Big move incoming — positions are being built before a push           |
| Low         | High         | Retail panic liquidation, not driven by smart money                   |
| Low         | Low          | Quiet market, no action needed                                        |

#### 7.4. Liquidation + CVD (Cumulative Volume Delta)

* CVD trending down + approaching long liq cluster = Sellers in control, cascade very likely
* CVD trending up + approaching short liq cluster = Buyers driving price into shorts, squeeze building

***

### 8. Practical Examples

#### Example 1: Spotting an Incoming Long Squeeze

**Context:** BTC at $70,000

**Depth data:**

* `longShortRatio`: 0.68 (68% of accounts are long)
* Largest long liq cluster: $67,500 (\~4,000 BTC estimated)
* `nearestLongCluster`: 3.6%
* `cascadeRisk`: "moderate"
* `liqAtThresholds` at 2%: longQty = 2,800 BTC ($196M)

**Live data:**

* `liqRate1h`: 12 events (moderate)
* More longs than shorts being liquidated in the past 6 hours

**Analysis:**

* Market is **crowded long** (68%) → squeeze risk elevated
* If price drops to $68,600 (-2%), $196M in longs get wiped
* Beyond that, the $67,500 cluster would trigger a full cascade
* `cascadeRisk` is only "moderate" now but could flip to "high" if price drops just 1.5%

**Action:**

* Don't open new longs here
* Set stop-losses above $67,500 for existing long positions
* If `liqRate1h` spikes above 20 → cascade has started, don't buy the dip yet

***

#### Example 2: Finding an Entry After a Cascade

**Context:** BTC just dropped from $70,000 to $67,000

**Live data:**

* `liqRate1h`: 45 events → **high activity** (cascade in progress)
* Total long liq 24h: 2,500 BTC (\~$167M)
* `largestEvent`: 15 BTC ($1M single liquidation)

**Depth data (compare with before the drop):**

* The $67,000 long cluster has been **largely swept** (volume much smaller now)
* Next cluster below: $64,000 (4.5% away)
* `cascadeRisk`: dropped from "high" to "low"

**Analysis:**

* The cascade has swept through the $67,000 cluster
* `liqRate1h` peaked at 45 but is starting to decline → cascade is exhausting
* $67,000 is now a **support zone** — the leveraged positions have been flushed, removing sell pressure
* Next cluster is 4.5% away → large buffer before another cascade

**Action:**

* Wait for `liqRate1h` to drop below 10 (cascade fully exhausted)
* Look for entries in the $67,000–$67,500 zone
* Stop-loss below $63,500 (below the next cluster at $64,000)
* Target: $70,000+ (the zone that was resistance is now a fill gap)

***

#### Example 3: Detecting a Short Squeeze Setup

**Context:** ETH at $3,500 after a prolonged decline

**Depth data:**

* `longShortRatio`: 0.35 (65% of accounts are short)
* Largest short liq cluster: $3,700 (\~50,000 ETH)
* `nearestShortCluster`: 5.7%
* `magnetDirection`: "up"

**Threshold data (`liqAtThresholds`):**

* 2% rise: shortQty = 15,000 ETH ($52.5M)
* 5% rise: shortQty = 45,000 ETH ($157.5M)
* 2% drop: longQty = 5,000 ETH ($17.5M)

**Analysis:**

* **Extreme asymmetry:** 3× more short liq than long liq at the 2% threshold
* **Crowded short** (65%) → prime setup for a squeeze
* Magnet direction is UP toward $3,700
* If price rises just 2%, $52.5M in shorts get liquidated → forced buying → cascade UP

**Action:**

* Strong bullish signal — consider a long entry
* Target: $3,700 zone (where the short squeeze concentrates)
* Favorable risk/reward: a 2% drop only triggers $17.5M in long liq (contained risk), but a 2% rise triggers $52.5M in short liq (3× the fuel)
* Stop-loss: below $3,400 (tight, since downside liq is limited)

***

### 9. Glossary

| Term                    | Definition                                                                                       |
| ----------------------- | ------------------------------------------------------------------------------------------------ |
| **Liquidation**         | Forced closure of a leveraged position when margin is insufficient                               |
| **Long liquidation**    | A long position gets liquidated when price drops — exchange sells the coin                       |
| **Short liquidation**   | A short position gets liquidated when price rises — exchange buys the coin                       |
| **Open Interest (OI)**  | Total number of open futures contracts, measured in base asset (e.g. BTC)                        |
| **Long/Short Ratio**    | Fraction of accounts that are long; >0.5 = more longs, <0.5 = more shorts                        |
| **Leverage**            | Multiplier on capital — e.g. 10× means $1,000 controls $10,000; liquidated at \~10% adverse move |
| **Cascade**             | Chain reaction where liquidations cause more liquidations                                        |
| **Liquidation Cluster** | A price zone with a high concentration of potential liquidation orders                           |
| **Magnet Level**        | Price level that the market tends to be pulled toward due to concentrated liquidations           |
| **Maintenance Margin**  | Minimum margin to keep a position open; when equity falls below this → liquidation               |
| **Cumulative**          | Running total — sums up from current price outward in both directions                            |
| **Squeeze**             | When one side (long or short) is overcrowded, price reverses and liquidates them en masse        |
| **Cascade Risk**        | Assessment of how likely a domino-effect liquidation chain is (high/moderate/low)                |
| **Void**                | A price zone with very few liquidation orders — price moves fast through voids                   |
| **VPIN**                | Volume-Synchronized Probability of Informed Trading — high = smart money is active               |
| **Absorption**          | Large orders that continuously absorb sell/buy pressure without letting price move               |
| **Bucket**              | One of 200 price intervals that the chart divides the price range into                           |
| **Threshold**           | Pre-computed estimate: "if price moves X%, how much gets liquidated?"                            |

***

### Quick Reference: Liquidation Analysis Checklist

1. **Check Depth Mode first** → identify the nearest liquidation clusters on both sides
2. **Read `cascadeRisk`** → if HIGH, avoid trading in the direction of the nearest cluster
3. **Check `longShortRatio`** → above 0.65 or below 0.35 = imbalanced, squeeze risk
4. **Compare `liqAtThresholds`** at 1% and 2% → the side with more volume is more vulnerable
5. **Switch to Live Mode** → `liqRate1h` tells you if a cascade is happening right now
6. **Find the magnet** → price tends to move toward the largest liquidation cluster
7. **Combine with orderbook** → walls near liq zones = confirmation; gaps near liq zones = fast cascade
8. **After a cascade** → the swept zone becomes fresh support/resistance


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mrd-indicators.com/terminal/widget/liquidation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.