Instrumentos y estado
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
/v1/instrumentsTodos 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 |
curl -s "https://market-api.lootx.trade/v1/instruments?venue=binance&market=perp&q=BTC" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"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
/v1/statusSi 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.
{
"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