Muros 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
/v1/densitiesInstantá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 |
curl -s "https://market-api.lootx.trade/v1/densities?coins=BTC&market=perp&min_usd=1000000&limit=2" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"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
/v1/densities/historyMuros 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 |
{
"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
/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).