Inicio rápido
1Inicio rápido
Clave, URL, primera consulta: velas de BTCUSDT de Binance en cinco minutos.
La API de datos de mercado de LootX entrega los mismos datos con los que funciona el terminal: velas desde un segundo, cintas de operaciones, footprint, mapa de calor del libro de órdenes, interés abierto, tasa de financiación, muros de liquidez y screener. Todos los exchanges, a través de una sola URL y una sola clave, con los mismos nombres de instrumentos y un mismo formato de tiempo.
En cinco minutos
Obtén la clave
Abre Panel → API keys y haz clic en Crear clave. Dale a la clave un nombre descriptivo, por ejemplo, el nombre del script o del servidor donde va a vivir.
La clave se ve como lx_live_ más 43 caracteres. Se muestra una sola vez: guárdala en un gestor de contraseñas o en una variable de entorno. Si la pierdes, revócala y emite una nueva.
La clave funciona mientras la cuenta tenga un plan de API activo. El plan se elige en la misma página, si está disponible para compra, o lo asigna un administrador de LootX.
Recuerda la URL y cómo enviar la clave
La URL base es https://market-api.lootx.trade. La clave se envía en un encabezado:
Authorization: Bearer lx_live_...o X-API-Key: lx_live_.... Nunca pongas la clave en la URL: los query strings quedan en los logs de proxies y navegadores, por lo que una solicitud con la clave en la URL recibe un 400 key_in_query.
Haz la primera consulta
Las últimas tres velas de un minuto del contrato perpetuo BTCUSDT en Binance (la última es el minuto actual, aún no cerrada):
export LOOTX_API_KEY="lx_live_..."
curl -s "https://market-api.lootx.trade/v1/candles?instrument=binance:perp:BTCUSDT&tf=1m&limit=3" \
-H "Authorization: Bearer $LOOTX_API_KEY"La respuesta es una tabla por columnas: los nombres en columns, las filas en rows, los valores en el mismo orden (los números siguientes son de ejemplo):
{
"instrument": "binance:perp:BTCUSDT",
"tf": "1m",
"columns": ["ts", "open", "high", "low", "close", "volume", "quote_volume",
"buy_volume", "buy_quote_volume", "trades", "buy_trades"],
"rows": [
[1793750400000, 104250.5, 104262.0, 104241.1, 104255.3, 41.27, 4302517.62, 22.91, 2388563.12, 1824, 1003],
[1793750460000, 104255.3, 104270.0, 104249.8, 104266.9, 28.04, 2923450.40, 15.33, 1598336.46, 1310, 702],
[1793750520000, 104266.9, 104268.4, 104230.2, 104233.0, 36.58, 3813166.95, 14.02, 1461540.90, 1597, 688]
],
"next_cursor": null,
"coverage": { "oldest": 1792741800000, "newest": 1793750520000 }
}ts: inicio de la vela en milisegundos UTC.volume: volumen en monedas;quote_volume: en la moneda de cotización (en pares USDT, son dólares).next_cursor: null: no hay más páginas; de lo contrario, pásalo comocursor=(cómo paginar).coverage: qué periodo hay en total en el almacén para ese instrumento. El historial de velas en la API comienza el 23.10.2026 (más detalles en Velas).
Si algo sale mal
Cualquier error del gateway es un código HTTP y un JSON con un código de máquina. Sin clave: 401 con encabezado WWW-Authenticate: Bearer realm="lootx" y cuerpo:
{
"error": {
"code": "missing_key",
"message": "se necesita clave: encabezado Authorization: Bearer <clave> o X-API-Key",
"request_id": "a553713a48d85b96-VIE",
"docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#missing_key"
}
}Analiza el campo code, no el texto message: el texto puede cambiar. La API solo acepta GET (y HEAD, OPTIONS): otro método recibirá 405 method_not_allowed. Envía request_id a soporte si el error no está claro: con él encontramos la solicitud. Todos los códigos están en la sección Errores.
Qué sigue
Cómo nombrar instrumentos, en qué se mide el tiempo y cómo obtener la siguiente página.
Velas y seriesVelas desde un segundo hasta un día, CVD, delta y volumen junto a ellas.
Streams WebSocketMuros de liquidez, screener, operaciones, OI y velas de un segundo en tiempo real.
Límites y planesQué limita el plan, qué encabezados mirar y qué hacer ante un 429.
La especificación interactiva está en market-api.lootx.trade/docs; la legible por máquinas, en /v1/openapi.json (OpenAPI 3.1, no requiere clave).
https://docs.lootx.trade/es/market-api/getting-started