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

Підключення бірж і API-ключі

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

1Підключення бірж і API-ключі

Які біржі підтримує LootX, які права надати API-ключу, як додати підключення, налаштувати проксі та зрозуміти стан підключення за кольором.

Підключення — це зв’язок термінала з вашим рахунком на біржі через API-ключ. Без нього біржовий стакан, стрічка угод і графіки працюють, але свої заявки, позиції та баланс термінал не бачить, і торгувати не можна. Тут — які біржі підтримуються, як створити ключ і з якими правами, як завести підключення, пустити його через проксі та зрозуміти за кольором, що з ним відбувається.

Біржі та ринки

У списку бірж дві групи.

Група Майданчики Що дає
Торгівля та дані Binance, Bybit, OKX, Bitget, Gate.io, MEXC, KuCoin, BingX, Hyperliquid, Aster Біржовий стакан, стрічка угод, графіки, свої заявки та позиції, торгівля. Спот і ф’ючерси.
Тільки дані Binance Alpha, Upbit (спот) Біржовий стакан, стрічка угод і графіки. Торгівлі немає, ключі не потрібні.

До однієї біржі можна завести кілька підключень — наприклад, для різних субакаунтів. Якщо біржа не входить у ваш тариф, під час вибору термінал запропонує підписку — див. Підписки.

Який ключ створити на біржі

Ключ створюється в розділі керування API на сайті біржі. Терміналу потрібно:

  • Читання — щоб бачити баланс, заявки та позиції.
  • Торгівля на тих ринках, де будете торгувати: спот, ф’ючерси або обидва.

Прив’язка до IP. Якщо біржа дозволяє обмежити ключ списком IP-адрес, це варто зробити. Вкажіть адресу, з якої термінал реально виходить на біржу: вашу зовнішню IP, а якщо заявки йдуть через проксі — IP проксі. У разі запасного виходу напряму (про нього нижче) впавший проксі покаже біржі вашу власну IP, і вона відхилить запити.

Passphrase. OKX, Bitget і KuCoin під час створення ключа просять придумати passphrase. Це не пароль від акаунта — це третя частина ключа, її потрібно ввести в терміналі разом із ключем і secret.

Як додати підключення

Відкрийте список підключень

Шестерня у верхній панелі вікна → Підключення. Угорі видно, скільки підключень заведено і скільки з них активні.

Натисніть «+ Додати підключення»

Відкриється форма Додати підключення.

Назвіть підключення та виберіть біржу

Назва підключення — будь-яка, наприклад «Binance_main»; поруч можна вибрати колір, щоб розрізняти підключення на панелях. Біржа — список із пошуком. Після того як ключі введено, біржу змінити не можна: для іншої біржі створіть нове підключення.

Вставте ключі

Зазвичай це API Key та API Secret, у OKX, Bitget і KuCoin — ще Passphrase. У Hyperliquid та Aster поля свої, див. нижче.

Виберіть ринки

Перемикачі Спот і Ф’ючерс — на яких ринках працювати через це підключення. Автопідключення — підключатися одразу під час запуску термінала.

Натисніть «Зберегти»

Правки застосовуються одразу, у міру введення. Зберегти закриває форму, Скасувати відкочує зміни, а в щойно створеного підключення видаляє його.

У списку кожен рядок має перемикач — він вмикає і вимикає підключення, не видаляючи його, — та позначку в стовпці Авто для автопідключення. Змінити підключення — клік по рядку. Видалити підключення у формі видаляє його разом із ключами, повернути не можна.

Ключі зберігаються у файлі налаштувань у зашифрованому вигляді та розшифровуються лише на цьому комп’ютері. Під час експорту конфігурації вони не вивантажуються.

Hyperliquid

У Hyperliquid немає пари «ключ + secret»: єдине поле Private Key / Seed приймає приватний ключ гаманця.

  • Ключ API-гаманця (він же agent) — рекомендований варіант. Такий ключ створюється на сайті Hyperliquid і може торгувати, але не виводити кошти. Термінал сам знаходить основний рахунок, за яким закріплено API-гаманець, і показує його баланс і позиції. Дії рівня акаунта — наприклад, перекази — API-гаманець підписати не може, їх робіть на сайті Hyperliquid.
  • Ключ самого гаманця теж підійде, але він дає повний доступ до коштів.

