LootX

Footprint y delta

Actualizado 18 de noviembre de 2026 Esta página en PDF

Clústeres — volumen de compras y ventas en cada nivel de precio por ventanas; delta del agresor por ventanas con extremos dentro de la ventana; apertura y cierre de posiciones por niveles de precio Hyperliquid.

Footprint

GET/v1/footprint

Clústeres: para cada ventana de tiempo — volumen por niveles de precio, operaciones separadas por bid y ask. Grupo de tarifa — footprint.

Parámetro Qué
instrument obligatorio
tf ventana del clúster: 30s, 1m, 5m, 15m, 30m, 1h, 4h, 1d. Por defecto 1m
from inicio, ms. Por defecto — 60 ventanas atrás desde to
to fin, ms, no inclusivo
cursor cursor desde next_cursor

En la respuesta hay dos tablas: levels — niveles de precio, windows — las propias ventanas.

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 del nivel — inicio de la ventana a la que pertenece;
  • bid_qty — volumen donde el agresor compró, ask_qty — donde el agresor vendió; en monedas. Los nombres indican el lado del agresor, no el lado del libro en el que recayó la operación: verifícalo si trasladas cálculos desde otra plataforma;
  • trades_buy, trades_sell — cuántas de las trades operaciones compró y vendió el agresor; mismos lados que bid_qty y ask_qty; cuando se conocen, trades_buy + trades_sell = trades. null en ambas — no hay desglose: historial anterior a que se empezaran a registrar los lados, o una ventana 5m…1d que contiene ese minuto. Esto no significa “ninguna compra”. Las columnas van al final de la fila; las primeras cinco mantienen su posición;
  • closed: true — la ventana está cerrada y no cambiará. La última ventana en “ahora” puede llegar con closed: false y crecer.

Ventanas por página — hasta 2000. CSV — una sola tabla, por eso para footprint elige cuál exportar: ?format=csv&table=levels o table=windows.

Delta

GET/v1/delta

Delta del agresor por ventanas: compras, ventas, su diferencia y extremos de la delta acumulada dentro de la ventana — en monedas y en dinero. Grupo de tarifa — delta.

Parámetro Qué
instrument obligatorio
tf ventana: 1s, 30s, 1m, 5m, 15m, 30m, 1h, 4h, 1d. Por defecto 1m
from inicio, ms; se alinea hacia abajo en la ventana. Por defecto — limit ventanas atrás desde to
to fin, ms, no inclusivo
limit ventanas por página, 1–10 000, por defecto 1000
cursor cursor desde 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
}
Columna Qué
t inicio de la ventana, ms
buy, sell, delta compras, ventas por agresor y su diferencia, en monedas
delta_min, delta_max mínimo y máximo de la delta acumulada dentro de la ventana, en monedas
buy_quote … delta_quote_max lo mismo en dinero (moneda de cotización); precisión — 0,0001, sin redondeo al paso de precio
close precio de cierre de la ventana
closed ventana cerrada

No se envían ventanas sin una sola operación: una omisión en el tiempo es silencio en el mercado, no pérdida de datos.

Apertura y cierre de posiciones Hyperliquid

GET/v1/hyperliquid/footprint

Footprint NL/NS: en cada nivel de precio en Hyperliquid — cuánto aumentaron o disminuyeron los largos y cortos, por separado para taker y maker. Se calcula a partir de los rellenos del nodo Hyperliquid: según la posición del participante antes de cada relleno. Grupo de tarifa — footprint.

Parámetro Qué
instrument obligatorio, perp de Hyperliquid: hyperliquid:perp:BTC, mercado HIP-3 — hyperliquid:perp:AAPLUSDC.XYZ o abreviado hyperliquid:perp:AAPL.XYZ. Otro exchange o spot — 400 unsupported_instrument
tf ventana: 1m, 5m, 15m, 30m, 1h, 4h, 1d. Por defecto 1m. No hay segundos: otro paso — 400 bad_request con param: "tf"
from inicio, ms; se alinea hacia abajo en la ventana. Por defecto — 60 ventanas atrás desde to
to fin, ms, no inclusivo
cursor cursor desde 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
}
Columna Qué
ts inicio de la ventana, ms
price nivel de precio
dl_taker, ds_taker cambio en los largos y cortos de los takers en el nivel, en monedas: positivo — abrieron, negativo — cerraron
dl_maker, ds_maker lo mismo para los makers
n_fills cuántos rellenos en el nivel; un relleno es la mitad de una operación, un lado del match

Tres tipos NL/NS se componen a partir de cuatro columnas: para todos los participantes — dl_taker + dl_maker, y lo mismo ds_taker + ds_maker — cambio del interés abierto en el nivel; para los takers — dl_taker y ds_taker; para los makers — dl_maker y ds_maker. No hay dinero en la respuesta: precio y cantidad están en unidades del instrumento.

  • windows — ventanas con closed: true — ventana cerrada y no cambiará, en “ahora” puede venir false. asof_ms — hasta qué momento la fuente grabó minutos completas.
  • instrument en la respuesta — el nombre canónico de la moneda, no la forma de la consulta: a hyperliquid:perp:aapl.xyz llegará hyperliquid:perp:AAPLUSDC.XYZ, a hyperliquid:perp:BTCUSDC — hyperliquid:perp:BTC.
  • El nombre del gateway se valida solo por forma — letras latinas y dígitos, hasta 32 caracteres, para mercados HIP-3 el dex va después del punto. No verifica si existe esa moneda en Hyperliquid.
  • Ventanas por página — hasta 2000, más allá — next_cursor. Una ventana más larga que el tope de filas de la fuente — 413 too_large, use un tf menor.