Свечи и ряды
Свечи с любым шагом от одной секунды до суток и ряды потока сделок — 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"
}