Liquidity Walls and Icebergs
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
/v1/densitiesCurrent 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 |
curl -s "https://market-api.lootx.trade/v1/densities?coins=BTC&market=perp&min_usd=1000000&limit=2" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"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
/v1/densities/historyClosed 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 |
{
"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
/v1/icebergsHidden 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).