LootX

Footprint and delta

Updated November 18, 2026 This page as PDF

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

GET/v1/footprint

Footprint 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.

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 of 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 the trades the aggressor bought and sold, the same sides as bid_qty and ask_qty; when known, trades_buy + trades_sell = trades. null for both means there is no split: either history before sides were recorded, or a window 5m…1d that 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 with closed: false and 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

GET/v1/delta

Aggressor 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
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
}
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

GET/v1/hyperliquid/footprint

NL/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
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
}
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 with closed: true — window is closed and will not change, the “now” window may arrive with false. asof_ms — up to which moment the source recorded full minutes.
  • instrument in the response is the canonical coin name, not the request spelling: hyperliquid:perp:aapl.xyz will come back as hyperliquid: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 smaller tf.
  • No sums across venues: instruments= with two and more instruments — 400 bad_request.