Documentation Index
Fetch the complete documentation index at: https://docs.pacificalens.xyz/llms.txt
Use this file to discover all available pages before exploring further.
The Liquidation Monitor aggregates liquidation events from multiple perpetuals data sources and presents them across all 63 Pacifica markets in real time. Use it to understand where forced selling is concentrated, which side of the market is being squeezed, and how liquidation clusters relate to the current price level. The monitor refreshes automatically every minute.
Three view modes
Switch between views using the ⊞ / ☰ / ⚡ buttons in the top-right of the monitor header.
Grid view
Grid view renders one card per market. Each card shows:
- Total liquidation notional for the selected time window
- Intensity bar — a thin colored strip at the top of the card whose width and brightness scale with the market’s liquidation volume relative to the highest-volume market in the set
- Long/short breakdown — a horizontal bar split between teal (longs liquidated) and red (shorts liquidated), with exact notional values and percentages below
- Color coding — cards with long-dominant liquidations tint green; short-dominant cards tint red
Click any card to open the Liquidation Leverage Map for that market.
List view
List view presents the same data in a compact, sortable table. Each row shows:
- Rank, symbol, and dominant-side indicator (▲ Longs dom. / ▼ Shorts dom.)
- Total liquidation notional
- Long and short notional as separate columns
- L/S ratio bar — a miniature long/short bar in the final column for quick visual comparison
Click a column header to sort. Click any row to open the Leverage Map.
Feed view
Feed view is a chronological event stream of individual liquidation events as they occur. Each row shows:
- Timestamp
- Symbol
- Side (▲ L for long liquidation, ▼ S for short)
- Notional size
- Execution price
The feed displays up to 200 of the most recent events and updates automatically. Click any row to open the Leverage Map for that symbol.
Time ranges
Select the window over which liquidation data is aggregated using the time buttons in the header:
| Range | Use case |
|---|
| 1h | Spot very recent activity and intraday squeezes |
| 6h | Identify session-level liquidation pressure |
| 24h | Default view — see a full day of forced exits |
| 7d | Understand multi-day liquidation clusters |
Liquidation Leverage Map
Click any market card, list row, or feed event to open the Liquidation Leverage Map — an interactive chart that visualizes where leveraged positions are clustered at each price level.
The chart is split into two panels:
Upper panel (78% of height) — price chart
- Solid line chart of closing prices for the selected time range
- Gradient area fill beneath the line
- Dashed mark-price overlay in gold showing the current market price
- Hover crosshair with date/time labels and OHLC tooltip
Lower panel (22% of height) — liquidation leverage bars
- Bars plotted at each price level, showing the notional value of positions that would be liquidated at that price
- Teal bars represent long liquidations (longs forced out as price falls to that level)
- Red bars represent short liquidations (shorts forced out as price rises to that level)
- Cumulative overlay lines show the running total of long and short liquidations from left to right
- The dashed gold vertical line marks the current mark price
Tooltip behavior
| Panel | Tooltip shows |
|---|
| Upper panel | OHLC values for the hovered candle + timestamp |
| Lower panel | Liquidation notional + cumulative long and short totals at the hovered price level |
| Range | Candle interval |
|---|
| 12h | 15-minute candles |
| 24h | 1-hour candles |
| 48h | 2-hour candles |
| 7d | 4-hour candles |
Dense clusters of liquidation bars at a specific price level signal that many positions have stop-losses or liquidation prices stacked there. If price approaches a large teal cluster from above, a cascade of long liquidations can accelerate the move downward. Conversely, a large red cluster below current price can act as a magnet when shorts get squeezed. Use these clusters to anticipate where momentum may briefly accelerate or reverse.
