Щільності та айсберги
Великі лімітні стіни в стакані прямо зараз, історія знятих і з'їдених стін (зберігається не більше 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).