← До документації
LootX

Щільності та айсберги

Зібрано: 2026-11-21 docs.lootx.trade
Справочник

1Щільності та айсберги

Великі лімітні стіни в стакані прямо зараз, історія знятих і з'їдених стін (зберігається не більше 90 днів), айсберги та поглинання.

Щільність — велика лімітна заявка (стіна), помітно більша за звичайний об’єм на сусідніх рівнях. Сервіс щільностей стежить за стаканами бірж і віддає стіни одразу з розміром у доларах, відстанню до ціни та віком.

Живі щільності

GET/v1/densities

Поточний знімок стін: за одним інструментом або зведенням по ринку. Група тарифу — densities.

Параметр Що
instrument один інструмент. Без нього — зведення по ринку з фільтрами нижче
venue біржі через кому: binance,bybit
market ринки через кому: spot, perp
coins монети через кому: BTC,ETH — не символи
side bid або ask
min_usd мінімальний розмір стіни, $
max_dist_bp максимальна відстань до середини стакана, базисні пункти: 200 = ±2 %
limit скільки стін, за замовчуванням 200
sort usd (за замовчуванням), 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
}
Колонка Що
side bid — купівля, ask — продаж
price, qty, usd ціна, об’єм у монетах і розмір стіни в доларах
dist_bp відстань до середини стакана зі знаком, б. п.: мінус — нижче середини (зазвичай біди), плюс — вище (аски). Фільтр max_dist_bp порівнює модуль
first_ts, age_ms коли стіна з’явилася і скільки вона вже стоїть
peak_usd найбільший розмір стіни за її життя
state live — стоїть без помітних змін, updated — розмір помітно змінився з минулого зрізу
touched за ціною стіни вже проходили угоди, які її їдять
size normal, weak, optimal, strong — ступінь розміру щодо ліквідності пари; normal — щільність є, але нижче слабкої ступені
score міра великості: 1 — поріг optimal, 2 — поріг strong, 0 — не рахувалася
agg tick — стіна на одному рівні, natr — рівні склеєні за волатильністю
wall_id номер стіни рядком: це 64-бітне число, у JavaScript воно не вміщується в number без втрат

Зведення відсортовано за usd, ts — момент знімка. Знімок живий: кешу в щільностей немає, кожен запит — свіжий стан. Для безперервного стеження візьміть канал densities у WebSocket: за списком інструментів або весь ринок з фільтрами. Зміни приходять самі, без опитування; байти кадрів ідуть у добовий об’єм разом з REST.

Історія щільностей

GET/v1/densities/history

Закриті стіни: зняті (pulled) і з’їдені угодами (eaten). Зберігаються не більше 90 днів. Група тарифу — densities_history.

Параметр Що
instrument обов’язковий
from початок за моментом появи стіни, мс. За замовчуванням — доба тому від to
to кінець, мс, не включно
kind pulled, eaten або обидва через кому (за замовчуванням)
limit стін на сторінку, 1–10 000, за замовчуванням 1000
cursor курсор: сторінки йдуть від свіжих до старих
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 — поява стіни, end_ts — коли її не стало; qty_open/qty_close — об’єм на початку і в кінці, mid_at_close — середина стакана в момент закриття. size в історії — короткий код: "" — без ступеня, W — weak, O — optimal, S — strong.

В історію пишуться стіни стисненого стакана (agg = natr), а не окремих рівнів: ціна і розмір не збігаються зі стінами живого знімка (там за замовчуванням tick), а wall_id в історії немає — пов’язати закриту стіну з живою за номером не можна.

Айсберги та поглинання

GET/v1/icebergs

Приховані заявки, які добиваються по шматочку (iceberg), і рівні, що поглинають ринковий потік (absorption). Група тарифу — icebergs.

Параметр Що
instrument один інструмент. Без нього — по ринку з фільтрами
venue, market, coins, side фільтри, як у щільностей; coins — до 100
kind iceberg, absorption або all (за замовчуванням)
min_usd мінімальний прихований виконаний об’єм, $
state active (за замовчуванням — ті, що йдуть), ended (закінчені) або all
limit 1–5000, за замовчуванням 200

Колонки: instrument, id (рядком — 64-бітне число), side, kind, price, first_ts, last_ts, trades, executed_qty, hidden_qty, visible_max, clip_qty (монети), executed_usd, hidden_usd ($; прихований об’єм — нижня оцінка), refills, end (null — ще йде; інакше idle, broken або reset).

https://docs.lootx.trade/uk/market-api/densities