Помилки Binance

Binance повідомляє про помилку від’ємним числовим кодом і коротким англійським текстом, наприклад {"code":-2010,"msg":"Account has insufficient balance for requested action."}. Окремо біржа відповідає HTTP-статусами 429 і 418, коли запитів забагато. Тут зібрано коди, які найчастіше трапляються під час торгівлі з LootX, і що з ними робити.

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

Що термінал пояснює сам

Частину відмов LootX розпізнає за кодом і показує своє повідомлення або виправляє ситуацію без вашої участі:

Ситуація	Коди	Що ви побачите
Біржа відхилила ключ під час підключення	`-2014`, `-2015`, `-1022`, будь-яка відмова авторизації 401/403	Плашка з назвою підключення: «…: біржа відхилила API-ключ або secret — перевірте їх у налаштуваннях підключення». У Налаштування → Підключення біля підключення підказка «Біржа відхилила API-ключ або secret». Термінал повторює спробу приблизно раз на 30 секунд
Неправильний підпис у заявці	`-1022`	«Заявку відхилено: неправильний API-ключ або secret»
Забагато запитів	HTTP 429	«⚠ … Rate limit (429), пауза ~N с — до ЧЧ:ММ:СС UTC». Термінал сам витримує паузу
IP-адресу забанено	HTTP 418, `-1003`	«⚠ … Перевищено кількість запитів до біржі, IP-адресу забанено до 30.09.2026 19:37:54 UTC». До цього часу термінал не надсилає запити з цього IP за жодним підключенням
Розійшлися годинники	`-1021`	Нічого: термінал звіряє час з біржею під час підключення та щохвилини, а в разі відмови перераховує поправку й повторює запит
Заявки вже немає	`-2011`, `-2013`	Нічого: скасування вважається виконаним — заявка виконалася або була знята раніше
Не вистачило монет під час продажу на споті	`-2010`	Термінал повторює продаж з обсягом, зменшеним на розмір комісії. Не допомогло — показує текст біржі
Закривати на споті нічого	—	«Binance SOLUSDT: продавати нічого — залишок SOL = 0, позицію вже закрито». Заявка на біржу не надсилається: на гаманці порожньо або залишок менший за крок обсягу
Біржа призупинила торгівлю монетою по API	за словами у відповіді	«Торгівля по API недоступна для цієї монети — обмеження біржі»

Усе інше термінал не перекладає: у спливному повідомленні після «Order:» стоїть відповідь Binance як є — код і текст. У таблицях нижче це позначено як «текст біржі в повідомленні заявки».

Часті коди

Код	Як виглядає	Причина	Що робити
`-2014`	Плашка «біржа відхилила API-ключ або secret»	Ключ неправильного формату: скопійовано не повністю або із зайвим символом	Скопіюйте ключ заново в поле API Key
`-2015`	Та сама плашка	Ключа немає, вашої IP немає у списку ключа або ключ не має дозволу на цю дію	Перевірте ключ, прив’язку до IP і дозволи — див. Біржа відхилила ключ
`-1022`	Плашка або «Заявку відхилено: неправильний API-ключ або secret»	Secret не підходить до ключа	Вставте API Secret заново; якщо ключ перестворено — оновіть обидва поля
`-1021`	Зазвичай нічого	Годинник комп’ютера розійшовся з часом біржі	Термінал виправляє час сам. Якщо відмови повторюються — увімкніть синхронізацію часу в Windows
HTTP 429	«Rate limit (429), пауза ~N с…»	Перевищено ліміт ваги запитів за хвилину	Дочекайтеся кінця паузи, закрийте зайві вікна з цією біржею
HTTP 418, `-1003`	«IP-адресу забанено до …»	Запити тривали після попередження 429, і Binance тимчасово заблокувала IP	Дочекайтеся вказаного часу — див. IP-адресу забанено
`-2010`	Текст біржі в повідомленні заявки: «Account has insufficient balance…»	Бракує вільних коштів: частину заблоковано заявками або списано комісією	Перевірте вільний залишок, зніміть зайві заявки
`-2019`	Текст біржі в повідомленні заявки: «Margin is insufficient»	На ф’ючерсах бракує маржі під заявку за поточного плеча	Зменшіть обсяг, поповніть ф’ючерсний гаманець або зніміть зайві заявки
`-1013`	Текст біржі в повідомленні заявки: «Filter failure: …»	Заявка порушує правила інструмента: крок обсягу (LOT_SIZE), мінімальну суму (MIN_NOTIONAL) або крок ціни (PRICE_FILTER)	Збільшіть суму заявки або виправте ціну. Назва фільтра в тексті підкаже, що саме не так
`-4164`	Текст біржі в повідомленні заявки: «Order’s notional must be no smaller than …»	Сума ф’ючерсної заявки менша за мінімальну для контракту	Збільшіть обсяг. Закривна заявка «тільки зменшення» під це правило не потрапляє
`-2022`	Текст біржі в повідомленні заявки: «ReduceOnly Order is rejected»	Заявка «тільки зменшення» більша за позицію або позиції вже немає	Оновіть позицію, зменшіть обсяг закриття
`-2011`	Нічого	Заявки, яку скасовують, уже немає	Нічого робити не потрібно
`-2013`	Нічого	Заявку не знайдено під час перевірки статусу	Нічого робити не потрібно
`-1121`	Біржовий стакан або графік монети не завантажується	Такого символа немає: помилка в написанні або монету знято з торгів	Перевірте тікер і ринок — спот або ф’ючерс

