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