Footprint y delta
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
/v1/footprintClú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.
{
"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
}tsdel 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 lastradesoperaciones compró y vendió el agresor; mismos lados quebid_qtyyask_qty; cuando se conocen,trades_buy + trades_sell = trades.nullen ambas — no hay desglose: historial anterior a que se empezaran a registrar los lados, o una ventana5m…1dque 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 conclosed: falsey 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
/v1/deltaDelta 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 |
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
}| 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
/v1/hyperliquid/footprintFootprint 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 |
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
}| 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 conclosed:true— ventana cerrada y no cambiará, en “ahora” puede venirfalse.asof_ms— hasta qué momento la fuente grabó minutos completas.instrumenten la respuesta — el nombre canónico de la moneda, no la forma de la consulta: ahyperliquid:perp:aapl.xyzllegaráhyperliquid:perp:AAPLUSDC.XYZ, ahyperliquid: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 untfmenor.