← До документації
LootX

Швидкий старт

Зібрано: 2026-11-21 docs.lootx.trade
Начало работы

1Швидкий старт

Ключ, адреса, перший запит — свічки 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, ключ не потрібен).

https://docs.lootx.trade/uk/market-api/getting-started