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.