← Volver a la documentación
LootX

Instrumentos y estado

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

1Instrumentos y estado

Qué instrumentos existen y en qué tipos de datos — registro /v1/instruments; si las fuentes están sanas — /v1/status.

Grupo de tarifa — instruments. Empiece por el registro: muestra cómo se llama el instrumento y en qué rutas hay datos para él.

Registro de instrumentos

GET/v1/instruments

Todos los instrumentos de todas las fuentes con un único nombre canónico. La columna sources indica dónde está disponible: candles, footprint, densities, screener.

Parámetro Qué hace
venue exchange: binance, okx, …
market spot o perp. Futuros con fecha y opciones aún no están disponibles
source solo instrumentos con datos en este tipo: candles, footprint, densities, screener
q subcadena del símbolo, sin distinguir mayúsculas: q=btc
limit filas por página, 1–10 000, por defecto 1000
cursor cursor de next_cursor
Shell
curl -s "https://market-api.lootx.trade/v1/instruments?venue=binance&market=perp&q=BTC" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "columns": ["instrument", "venue", "market", "symbol", "sources"],
  "rows": [
    ["binance:perp:BTCUSDT", "binance", "perp", "BTCUSDT", ["candles", "footprint", "densities", "screener"]],
    ["binance:perp:BTCUSDC", "binance", "perp", "BTCUSDC", ["candles", "footprint", "densities"]]
  ],
  "next_cursor": null,
  "updated_at": 1793750400000
}

updated_at — cuándo recibió el gateway por última vez la lista de al menos una fuente, 0 — todavía no. El registro se actualiza cada 5 minutos y muestra lo que las fuentes están recopilando en este momento, no todos los listados de los exchanges. Un par nuevo aparecerá cuando una fuente empiece a recopilarlo; en algunas fuentes esto ocurre después de un umbral de volumen negociado diario.

Estado de las fuentes

GET/v1/status

Si las fuentes de datos detrás del gateway responden y con qué latencia. Útil para su propio monitoreo: si ok: false, son esperables errores 502/504 en las rutas de esa fuente.

JSON
{
  "ok": true,
  "ts": 1793750400000,
  "upstreams": [
    { "name": "data", "ok": true, "latency_ms": 12, "http_status": 200 },
    { "name": "clusters", "ok": true, "latency_ms": 18, "http_status": 200 }
  ]
}

/v1/status no tiene tabla, por lo tanto no hay CSV — solo JSON y protobuf. La ruta no pertenece a ningún grupo de tarifa y consume solo los límites generales.

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