Як виправити часті проблеми

Біржа відхилила ключ

Плашка «біржа відхилила API-ключ або secret» з’являється на будь-яку відмову авторизації під час підключення. У Binance за нею може стояти не лише помилка в ключі: код -2015 означає і неправильний ключ, і чужу IP, і брак дозволів.

Перевірте, що ключ живий

Відкрийте керування API у профілі Binance. Якщо ключа у списку немає — його видалили: створіть новий.

Скопіюйте ключ і secret заново

Secret Binance показує лише під час створення ключа. Якщо він не зберігся, створіть новий ключ. У Налаштування → Підключення вставте значення в API Key та API Secret без пробілів по краях.

Перевірте прив’язку до IP

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

Перевірте дозволи

Для торгівлі на споті ключ має мати дозвіл на спотову торгівлю, для ф’ючерсів — на ф’ючерси. Вмикайте дозволи під ті ринки, що позначені біля підключення перемикачами Спот і Ф’ючерс.

Після виправлення термінал перепідключиться сам під час наступної спроби.

Ключ працює на споті, але не на ф’ючерсах

Дозвіл на ф’ючерси Binance надає окремо, і ввімкнути його можна лише після того, як ф’ючерсний рахунок відкрито на сайті біржі. Відкрийте рахунок USDT-M, потім в керуванні API увімкніть ф’ючерси для ключа. Перестворювати ключ не потрібно.

IP-адресу забанено

Binance спочатку відповідає 429, а якщо запити тривають — блокує IP-адресу повністю (HTTP 418). Час закінчення бану біржа надсилає сама, термінал показує його в повідомленні.

До цього часу LootX не надсилає запити з цього IP за жодним підключенням до Binance: кожен зайвий запит подовжив би бан.
Час у повідомленні — за UTC. У Києві до нього потрібно додати дві години взимку та три влітку.
Якщо бани повторюються, зменшіть навантаження: менше вікон і панелей з Binance на одному комп’ютері, менше підключень з однієї IP.

Не вистачає монет під час продажу всього залишку на споті

Коли комісія за купівлю списується в купленій монеті, на гаманці опиняється трохи менше, ніж ви купили. Термінал звіряє обсяг продажу з реальним залишком гаманця, а якщо Binance все ж відповіла -2010, повторює заявку з обсягом, зменшеним на розмір комісії.

Після такого продажу на гаманці може залишитися «пил» — залишок менший за мінімальний крок обсягу. Продати його заявкою не можна: це обмеження біржі. Якщо -2010 не проходить і після повторів, монет на гаманці справді менше — перевірте, чи не заблоковані вони іншою заявкою.

Рахунок у режимі хеджування

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

Далі

Повідомлення про помилки

Де термінал показує помилки і як їх читати.

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

Як створити ключ і додати підключення в LootX.

Помилки Bybit

Коди Bybit: ключі, баланс, ліміти.