← Volver a la documentación
LootX

Velas y series

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

1Velas y series

Velas con cualquier paso desde un segundo hasta un día y series del flujo de operaciones: CVD, delta, volumen, número de operaciones.

Velas

GET/v1/candles

Velas OHLCV con volumen de compras por separado. El paso es cualquier número con sufijo s, m, h, d, hasta un día: 1s, 15s, 1m, 5m, 1h, 4h, 1d.

Parámetro Qué
instrument obligatorio, venue:market:SYMBOL
tf paso de vela, por defecto 1m
from inicio de la ventana, ms, inclusivo. Por defecto to − limit × tf
to fin de la ventana, ms, no inclusivo. Por defecto, ahora
limit velas por página, 1–10 000, por defecto 1000
fill si rellenar intervalos vacíos con velas planas, por defecto true
cursor cursor de next_cursor
Shell
curl -s "https://market-api.lootx.trade/v1/candles?instrument=binance:perp:BTCUSDT&tf=5m&from=1793750400000&limit=2" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "tf": "5m",
  "columns": ["ts", "open", "high", "low", "close", "volume", "quote_volume",
              "buy_volume", "buy_quote_volume", "trades", "buy_trades"],
  "rows": [
    [1793750400000, 104250.5, 104301.2, 104190.0, 104288.7, 182.43, 19021884.31, 97.12, 10127740.05, 8410, 4522],
    [1793750700000, 104288.7, 104322.0, 104260.4, 104270.1, 133.06, 13878523.60, 61.88, 6454361.73, 6128, 2930]
  ],
  "next_cursor": "YzE6MTc5Mzc1MTAwMDAwMA",
  "coverage": { "oldest": 1792741800000, "newest": 1793754000000 }
}
Columna Qué
ts inicio de la vela, ms UTC
open, high, low, close precios en la moneda de cotización
volume, buy_volume todo el volumen y el volumen de compras agresoras, en monedas (en el canal candles del stream, el campo volume es diferente: en la moneda de cotización)
quote_volume, buy_quote_volume lo mismo en la moneda de cotización — dinero, sin redondear al paso de precio
trades, buy_trades número de operaciones, totales y de compra

Las ventas son volume − buy_volume, si se conoce el lado de todas las operaciones de la vela. En algunos exchanges no siempre se puede leer el lado de la operación; esas operaciones entran en volume, pero no en buy_volume, y la resta las contará como ventas. No hay una columna separada para ellas en la respuesta.

coverage es qué período existe en el almacenamiento para el instrumento: si pides antes de oldest, obtendrás una página vacía, no un error.

Un símbolo que no existe en las fuentes puede recibir 400 unsupported_instrument con param: "symbol", o también un 200 vacío: condiciones. Lo mismo en /v1/series.

Velas de segundo

Un paso menor a un minuto es un grupo de tarifa separado candles_1s. El plan puede cerrarlo (403 route_not_in_plan), limitarlo con su propio límite de solicitudes o con su propia profundidad de historial; todo esto actúa junto con los límites generales. Las velas de minuto y mayores son del grupo candles.

Series del flujo de operaciones

GET/v1/series

Una serie t, value por pasos: delta acumulada, delta del paso, volumen o número de operaciones. Grupo de tarifa: series.

Parámetro Qué
instrument obligatorio
metric obligatorio: cvd — delta acumulada desde el inicio de la ventana from; delta — compras menos ventas agresoras por paso; volume; trades_n — número de operaciones
unit quote (por defecto, en la moneda de cotización) o base (monedas). No lo pases con trades_n
tf paso, por defecto 1m. Menos de un minuto: historial de segundos del plan
from, to, limit, cursor como en velas; limit hasta 10 000, por defecto 1000
Shell
curl -s "https://market-api.lootx.trade/v1/series?instrument=binance:perp:BTCUSDT&metric=cvd&tf=1m&from=1793750400000&limit=3" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "metric": "cvd",
  "unit": "quote",
  "tf": "1m",
  "columns": ["t", "value"],
  "rows": [[1793750400000, 214877.31], [1793750460000, -51260.04], [1793750520000, -1830.66]],
  "next_cursor": "eyJ0IjoxNzkzNzUwNTgwMDAwfQ"
}

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