Свічки та ряди
1Свічки та ряди
Свічки з будь-яким кроком від секунди до доби та ряди потоку угод — CVD, дельта, об'єм, кількість угод.
Свічки
/v1/candlesСвічки OHLCV з об’ємом покупок окремо. Крок — будь-яке число із суфіксом s, m, h, d, до доби: 1s, 15s, 1m, 5m, 1h, 4h, 1d.
| Параметр | Що |
|---|---|
instrument |
обов’язковий, venue:market:SYMBOL |
tf |
крок свічки, за замовчуванням 1m |
from |
початок вікна, мс, включно. За замовчуванням to − limit × tf |
to |
кінець вікна, мс, не включно. За замовчуванням — зараз |
limit |
свічок на сторінку, 1–10 000, за замовчуванням 1000 |
fill |
чи заповнювати порожні інтервали пласкими свічками, за замовчуванням true |
cursor |
курсор з 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 }
}| Колонка | Що |
|---|---|
ts |
початок свічки, мс UTC |
open, high, low, close |
ціни у валюті котирування |
volume, buy_volume |
весь об’єм і об’єм покупок агресором, у монетах (у каналі candles потоку поле volume інше — у валюті котирування) |
quote_volume, buy_quote_volume |
те саме у валюті котирування — гроші, без округлення до кроку ціни |
trades, buy_trades |
кількість угод, всього та покупок |
Продажі — volume − buy_volume, якщо сторону відомо у всіх угод свічки. У частини бірж сторону угоди видно не завжди; такі угоди входять у volume, але не в buy_volume, і віднімання зарахує їх у продажі. Окремої колонки для них у відповіді немає.
coverage — який період взагалі є у сховищі за інструментом: запитавши раніше oldest, ви отримаєте порожню сторінку, а не помилку.
Символ, якого немає у джерел, може отримати 400 unsupported_instrument з param: "symbol", а може й порожній 200: умови. Те саме у /v1/series.
Секундні свічки
Крок менше хвилини — окрема група тарифу candles_1s. Тариф може закрити її (403 route_not_in_plan), обмежити своїм лімітом запитів або своєю глибиною історії — все це діє разом із загальними лімітами. Хвилинні та більші свічки — група candles.
Ряди потоку угод
/v1/seriesОдин ряд t, value за кроками: накопичена дельта, дельта кроку, об’єм або кількість угод. Група тарифу — series.
| Параметр | Що |
|---|---|
instrument |
обов’язковий |
metric |
обов’язковий: cvd — накопичена дельта від початку вікна from; delta — покупки мінус продажі агресором за крок; volume; trades_n — кількість угод |
unit |
quote (за замовчуванням, у валюті котирування) або base (монети). У trades_n не передавайте |
tf |
крок, за замовчуванням 1m. Менше хвилини — секундна історія тарифу |
from, to, limit, cursor |
як у свічок; limit до 10 000, за замовчуванням 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"
}https://docs.lootx.trade/uk/market-api/candles