Повідомлення про помилки: як читати
Де термінал показує помилки, чим його пояснення відрізняється від відповіді біржі, як знайти код біржі в тексті та зібрати звіт для підтримки.
Коли щось іде не так — біржа відхилила заявку, обірвалося підключення, не пройшов ключ, — термінал повідомляє про це в кількох місцях. Тут описано, де шукати повідомлення, як відрізнити пояснення термінала від відповіді біржі, як знайти в тексті код біржі та що надіслати в підтримку, якщо розібратися самому не вдалося.
Коди й тексти конкретних бірж зібрано на окремих сторінках — посилання в кінці.
Де з’являються повідомлення
- Плашки — спливають у правому верхньому куті вікна та зникають через 8 секунд. Червона — відмова чи обрив, зелена — успіх, синя — інформація. Якщо подія стосується біржі, у рядку стоїть її логотип. Однакові повідомлення не множаться, а згортаються в одну плашку з лічильником повторів.
- Стрічка «Сповіщення» — кнопка Сповіщення у верхній панелі вікна. До неї записується кожна плашка, тож миготливе повідомлення можна перечитати. Синя точка на кнопці — є непрочитані. Повідомлення термінала лежать у джерелі Система.
- Рядок підключення в Налаштування → Підключення. Колір точки показує стан підключення, підказка при наведенні — причину: «Біржа відхилила API-ключ або secret», «Вимкнено» або останню відповідь біржі, поки підключення піднімається заново.
- Значок «лише перегляд» (око) на стакані — торгувати з цієї панелі зараз не можна. Наведіть на нього: підказка назве причину.
- Напівпрозорі заявки на стакані — термінал тимчасово не може підтвердити їх у біржі: обірвався зв’язок або біржа обмежила запити. Коли зв’язок повернеться, заявки звіряться заново.
- Червоний банер угорі вікна — Windows не дав запустити частину термінала (Smart App Control або антивірус). Він не зникає сам. Поки він висить, залежно від тексту не оновлюються ринкові дані або не надсилаються заявки.
- Вікна входу та оновлення показують свої помилки прямо у вікні.
- Логи — повний запис роботи термінала, включно з тим, що плашкою не показується. Як їх дістати — нижче.
Два види повідомлень
Термінал розпізнав помилку та пояснює сам
Кілька частих ситуацій термінал розпізнає у відповіді будь-якої біржі та показує замість сирого тексту свій — мовою інтерфейсу та з підказкою, що робити.
| Ситуація | Що ви бачите |
|---|---|
| Біржа не прийняла API-ключ, secret або passphrase | Плашка «…: біржа відхилила API-ключ або secret — перевірте їх у налаштуваннях підключення», червона точка біля підключення |
| Відмова за підписом на конкретній заявці | «Заявку відхилено: неправильний API-ключ або secret» |
| Перевищено ліміт запитів або IP-адресу забанено | Плашка з часом закінчення обмеження в UTC |
| Біржа тимчасово не приймає заявки через API на цю монету | «Торгівля через API недоступна для цієї монети — обмеження біржі» |
| Немає підключення, його вимкнено або на майданчику немає торгівлі | «⚠ Біржу не підключено», «⚠ Підключення вимкнено», «⚠ На цьому майданчику немає торгівлі» |
| Заявку вже виконано або знято на момент скасування | Нічого: термінал сам запитує в біржі підсумковий статус заявки |
| Годинник комп’ютера розійшовся з годинником біржі | Нічого: термінал звіряє годинник з біржею та повторює запит |
Кожне з цих повідомлень розібрано на сторінці Повідомлення термінала.
Термінал передає відповідь біржі як є
Усе інше — брак маржі, мінімальний обсяг, крок ціни, права ключа, білий список IP — термінал не перекладає. Він показує текст біржі повністю, зазвичай англійською. Перед ним стоїть короткий префікс — за ним видно, яка дія не пройшла.
| Префікс | Де | Що не пройшло |
|---|---|---|
Order: … |
плашка | Виставлення заявки. Префікс залишається англійською і в українському інтерфейсі |
Заявка: … |
лог | Те саме відхилене виставлення — запис у лозі |
Скасування відхилено: … |
плашка або лог | Зняття заявки — вона залишилася на біржі |
Перенесення заявки не вдалося: … |
плашка | Перенесення заявки на іншу ціну |
Плече … ×… не змінено: … |
плашка | Зміна плеча |
Торгівля: вимкнено (…) |
лог | Обрив торговельного підключення. У дужках — ім’я підключення та причина |
Текст після двокрапки — це і є відповідь біржі. Знайдіть у ньому код (див. наступний розділ) і відкрийте сторінку своєї біржі.
Як знайти код біржі в тексті
У кожної біржі свій формат відповіді. Наприклад, Binance відповідає так:
Order: {"code":-2019,"msg":"Margin is insufficient."}Тут код — -2019, а msg — пояснення біржі. В інших бірж код виглядає інакше:
| Біржа | Як виглядає код |
|---|---|
| Binance, Aster | Від’ємне число після "code":, наприклад -2019 |
| Bybit | Число після retCode |
| OKX | П’ятизначне число, наприклад 51008 |
| Bitget | Число в лапках: "code":"40009" |
| Gate | Не число, а слово великими: INVALID_KEY, BALANCE_NOT_ENOUGH |
| MEXC | Число після code= |
| KuCoin | Число після KuCoin POST /orders, наприклад 200004 |
| BingX | Число після слова error: BingX … error 100437: … |
| Hyperliquid | Кодів немає — тільки текст, наприклад Order must have minimum value of $10. |
Якщо коду в тексті немає, шукайте за ключовими словами: insufficient — бракує коштів, timestamp або recvWindow — годинник, signature — підпис, permission — права ключа.
Логи та звіт для підтримки
Якщо повідомлення незрозуміле або повторюється, зберіть звіт — це один архів з усіма потрібними логами.
Зберіть звіт
Натисніть Допомога (кнопка зі знаком питання у верхній панелі) → Звіт програми. Термінал запакує логи за сьогодні та вчора в архів lootx-report-<дата>-<час>.zip розміром до 50 МБ.
Знайдіть файл
Архів лягає на робочий стіл, шлях до нього вже скопійовано в буфер обміну, а провідник відкриється з виділеним файлом.
Надішліть його в підтримку
Додайте архів і напишіть: коли це сталося (час і часовий пояс), яка біржа та яке підключення, що ви робили і який текст був у плашці — його можна знайти в стрічці «Сповіщення».
Файл налаштувань з API-ключами та журнал угод до звіту не потрапляють. Якщо на диску мало місця, термінал так і скаже: «Мало місця на диску для звіту: потрібно … МБ, вільно … МБ».
Папку з логами можна відкрити й вручну: Допомога → Логи. На Windows це %AppData%\TradingTerminal\Logs, на macOS — ~/Library/Application Support/TradingTerminal/Logs. Логи зберігаються тиждень, старі видаляються самі.
Якщо не вантажаться кластери або скринер — тобто не відповідають сервери LootX, а не біржа, — відкрийте Налаштування → Хмара → Діагностика з’єднання та натисніть Перевірити з’єднання. Перевірка покаже, на якому кроці обривається зв’язок, а Копіювати звіт дасть текст для підтримки.
Коди помилок за біржами
Усе, що термінал пояснює сам: підключення, ключі, ліміти, проксі, оновлення, вхід.
BinanceКоди виду -2019 і -1013, бан за IP до вказаного часу.
BybitКоди retCode: ключ, права, баланс, ліміти.
OKXП’ятизначні коди, passphrase, білий список IP.
BitgetПідпис, режим єдиного рахунку, права та IP-список ключа.
GateТекстові мітки замість кодів, ліміт за однією монетою.
MEXCФ’ючерси без KYC і прав, баланс, ліміти.
KuCoinТри поля ключа, passphrase, баланс.
BingXКлюч і підпис, API-торгівлю за монетою вимкнено.
HyperliquidКлюч гаманця та agent, мінімальний обсяг, ліміт адреси.
AsterГаманець і Account Id, час пристрою, бан за IP.