Candles and series
Candles with any step from one second to a day, plus trade-flow series — CVD, delta, volume, trade count.
Candles
/v1/candlesOHLCV candles with buy volume broken out separately. Step — any number with a suffix s, m, h, d, up to one day: 1s, 15s, 1m, 5m, 1h, 4h, 1d.
| Parameter | What it is |
|---|---|
instrument |
required, venue:market:SYMBOL |
tf |
candle step, default 1m |
from |
window start, ms, inclusive. Defaults to to − limit × tf |
to |
window end, ms, exclusive. Defaults to now |
limit |
candles per page, 1–10,000, default 1000 |
fill |
whether to fill empty intervals with flat candles, default true |
cursor |
cursor from 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 }
}| Column | What it is |
|---|---|
ts |
candle start, ms UTC |
open, high, low, close |
prices in quote currency |
volume, buy_volume |
total volume and aggressor buy volume, in coins (in the candles stream channel the volume field is different — in quote currency) |
quote_volume, buy_quote_volume |
same in quote currency — money, without rounding to price step |
trades, buy_trades |
trade count, total and buys |
Sells are volume − buy_volume, if the side is known for all trades in the candle. On some exchanges the trade side is not always readable; such trades go into volume but not buy_volume, and subtracting will count them as sells. There is no separate column for them in the response.
coverage — what period exists in storage for the instrument at all: requesting earlier than oldest gives you an empty page, not an error.
A symbol that sources don’t have can get 400 unsupported_instrument with param: "symbol", or an empty 200: conditions. Same for /v1/series.
Second candles
A step under one minute is a separate rate-limit group candles_1s. Your plan may close it (403 route_not_in_plan), restrict it with its own request limit or its own history depth — all of that applies together with the general limits. Minute and larger candles are the candles group.
Trade flow series
/v1/seriesOne series t, value by steps: cumulative delta, step delta, volume or trade count. Rate-limit group — series.
| Parameter | What it is |
|---|---|
instrument |
required |
metric |
required: cvd — cumulative delta from the start of the from window; delta — aggressor buys minus sells per step; volume; trades_n — trade count |
unit |
quote (default, in quote currency) or base (coins). Don’t pass for trades_n |
tf |
step, default 1m. Under a minute — second history of the plan |
from, to, limit, cursor |
same as candles; limit up to 10,000, default 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"
}