LootX

Быстрый старт

Обновлено 6 ноября 2026 г. Эта страница в PDF

Ключ, адрес, первый запрос — свечи BTCUSDT с Binance за пять минут.

API рыночных данных LootX отдаёт те же данные, на которых работает терминал: свечи от одной секунды, ленты сделок, футпринт, тепловую карту стакана, открытый интерес, фандинг, плотности и скринер. Все биржи — через один адрес и один ключ, с одинаковыми именами инструментов и одним форматом времени.

За пять минут

Получите ключ

Откройте Кабинет → API-ключи и нажмите Создать ключ. Дайте ключу понятное имя — например, по названию скрипта или сервера, где он будет жить.

Ключ выглядит как lx_live_ и ещё 43 знака. Он показывается один раз: сохраните его в менеджер паролей или в переменную окружения. Потеряли — отзовите ключ и выпустите новый.

Ключ работает, пока у аккаунта есть действующий API-тариф. Тариф выбирается на той же странице, если он открыт для покупки, или его назначает администратор LootX.

Запомните адрес и способ передать ключ

Базовый адрес — https://market-api.lootx.trade. Ключ передаётся заголовком:

HTTP
Authorization: Bearer lx_live_...

или X-API-Key: lx_live_.... Ключ никогда не кладётся в адрес: строки запросов оседают в логах прокси и браузеров, поэтому запрос с ключом в адресе получает 400 key_in_query.

Сделайте первый запрос

Три последние минутные свечи бессрочного контракта BTCUSDT на Binance (последняя — текущая минута, она ещё не закрыта):

Shell
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, значения в том же порядке (числа ниже — для примера):

JSON
{
  "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" и телом:

JSON
{
  "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 пришлите в поддержку, если ошибка непонятна: по нему мы найдём запрос. Все коды — в разделе Ошибки.

Что дальше

Интерактивная спецификация — market-api.lootx.trade/docs, машиночитаемая — /v1/openapi.json (OpenAPI 3.1, ключ не нужен).