Быстрый старт
Ключ, адрес, первый запрос — свечи BTCUSDT с Binance за пять минут.
API рыночных данных LootX отдаёт те же данные, на которых работает терминал: свечи от одной секунды, ленты сделок, футпринт, тепловую карту стакана, открытый интерес, фандинг, плотности и скринер. Все биржи — через один адрес и один ключ, с одинаковыми именами инструментов и одним форматом времени.
За пять минут
Получите ключ
Откройте Кабинет → API-ключи и нажмите Создать ключ. Дайте ключу понятное имя — например, по названию скрипта или сервера, где он будет жить.
Ключ выглядит как lx_live_ и ещё 43 знака. Он показывается один раз: сохраните его в менеджер паролей или в переменную окружения. Потеряли — отзовите ключ и выпустите новый.
Ключ работает, пока у аккаунта есть действующий API-тариф. Тариф выбирается на той же странице, если он открыт для покупки, или его назначает администратор LootX.
Запомните адрес и способ передать ключ
Базовый адрес — https://market-api.lootx.trade. Ключ передаётся заголовком:
Authorization: Bearer lx_live_...или X-API-Key: lx_live_.... Ключ никогда не кладётся в адрес: строки запросов оседают в логах прокси и браузеров, поэтому запрос с ключом в адресе получает 400 key_in_query.
Сделайте первый запрос
Три последние минутные свечи бессрочного контракта BTCUSDT на Binance (последняя — текущая минута, она ещё не закрыта):
export LOOTX_API_KEY="lx_live_..."
curl -s "https://market-api.lootx.trade/v1/candles?instrument=binance:perp:BTCUSDT&tf=1m&limit=3" \
-H "Authorization: Bearer $LOOTX_API_KEY"Ответ — таблица колонками: имена в columns, строки в rows, значения в том же порядке (числа ниже — для примера):
{
"instrument": "binance:perp:BTCUSDT",
"tf": "1m",
"columns": ["ts", "open", "high", "low", "close", "volume", "quote_volume",
"buy_volume", "buy_quote_volume", "trades", "buy_trades"],
"rows": [
[1793750400000, 104250.5, 104262.0, 104241.1, 104255.3, 41.27, 4302517.62, 22.91, 2388563.12, 1824, 1003],
[1793750460000, 104255.3, 104270.0, 104249.8, 104266.9, 28.04, 2923450.40, 15.33, 1598336.46, 1310, 702],
[1793750520000, 104266.9, 104268.4, 104230.2, 104233.0, 36.58, 3813166.95, 14.02, 1461540.90, 1597, 688]
],
"next_cursor": null,
"coverage": { "oldest": 1792741800000, "newest": 1793750520000 }
}ts— начало свечи в миллисекундах UTC;volume— объём в монетах,quote_volume— в валюте котировки (у USDT-пар это доллары);next_cursor: null— больше страниц нет; иначе передайте его какcursor=(как листать);coverage— какой период вообще есть в хранилище по этому инструменту. История свечей в API начинается 23.10.2026 (подробнее — в Свечах).
Если что-то не так
Любая ошибка шлюза — HTTP-код и JSON с машинным кодом. Без ключа — 401 с заголовком WWW-Authenticate: Bearer realm="lootx" и телом:
{
"error": {
"code": "missing_key",
"message": "нужен ключ: заголовок Authorization: Bearer <ключ> или X-API-Key",
"request_id": "a553713a48d85b96-VIE",
"docs_url": "https://docs.lootx.trade/ru/market-api/error-codes#missing_key"
}
}Разбирайте поле code, а не текст message — текст может меняться. API читает только GET (и HEAD, OPTIONS): другой метод получит 405 method_not_allowed. request_id пришлите в поддержку, если ошибка непонятна: по нему мы найдём запрос. Все коды — в разделе Ошибки.
Что дальше
Как называть инструменты, в чём считается время и как получить следующую страницу.
Свечи и рядыСвечи с шагом от секунды до суток, CVD, дельта и объём рядом.
Потоки WebSocketПлотности, скринер, сделки, OI и секундные свечи в реальном времени.
Лимиты и тарифыЧто ограничивает тариф, какие заголовки смотреть и что делать при 429.
Интерактивная спецификация — market-api.lootx.trade/docs, машиночитаемая — /v1/openapi.json (OpenAPI 3.1, ключ не нужен).