LootX

Футпринт і дельта

Оновлено 18 листопада 2026 р. Ця сторінка у PDF

Кластери — обсяг покупок і продажів на кожному рівні ціни за вікнами; дельта агресора за вікнами з екстремумами всередині вікна; відкриття й закриття позицій за рівнями ціни Hyperliquid.

Футпринт

GET/v1/footprint

Кластери: для кожного вікна часу — обсяг по рівням ціни, окремо угоди по біду й по аску. Група тарифу — footprint.

Параметр Що
instrument обов’язковий
tf вікно кластера: 30s, 1m, 5m, 15m, 30m, 1h, 4h, 1d. За замовчуванням 1m
from початок, мс. За замовчуванням — 60 вікон назад від to
to кінець, мс, не включно
cursor курсор із next_cursor

В відповіді дві таблиці: levels — рівні ціни, windows — самі вікна.

JSON
{
  "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.

Дельта

GET/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
Shell
curl -s "https://market-api.lootx.trade/v1/delta?instrument=binance:perp:BTCUSDT&tf=5m&limit=1" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "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

GET/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
Shell
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"
JSON
{
  "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.