← К документации
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/ru/market-api/densities