Screener
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
/v1/screenerTabla «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 |
curl -s "https://market-api.lootx.trade/v1/screener?venue=binance&market=perp&top_n=2" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"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,200conrowsvacías: consulte/v1/instruments. - Forma de nombre incorrecta —
400 bad_instrument, toda la consulta. 400 unsupported_instrumentconparam: "instrument", toda la consulta: el mercado no esspotniperp; no se puede analizar la cotización del símbolo, como enokx:perp:BTC-USDT-SWAP; perpetuo con cotización que no esUSDT,USDCniUSD, como enbinance: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.XYZyhyperliquid:perp:AAPLUSDCson una sola filahyperliquid:perp:AAPLUSDC. - Valor vacío
instruments=— lo mismo que sin el parámetro: todo el mercado considerandovenueymarket.
Referencia de métricas
/v1/screener/metricsQué 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.
{
"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.