← Volver a la documentación
LootX

Muros de liquidez e icebergs

Generado: 2026-11-21 docs.lootx.trade
Справочник

1Muros de liquidez e icebergs

Grandes muros de órdenes límite en el libro de órdenes ahora mismo, historial de muros cancelados y absorbidos (se conserva máximo 90 días), icebergs y absorciones.

Muro de liquidez — una orden límite grande (muro), notablemente mayor que el volumen habitual en los niveles vecinos. El servicio de muros monitorea los libros de órdenes de los exchanges y entrega los muros de inmediato con el tamaño en dólares, la distancia al precio y la edad.

Muros en vivo

GET/v1/densities

Instantánea actual de los muros: por un instrumento o como resumen del mercado. Grupo de tarifa — densities.

Parámetro Qué
instrument un instrumento. Sin él — resumen del mercado con los filtros de abajo
venue exchanges separados por coma: binance,bybit
market mercados separados por coma: spot, perp
coins monedas separadas por coma: BTC,ETH — no símbolos
side bid o ask
min_usd tamaño mínimo del muro, $
max_dist_bp distancia máxima al medio del libro, puntos básicos: 200 = ±2 %
limit cuántos muros, por defecto 200
sort usd (por defecto), age, dist
Shell
curl -s "https://market-api.lootx.trade/v1/densities?coins=BTC&market=perp&min_usd=1000000&limit=2" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "ts": 1793750400000,
  "columns": ["instrument", "side", "price", "qty", "usd", "dist_bp", "first_ts", "age_ms",
              "peak_usd", "state", "touched", "size", "score", "agg", "wall_id"],
  "rows": [
    ["binance:perp:BTCUSDT", "bid", 103500.0, 41.8, 4326300.0, -72, 1793741112000, 9288000,
     4512000.0, "live", false, "strong", 2.37, "tick", "11658847687750313317"]
  ],
  "next_cursor": null
}
Columna Qué
side bid — compra, ask — venta
price, qty, usd precio, volumen en monedas y tamaño del muro en dólares
dist_bp distancia al medio del libro con signo, p. b.: menos — por debajo del medio (normalmente bids), más — por encima (asks). El filtro max_dist_bp compara el valor absoluto
first_ts, age_ms cuándo apareció el muro y cuánto tiempo lleva
peak_usd mayor tamaño del muro durante su vida
state live — se mantiene sin cambios notables, updated — el tamaño cambió notablemente desde el último corte
touched al precio del muro ya hubo operaciones que lo están absorbiendo
size normal, weak, optimal, strong — escalón de tamaño relativo a la liquidez del par; normal — hay muro, pero por debajo del escalón débil
score medida de magnitud: 1 — umbral optimal, 2 — umbral strong, 0 — no se calculó
agg tick — muro en un solo nivel, natr — niveles agrupados por volatilidad
wall_id número del muro como string: es un número de 64 bits, en JavaScript no cabe en number sin pérdidas

El resumen está ordenado por usd, ts — momento de la instantánea. La instantánea es en vivo: los muros no tienen caché, cada solicitud es el estado fresco. Para seguimiento continuo tome el canal densities en WebSocket: por lista de instrumentos o todo el mercado con filtros. Los cambios llegan solos, sin polling; los bytes de los frames van al volumen diario junto con REST.

Historial de muros

GET/v1/densities/history

Muros cerrados: cancelados (pulled) y absorbidos por operaciones (eaten). Se conservan máximo 90 días. Grupo de tarifa — densities_history.

Parámetro Qué
instrument obligatorio
from inicio por momento de aparición del muro, ms. Por defecto — un día antes de to
to fin, ms, no incluido
kind pulled, eaten o ambos separados por coma (por defecto)
limit muros por página, 1–10 000, por defecto 1000
cursor cursor: las páginas van de más recientes a más antiguos
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "columns": ["t", "side", "kind", "price", "qty_open", "qty_close", "usd_open", "usd_peak",
              "end_ts", "duration_ms", "dist_bp_open", "mid_at_close", "touched", "size"],
  "rows": [
    [1793741112000, "bid", "eaten", 103500.0, 41.8, 0.0, 4326300.0, 4512000.0,
     1793752004000, 10892000, -72, 103498.6, true, "S"]
  ],
  "next_cursor": null
}

t — aparición del muro, end_ts — cuándo desapareció; qty_open/qty_close — volumen al inicio y al final, mid_at_close — medio del libro en el momento del cierre. size en el historial es un código corto: "" — sin escalón, W — weak, O — optimal, S — strong.

Al historial se escriben muros del libro comprimido (agg = natr), no de niveles individuales: el precio y el tamaño no coinciden con los muros de la instantánea en vivo (allí por defecto tick), y no hay wall_id en el historial — no se puede vincular un muro cerrado con uno vivo por el número.

Icebergs y absorciones

GET/v1/icebergs

Órdenes ocultas que se rellenan por partes (iceberg) y niveles que absorben el flujo del mercado (absorption). Grupo de tarifa — icebergs.

Parámetro Qué
instrument un instrumento. Sin él — por el mercado con filtros
venue, market, coins, side filtros, como en muros; coins — hasta 100
kind iceberg, absorption o all (por defecto)
min_usd volumen oculto ejecutado mínimo, $
state active (por defecto — en curso), ended (terminados) o all
limit 1–5000, por defecto 200

Columnas: instrument, id (como string — número de 64 bits), side, kind, price, first_ts, last_ts, trades, executed_qty, hidden_qty, visible_max, clip_qty (monedas), executed_usd, hidden_usd ($; el volumen oculto es una estimación inferior), refills, end (null — sigue en curso; si no, idle, broken o reset).

https://docs.lootx.trade/es/market-api/densities