Сообщения об ошибках: как читать
1Сообщения об ошибках: как читать
Где терминал показывает ошибки, чем его объяснение отличается от ответа биржи, как найти код биржи в тексте и собрать отчёт для поддержки.
Когда что-то идёт не так — биржа отклонила заявку, оборвалось подключение, не прошёл ключ, — терминал сообщает об этом в нескольких местах. Здесь описано, где искать сообщение, как отличить объяснение терминала от ответа биржи, как найти в тексте код биржи и что отправить в поддержку, если разобраться самому не получилось.
Коды и тексты конкретных бирж собраны на отдельных страницах — ссылки в конце.
Где появляются сообщения
- Плашки — всплывают в правом верхнем углу окна и исчезают через 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.
Дальше
https://docs.lootx.trade/ru/terminal/errors