Підключення бірж і 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. |
| «Тільки перегляд: до цієї біржі немає підключення. Заведіть його в налаштуваннях» | Додайте підключення з ключем. |
| «Тільки перегляд: підключення вимкнено в налаштуваннях» | Увімкніть підключення. |
| «Тільки перегляд: ринок цієї панелі зараз не підключено — чекаємо відновлення» | Зачекайте: термінал перепідключається сам. |
Якщо в такому стані натиснути кнопку або гарячу клавішу торгівлі, заявка не піде, а термінал покаже «⚠ Біржа не підключена», «⚠ Підключення вимкнено» або «⚠ У цього майданчика немає торгівлі».