← Volver a la documentación
LootX

Screener

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

1Screener

Métricas de cientos de instrumentos en una sola consulta: precio, cambio, volumen, tasa de financiación, OI y sus variaciones por ventana; referencia de todas las métricas.

Instantánea del screener

GET/v1/screener

Tabla «instrumento × métrica» por mercado: último precio, cambio en 24 h, volumen, tasa de financiación, OI y decenas más. Grupo de tarifa — screener.

Parámetro Qué
venue exchanges separados por coma, sin distinguir mayúsculas, el mismo conjunto que la suscripción de mercado: el screener no incluye Upbit. Por defecto, todos. Exchange desconocido — 400 bad_request con param: "venue", no «todos los exchanges»
market spot, perp separados por coma, sin distinguir mayúsculas. Otro valor — 400 bad_request
instruments conjunto exacto de instrumentos separados por coma, reglas abajo. Con él, venue y market no se leen. top_n también actúa aquí: para un conjunto de más de 100 instrumentos, pase top_n no menor que su tamaño, de lo contrario la respuesta se recorta silenciosamente
top_n primeros N por volumen diario, 1–2000, por defecto 100. 0 y valores mayores a 2000 se ajustan al límite
names nombres de columnas: long (por defecto: volume_24h_usd, oi_change_usd_5m, …) o short, claves cortas (v24, odu5, …). Otro valor — 400 bad_request
Shell
curl -s "https://market-api.lootx.trade/v1/screener?venue=binance&market=perp&top_n=2" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "ts": 1793750400000,
  "columns": ["instrument", "ts", "last_price", "change_24h_pct", "volume_24h_usd", "funding_rate", "open_interest"],
  "rows": [
    ["binance:perp:BTCUSDT", 1793750399870, 104250.5, 1.84, 18234455120.4, 0.0001, 8423311987.2],
    ["binance:perp:ETHUSDT", 1793750399912, 3712.44, -0.62, 9122870411.7, 0.000085, 4120098211.6]
  ],
  "next_cursor": null
}

Ejemplo recortado: la respuesta real incluye todas las métricas que la fuente conoce para el instrumento. Las métricas que el instrumento no tiene llegan como null.

Conjunto de instrumentos

  • El símbolo no se compara con el registro. El nombre pasó las comprobaciones siguientes, pero el screener no tiene el instrumento, incluso por un error tipográfico: no hay fila para él, respuesta 200. Si no se encontró ninguno, 200 con rows vacías: consulte /v1/instruments.
  • Forma de nombre incorrecta — 400 bad_instrument, toda la consulta.
  • 400 unsupported_instrument con param: "instrument", toda la consulta: el mercado no es spot ni perp; no se puede analizar la cotización del símbolo, como en okx:perp:BTC-USDT-SWAP; perpetuo con cotización que no es USDT, USDC ni USD, como en binance:perp:ETHBTC. Las dos últimas comprobaciones no aplican a los perpetuos de Hyperliquid.
  • El exchange en el nombre no se verifica: un exchange desconocido no produce un rechazo, sino la ausencia de fila.
  • El screener no tiene deck: hay una fila por todos los decks de la moneda, y en la respuesta se nombra sin deck. hyperliquid:perp:AAPLUSDC.XYZ y hyperliquid:perp:AAPLUSDC son una sola fila hyperliquid:perp:AAPLUSDC.
  • Valor vacío instruments= — lo mismo que sin el parámetro: todo el mercado considerando venue y market.

Referencia de métricas

GET/v1/screener/metrics

Qué columnas tiene el screener: clave corta, nombre largo, unidad, ventana, grupo y descripción. Es estático: puede cachearlo en su lado. Mismo grupo screener.

JSON
{
  "columns": ["key", "name", "unit", "window", "group", "description"],
  "rows": [
    ["odu5", "oi_change_usd_5m", "usd", "5m", "oi", "Cambio del interés abierto en 5 minutos en dólares: OI actual − OI hace 5 minutos (la referencia se busca por tiempo)."]
  ]
}

Si la fuente introduce una métrica nueva antes de que aparezca en la referencia, esta llega bajo su clave corta tal cual: no descarte silenciosamente columnas con nombre desconocido.

Para el screener en vivo use el canal screener en WebSocket: las actualizaciones llegan solo por las métricas que cambiaron. Para todo el mercado a la vez, use la suscripción a todo el mercado con filtros por exchanges, mercados y métricas.

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