Помилки Bybit

Bybit відповідає на кожен запит полями retCode і retMsg: нуль у retCode — успіх, будь-яке інше число — відмова з англійським поясненням. Помилка часто приходить зі звичайним HTTP-статусом 200, тому дивитися потрібно саме на код. Коди спотової торгівлі у Bybit, як правило, починаються на 170…, коди ф’ючерсів та єдиного торгового рахунку — на 110…, коди ключа та підпису — на 100….

Якщо термінал не розпізнав код, у спливному повідомленні після «Order:» буде відповідь Bybit у вигляді Bybit error 170131: Insufficient balance. — спочатку номер, потім текст біржі. Загальний порядок розбору помилок — на сторінці Повідомлення про помилки: як читати, налаштування ключів — у Підключення бірж та API-ключі.

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

Ситуація	Коди	Що ви побачите
Біржа відхилила ключ або підпис при підключенні	`10003`, `10004`, текст «API key is invalid» при вході в приватний потік	Плашка з ім’ям підключення: «…: біржа відхилила API-ключ або secret — перевірте їх у налаштуваннях підключення». У Налаштування → Підключення у підключення підказка «Біржа відхилила API-ключ або secret». Термінал повторює спробу приблизно раз на 30 секунд
Невірний підпис у заявці	`10004`	«Заявку відхилено: невірний API-ключ або secret»
Забагато запитів	HTTP 429 і 403	«⚠ … перевищено ліміт запитів (403), обмеження до 30.09.2026 12:01:00 UTC». Термінал сам витримує паузу
Розійшлися годинники	`10002`	Відмова не вважається помилкою ключа, і підключення не рветься. Термінал звіряє час з біржею при підключенні та раз на хвилину — наступна звірка усуває розбіжність
Заявки вже немає	`110001`, `170213`	Нічого: скасування вважається виконаним
Знімати нічого	`10001` з текстом про те, що активних заявок немає	Нічого: масове скасування вважається виконаним
Плече вже таке	`110043`	Нічого: термінал вважає зміну плеча виконаною
Сума спотової заявки менша за мінімум	—	Термінал сам збільшує обсяг до мінімальної суми заявки із запасом 1 %, якщо знає мінімум для монети
Не вистачило монет при закритті спотової позиції	`170131`, `110007`	Термінал одразу перечитує гаманець і повторює продаж з обсягом, зменшеним на розмір комісії. Не допомогло — показує текст біржі
Закривати на споті нічого	—	«Bybit SOLUSDT: продавати нічого — залишок SOL = 0, позицію вже закрито». Заявка на біржу не йде
Біржа призупинила торгівлю монетою по API	за словами у відповіді	«Торгівля по API недоступна для цієї монети — обмеження біржі»

Код 10005 — немає прав на дію — термінал навмисно не називає «ключ відхилено»: ключ при цьому вірний, не вистачає дозволу. Така відмова приходить текстом біржі.

Часті коди

Код	Як виглядає	Причина	Що робити
`10003`	Плашка «біржа відхилила API-ключ або secret»	Ключ невірний, видалений або прострочений	Перевірте ключ на сайті Bybit і вставте його заново — див. Біржа відхилила ключ
`10004`	Плашка або «Заявку відхилено: невірний API-ключ або secret»	Підпис не зійшовся: secret не підходить до ключа	Вставте API Secret заново
`10005`	Текст біржі в повідомленні заявки: «Permission denied for current apikey»	У ключа немає дозволу на цю дію	Увімкніть потрібні права ключа — див. Немає прав у ключа
`10002`	Текст біржі в повідомленні заявки: «…server timestamp or recv_window param»	Час запиту поза допустимим вікном: годинник комп’ютера розійшовся з біржею, найчастіше після виходу зі сну	Повторіть заявку за хвилину. Повторюється — увімкніть синхронізацію часу в Windows
HTTP 403	«перевищено ліміт запитів (403), обмеження до …»	Занадто часті запити з однієї IP	Дочекайтеся вказаного часу, зменшіть кількість вікон з Bybit
HTTP 429	«перевищено ліміт запитів (429), обмеження до …»	Перевищено ліміт запитів	Дочекайтеся кінця паузи
`170131`	Текст біржі в повідомленні заявки: «Insufficient balance»	На споті не вистачає вільних коштів	Перевірте вільний залишок і зніміть зайві заявки — див. Не вистачає коштів
`110007`	Текст біржі в повідомленні заявки: «ab not enough for new order»	На єдиному торговому рахунку не вистачає доступного балансу під заявку	Зменшіть обсяг або плече, поповніть рахунок
`170140`	Текст біржі в повідомленні заявки: «Order value exceeded lower limit»	Сума спотової заявки менша за мінімальну	Збільште обсяг
`170032`	Текст біржі в повідомленні заявки: «Network error, please try again later»	Тимчасовий збій на боці Bybit, до балансу стосунку не має	Повторіть заявку за кілька секунд
`110001`	Нічого	Заявки, що скасовується, вже немає: виконана або знята	Нічого робити не потрібно
`170213`	Нічого	Те саме для спотової заявки	Нічого робити не потрібно
`110043`	Нічого	Плече вже встановлено в це значення	Нічого робити не потрібно

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

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

Перевірте, що ключ існує та не прострочений

Відкрийте керування API у профілі Bybit. Ключ міг бути видалений. Крім того, Bybit обмежує термін дії ключів без прив’язки до IP: якщо ключ перестав працювати сам по собі, перевірте його термін.

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

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

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

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

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

Немає прав у ключа

Код 10005 означає, що ключ прийнято, але прав на дію у нього немає. Відкрийте ключ у керуванні API на сайті Bybit і перевірте:

ключ створено з правом на читання і запис, а не лише на читання;
увімкнено торгівлю для тих ринків, де ви працюєте: спот і/або деривативи — під перемикачі Спот і Ф’ючерс у підключення в терміналі.

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

Не вистачає коштів

На споті (170131) гроші, заблоковані відкритими заявками, для нової заявки недоступні. Зніміть зайві заявки або зменшіть обсяг.

На єдиному торговому рахунку (110007) під заявку потрібна маржа з урахуванням плеча та вже відкритих позицій. Зменшіть обсяг, зніміть заявки або поповніть рахунок.

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

Перевищено ліміт запитів

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

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

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

Далі

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

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

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

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

Помилки OKX

Коди OKX: ключ, passphrase, IP, баланс.