Hyperliquid розпізнає рахунок за підписом ключа. Якщо на цій адресі немає депозиту, термінал повідомить, що біржа відхилила ключ, — перевірте ключ і поповнення.

Aster

У Aster два види ключів, форма приймає обидва:

  • звичайний API-ключ — у поля API key / API wallet address та API secret / Private key;
  • API-гаманець — його адресу та приватний ключ у ті самі два поля, а в Account Id — адресу основного гаманця (0x…).

Проксі

Проксі потрібен, якщо біржа недоступна з вашої країни або якщо ключ прив’язано до IP проксі.

Додайте проксі

Налаштування → Проксі → + Додати проксі. Заповніть Назва, Адреса (хост і порт), за потреби Логін і Пароль. Протокол — SOCKS5, HTTP або HTTPS — термінал визначить сам.

Перевірте

Кнопка Перевірити стукає в проксі та пише результат: «OK — SOCKS5-проксі відповідає», «Не відповідає: …» або «Порт відкрито, але це не SOCKS5/HTTP-проксі». Потім Зберегти.

Виберіть проксі в підключенні

У формі підключення, розділ Проксі: виберіть проксі та позначте, що через нього пускати — Заявки та рахунок, Ринкові дані або обидва. Вибір для ринкових даних діє на всі підключення цієї біржі.

На сторінці Проксі є перемикач «Переходити на пряме з’єднання, якщо проксі недоступний». За замовчуванням він увімкнений: упав проксі — термінал іде на біржу напряму, щоб не втрачати дані.

Якщо проксі відповідає «Проксі … відхиляє логін/пароль (407)», перевірте логін, пароль і термін підписки у постачальника проксі.

Стан підключення

У рядку підключення, поруч із ринками, стоїть точка стану. Наведіть на неї — підказка скаже подробиці.

Вигляд Що означає
Зелена точка Підключено: дані йдуть, торгівлю піднято.
Жовте пульсуюче кільце Триває підключення або торгівля перепідключається. Підказка покаже останню причину збою, якщо вона була. Термінал повторює спроби сам.
Червоне кільце, не мигає Немає зв’язку з біржею, біржа відхилила ключ або торгівлю вимкнено вручну.
Точки немає Підключення вимкнено.

Поруч із назвою — значок режиму: зелені стрілки у торгового підключення, сіре око у майданчика «тільки дані».

Вмикати та вимикати торгівлю на ходу зручно з головного вікна: клік по смузі бірж у верхній панелі відкриває список підключень із кнопками Підкл і Відкл та посиланням Налаштування підключень ›.

Якщо біржа відхилила ключ

Термінал одразу показує повідомлення «…: біржа відхилила API-ключ або secret — перевірте їх у налаштуваннях підключення», а точка підключення горить червоним із підказкою «Біржа відхилила API-ключ або secret». Перевірте ключ, secret і passphrase: зайвий пробіл під час вставлення, видалений на біржі ключ, ключ іншого субакаунта.

Якщо ж ключ правильний, але в нього немає потрібного права або ваша IP не в списку дозволених, окремого повідомлення немає: термінал показує текст біржі як є. Знайдіть у ньому код і відкрийте сторінку своєї біржі в розділі Повідомлення про помилки.

Розбіжність годинника комп’ютера та біржі термінал вирівнює сам — налаштовувати нічого не потрібно.

Режим «тільки перегляд»

Якщо з панелі зараз торгувати не можна, на ній з’являється значок-око. Наведіть на нього — підказка назве причину:

Підказка Що зробити
«Тільки перегляд: у цього майданчика торгівлі немає — надходять біржовий стакан, стрічка угод і графіки» Нічого: так влаштовано Binance Alpha та Upbit.
«Тільки перегляд: до цієї біржі немає підключення. Заведіть його в налаштуваннях» Додайте підключення з ключем.
«Тільки перегляд: підключення вимкнено в налаштуваннях» Увімкніть підключення.
«Тільки перегляд: ринок цієї панелі зараз не підключено — чекаємо відновлення» Зачекайте: термінал перепідключається сам.

Якщо в такому стані натиснути кнопку або гарячу клавішу торгівлі, заявка не піде, а термінал покаже «⚠ Біржа не підключена», «⚠ Підключення вимкнено» або «⚠ У цього майданчика немає торгівлі».

Далі

https://docs.lootx.trade/uk/terminal/connections