Футпринт и дельта
Кластеры — объём покупок и продаж на каждом уровне цены по окнам; дельта агрессора по окнам с экстремумами внутри окна; открытие и закрытие позиций по уровням цены 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.