LootX

Liquidity Walls and Icebergs

Updated November 6, 2026 This page as PDF

Large resting limit walls in the order book right now, history of pulled and eaten walls (stored for at most 90 days), icebergs and absorption.

A liquidity wall is a large limit order (wall) noticeably bigger than the usual volume at neighboring levels. The density service watches exchange order books and reports walls immediately with dollar size, distance to price, and age.

Live Walls

GET/v1/densities

Current snapshot of walls: for a single instrument or a market-wide summary. Rate-limit group — densities.

Parameter Meaning
instrument one instrument. Without it — market-wide summary with filters below
venue exchanges comma-separated: binance,bybit
market markets comma-separated: spot, perp
coins coins comma-separated: BTC,ETH — not symbols
side bid or ask
min_usd minimum wall size, $
max_dist_bp maximum distance to order book mid, basis points: 200 = ±2 %
limit how many walls, default 200
sort usd (default), age, dist
Shell
curl -s "https://market-api.lootx.trade/v1/densities?coins=BTC&market=perp&min_usd=1000000&limit=2" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "ts": 1793750400000,
  "columns": ["instrument", "side", "price", "qty", "usd", "dist_bp", "first_ts", "age_ms",
              "peak_usd", "state", "touched", "size", "score", "agg", "wall_id"],
  "rows": [
    ["binance:perp:BTCUSDT", "bid", 103500.0, 41.8, 4326300.0, -72, 1793741112000, 9288000,
     4512000.0, "live", false, "strong", 2.37, "tick", "11658847687750313317"]
  ],
  "next_cursor": null
}
Column Meaning
side bid — buy, ask — sell
price, qty, usd price, volume in coins, and wall size in dollars
dist_bp signed distance to order book mid, bp: minus — below mid (usually bids), plus — above (asks). Filter max_dist_bp compares absolute value
first_ts, age_ms when the wall appeared and how long it has been standing
peak_usd largest wall size over its lifetime
state live — standing without noticeable changes, updated — size changed noticeably since last snapshot
touched trades have already occurred at the wall’s price, eating into it
size normal, weak, optimal, strong — size step relative to pair liquidity; normal — wall present but below the weak step
score measure of largeness: 1 — optimal threshold, 2 — strong threshold, 0 — not calculated
agg tick — wall at a single level, natr — levels merged by volatility
wall_id wall number as a string: it’s a 64-bit number that doesn’t fit in JavaScript number without loss

The summary is sorted by usd, ts is the snapshot moment. The snapshot is live: walls have no cache, each request is a fresh state. For continuous monitoring, take the densities channel in WebSocket: by an instrument list or the whole market with filters. Changes arrive on their own, without polling; frame bytes go into the daily volume together with REST.

Wall History

GET/v1/densities/history

Closed walls: pulled (pulled) and eaten by trades (eaten). Stored for at most 90 days. Rate-limit group — densities_history.

Parameter Meaning
instrument required
from start by wall appearance time, ms. Default — one day before to
to end, ms, not inclusive
kind pulled, eaten, or both comma-separated (default)
limit walls per page, 1–10 000, default 1000
cursor cursor: pages go from newest to oldest
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "columns": ["t", "side", "kind", "price", "qty_open", "qty_close", "usd_open", "usd_peak",
              "end_ts", "duration_ms", "dist_bp_open", "mid_at_close", "touched", "size"],
  "rows": [
    [1793741112000, "bid", "eaten", 103500.0, 41.8, 0.0, 4326300.0, 4512000.0,
     1793752004000, 10892000, -72, 103498.6, true, "S"]
  ],
  "next_cursor": null
}

t — wall appearance, end_ts — when it disappeared; qty_open/qty_close — volume at start and end, mid_at_close — order book mid at close. size in history is a short code: "" — no step, W — weak, O — optimal, S — strong.

History records walls from the compressed order book (agg = natr), not individual levels: price and size don’t match snapshot walls (those are tick by default), and wall_id isn’t in history — you can’t link a closed wall to a live one by number.

Icebergs and Absorption

GET/v1/icebergs

Hidden orders that are topped up in pieces (iceberg) and levels absorbing market flow (absorption). Rate-limit group — icebergs.

Parameter Meaning
instrument one instrument. Without it — market-wide with filters
venue, market, coins, side filters as for walls; coins — up to 100
kind iceberg, absorption, or all (default)
min_usd minimum hidden executed volume, $
state active (default — ongoing), ended (finished), or all
limit 1–5000, default 200

Columns: instrument, id (as a string — 64-bit number), side, kind, price, first_ts, last_ts, trades, executed_qty, hidden_qty, visible_max, clip_qty (coins), executed_usd, hidden_usd ($; hidden volume is a lower estimate), refills, end (null — still ongoing; otherwise idle, broken, or reset).