Footprint and delta
Footprint clusters — buy and sell volume at each price level per window; aggressor delta per window with running-delta extremes inside the window; Hyperliquid position opens and closes by price level.
Footprint
/v1/footprintFootprint clusters: for each time window — volume by price levels, separately trades on the bid and on the ask. Rate-limit group — footprint.
| Parameter | What |
|---|---|
instrument |
required |
tf |
cluster window: 30s, 1m, 5m, 15m, 30m, 1h, 4h, 1d. Default 1m |
from |
start, ms. Default — 60 windows before to |
to |
end, ms, exclusive |
cursor |
cursor from next_cursor |
The response contains two tables: levels — price levels, windows — the windows themselves.
{
"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
}tsof a level — the start of the window it belongs to;bid_qty— volume where the aggressor bought,ask_qty— where the aggressor sold; in coins. Names follow the aggressor side, not the side of the order book that received the trade: check this if you port calculations from another platform;trades_buy,trades_sell— how many of thetradesthe aggressor bought and sold, the same sides asbid_qtyandask_qty; when known,trades_buy + trades_sell = trades.nullfor both means there is no split: either history before sides were recorded, or a window5m…1dthat contains such a minute. This is not “no buys”. The columns are placed at the end of the row; the first five remain in their previous positions;closed: true— the window is closed and will not change. The last “now” window may arrive withclosed: falseand grow.
Windows per page — up to 2000. CSV is a single table, so for footprint pick it with ?format=csv&table=levels or table=windows.
Delta
/v1/deltaAggressor delta by windows: buys, sells, their difference and running-delta extremes inside the window — in coins and in quote (quote currency). Rate-limit group — delta.
| Parameter | What |
|---|---|
instrument |
required |
tf |
window: 1s, 30s, 1m, 5m, 15m, 30m, 1h, 4h, 1d. Default 1m |
from |
start, ms; aligned down to the window. Default — limit windows before to |
to |
end, ms, exclusive |
limit |
windows per page, 1–10 000, default 1000 |
cursor |
cursor from 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
}| Column | What |
|---|---|
t |
start of the window, ms |
buy, sell, delta |
buys, sells by the aggressor and their difference, in coins |
delta_min, delta_max |
running-delta minimum and maximum inside the window, in coins |
buy_quote … delta_quote_max |
the same in quote (quote currency); precision — 0,0001, without rounding to the price tick |
close |
window close price |
closed |
window is closed |
Windows with no trades do not appear: a gap in time is market silence, not missing data.
Hyperliquid position opens and closes
/v1/hyperliquid/footprintNL/NS footprint: at each Hyperliquid price level — how much longs and shorts grew or shrank, separately for taker and maker. Calculated from Hyperliquid node fills: by the participant’s position before each fill. Rate-limit group — footprint.
| Parameter | What |
|---|---|
instrument |
required, Hyperliquid perp: hyperliquid:perp:BTC, HIP-3 market — hyperliquid:perp:AAPLUSDC.XYZ or shorter hyperliquid:perp:AAPL.XYZ. Other exchange or spot — 400 unsupported_instrument |
tf |
window: 1m, 5m, 15m, 30m, 1h, 4h, 1d. Default 1m. Seconds are not available: a different step — 400 bad_request with param: "tf" |
from |
start, ms; aligned down to the window. Default — 60 windows before to |
to |
end, ms, exclusive |
cursor |
cursor from 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
}| Column | What |
|---|---|
ts |
start of the window, ms |
price |
price level |
dl_taker, ds_taker |
change in taker longs and shorts at the level, in coins: positive — opened, negative — closed |
dl_maker, ds_maker |
same for makers |
n_fills |
number of fills at the level; a fill is half a trade, one side of a match |
Three NL/NS types are built from the four columns: for all participants — dl_taker + dl_maker, and likewise ds_taker + ds_maker — the change in open interest at the level; for takers — dl_taker and ds_taker; for makers — dl_maker and ds_maker. There is no money in the response: price and amount are in units of the instrument.
windows— windows withclosed:true— window is closed and will not change, the “now” window may arrive withfalse.asof_ms— up to which moment the source recorded full minutes.instrumentin the response is the canonical coin name, not the request spelling:hyperliquid:perp:aapl.xyzwill come back ashyperliquid:perp:AAPLUSDC.XYZ,hyperliquid:perp:BTCUSDC→hyperliquid:perp:BTC.- The gateway name is validated only by form — Latin letters and digits, up to 32 characters; for HIP-3 markets the DEC comes after a dot. It does not verify whether the coin actually exists on Hyperliquid.
- Windows per page — up to 2000, after that use
next_cursor. A single window longer than the source’s row limit —413 too_large, pick a smallertf. - No sums across venues:
instruments=with two and more instruments —400 bad_request.