Плотности и айсберги
1Плотности и айсберги
Крупные лимитные стены в стакане прямо сейчас, история снятых и съеденных стен (хранится не больше 90 дней), айсберги и поглощения.
Плотность — крупная лимитная заявка (стена), заметно больше обычного объёма на соседних уровнях. Сервис плотностей следит за стаканами бирж и отдаёт стены сразу с размером в долларах, расстоянием до цены и возрастом.
Живые плотности
/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 |
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
}| Колонка | Что |
|---|---|
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.
История плотностей
/v1/densities/historyЗакрытые стены: снятые (pulled) и съеденные сделками (eaten). Хранятся не больше 90 дней. Группа тарифа — densities_history.
| Параметр | Что |
|---|---|
instrument |
обязательный |
from |
начало по моменту появления стены, мс. По умолчанию — сутки назад от to |
to |
конец, мс, не включительно |
kind |
pulled, eaten или оба через запятую (по умолчанию) |
limit |
стен на страницу, 1–10 000, по умолчанию 1000 |
cursor |
курсор: страницы идут от свежих к старым |
{
"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 в истории нет — связать закрытую стену с живой по номеру нельзя.
Айсберги и поглощения
/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