Футпринт і дельта
Кластери — обсяг покупок і продажів на кожному рівні ціни за вікнами; дельта агресора за вікнами з екстремумами всередині вікна; відкриття й закриття позицій за рівнями ціни Hyperliquid.
Футпринт
/v1/footprintКластери: для кожного вікна часу — обсяг по рівням ціни, окремо угоди по біду й по аску. Група тарифу — footprint.
| Параметр | Що |
|---|---|
instrument |
обов’язковий |
tf |
вікно кластера: 30s, 1m, 5m, 15m, 30m, 1h, 4h, 1d. За замовчуванням 1m |
from |
початок, мс. За замовчуванням — 60 вікон назад від to |
to |
кінець, мс, не включно |
cursor |
курсор із next_cursor |
В відповіді дві таблиці: levels — рівні ціни, windows — самі вікна.
{
"instrument": "binance:perp:BTCUSDT",
"tf": "1m",
"windows": {
"columns": ["ts", "open", "high", "low", "close", "closed"],
"rows": [[1793750400000, 104250.5, 104262.0, 104241.1, 104255.3, true]]
},
"levels": {
"columns": ["ts", "price", "bid_qty", "ask_qty", "trades", "trades_buy", "trades_sell"],
"rows": [
[1793750400000, 104250.5, 1.204, 0.832, 41, 23, 18],
[1793750400000, 104250.6, 0.317, 2.115, 37, 12, 25]
]
},
"next_cursor": null
}tsу рівня — початок вікна, якому він належить;bid_qty— обсяг, де агресор купував,ask_qty— де агресор продав, у монетах. Імена — за стороною агресора, а не за стороною біржового стакана, у яку припала угода: перевіряйте це, якщо переносите розрахунки з іншої платформи;trades_buy,trades_sell— скільки зtradesугод купив і продав агресор, ті ж сторони, що й уbid_qtyтаask_qty; коли відомі,trades_buy + trades_sell = trades.nullу обох — розбивки немає: історія до того, як сторони почали зберігатися, або вікно5m…1d, до якого потрапила така хвилина. Це не «жодної покупки». Колонки стоять у кінці рядка, перші п’ять — на звичних місцях;closed: true— вікно закрите й більше не зміниться. Останнє вікно у «зараз» може прийти зclosed: falseі дорости.
Вікон на сторінку — до 2000. CSV — одна таблиця, тому для футпринта оберіть її: ?format=csv&table=levels або table=windows.
Дельта
/v1/deltaДельта агресора за вікнами: покупки, продажі, їхня різниця й екстремуми рухомої дельти всередині вікна — у монетах і в грошах. Група тарифу — delta.
| Параметр | Що |
|---|---|
instrument |
обов’язковий |
tf |
вікно: 1s, 30s, 1m, 5m, 15m, 30m, 1h, 4h, 1d. За замовчуванням 1m |
from |
початок, мс; вирівнюється вниз по вікну. За замовчуванням — limit вікон назад від to |
to |
кінець, мс, не включно |
limit |
вікон на сторінку, 1–10 000, за замовчуванням 1000 |
cursor |
курсор із next_cursor |
curl -s "https://market-api.lootx.trade/v1/delta?instrument=binance:perp:BTCUSDT&tf=5m&limit=1" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"instrument": "binance:perp:BTCUSDT",
"tf": "5m",
"columns": ["t", "buy", "sell", "delta", "delta_min", "delta_max", "trades",
"buy_quote", "sell_quote", "delta_quote", "delta_quote_min", "delta_quote_max",
"close", "closed"],
"rows": [[1793750400000, 97.12, 85.31, 11.81, -4.06, 15.27, 8410,
10127740.0512, 8894144.2587, 1233595.7925, -423187.164, 1592311.0033,
104288.7, true]],
"next_cursor": null
}| Колонка | Що |
|---|---|
t |
початок вікна, мс |
buy, sell, delta |
покупки, продажі агресором і їхня різниця, монети |
delta_min, delta_max |
мінімум і максимум рухомої дельти всередині вікна, монети |
buy_quote … delta_quote_max |
те саме в грошах (валюта котирування); точність — 0,0001, без округлення до кроку ціни |
close |
ціна закриття вікна |
closed |
вікно закрите |
Вікна без жодної угоди не надходять: пропуск у часі — це тиша на ринку, а не втрата даних.
Відкриття та закриття позицій Hyperliquid
/v1/hyperliquid/footprintФутпринт NL/NS: на кожному рівні ціни Hyperliquid — наскільки зросли або скоротилися лонги і шорти, окремо у тейкера і у мейкера. Рахується за заливками ноди Hyperliquid: по позиції учасника до кожної заливки. Група тарифу — footprint.
| Параметр | Що |
|---|---|
instrument |
обов’язковий, перп Hyperliquid: hyperliquid:perp:BTC, ринок HIP-3 — hyperliquid:perp:AAPLUSDC.XYZ або коротше hyperliquid:perp:AAPL.XYZ. Інша біржа або спот — 400 unsupported_instrument |
tf |
вікно: 1m, 5m, 15m, 30m, 1h, 4h, 1d. За замовчуванням 1m. Секунд немає: інший крок — 400 bad_request з param: "tf" |
from |
початок, мс; вирівнюється вниз по вікну. За замовчуванням — 60 вікон назад від to |
to |
кінець, мс, не включно |
cursor |
курсор із next_cursor |
curl -s "https://market-api.lootx.trade/v1/hyperliquid/footprint?instrument=hyperliquid:perp:BTC&tf=1m&from=1794500100000&to=1794500220000" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"instrument": "hyperliquid:perp:BTC",
"tf": "1m",
"levels": {
"columns": ["ts", "price", "dl_taker", "ds_taker", "dl_maker", "ds_maker", "n_fills"],
"rows": [
[1794500100000, 68960.5, 0.001, 0.0, 0.0, 0.001, 4],
[1794500100000, 68961.0, -0.0005, 0.0003, 0.0008, 0.0, 2],
[1794500160000, 68960.0, 0.0, -0.0002, -0.0001, 0.0001, 2]
],
"next_cursor": null
},
"windows": {
"columns": ["ts", "closed"],
"rows": [[1794500100000, true], [1794500160000, false]],
"next_cursor": null
},
"asof_ms": 1794500205000,
"next_cursor": null
}| Колонка | Що |
|---|---|
ts |
початок вікна, мс |
price |
рівень ціни |
dl_taker, ds_taker |
зміна лонгів і шортів тейкерів на рівні, у монетах: плюс — відкрили, мінус — закрили |
dl_maker, ds_maker |
те саме у мейкерів |
n_fills |
скільки заливок на рівні; заливка — половина угоди, одна сторона матчу |
Три види NL/NS збираються з чотирьох колонок: по всіх учасниках — dl_taker + dl_maker, і це ж ds_taker + ds_maker — зміна відкритого інтересу на рівні; у тейкерів — dl_taker і ds_taker; у мейкерів — dl_maker і ds_maker. Грошей у відповіді немає: ціна й кількість — в одиницях інструмента.
windows— вікна зclosed:true— вікно закрите й більше не зміниться, у «зараз» може прийтиfalse.asof_ms— до якого моменту джерело записало повні хвилини.instrumentу відповіді — канонічне ім’я монети, а не написання запиту: наhyperliquid:perp:aapl.xyzприйдеhyperliquid:perp:AAPLUSDC.XYZ, наhyperliquid:perp:BTCUSDC—hyperliquid:perp:BTC.- Ім’я шлюзу перевіряє тільки за формою — латинські букви й цифри, до 32 знаків, у ринку HIP-3 дек через крапку. Чи є така монета на Hyperliquid, він не звіряє.
- Вікон на сторінку — до 2000, далі —
next_cursor. Одне вікно довше стелі рядків джерела —413 too_large, візьмітьtfменший. - Сум по майданчиках немає:
instruments=з двома й більше інструментами —400 bad_request.