Velas 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
/v1/candlesVelas 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 |
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"{
"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
/v1/seriesUna 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 |
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"{
"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"
}