Ошибка Bybit API может возникнуть при проверке доступа, разборе параметров заявки, передаче запроса или обработке операции биржей. Поэтому сообщения «бот не покупает» и «нет ответа» сами по себе ещё не указывают на причину. Начните с операции, времени и полного обезличенного ответа: одинаковые цифры в разных областях API могут означать разные проблемы.
Руководство посвящено Bybit V5 и обычной спотовой торговле без займа. Проверяйте сведения именно для category=spot: правила фьючерсов и маржинальных операций сюда автоматически не переносятся. Официальные документы сверены 19 ноября 2026 года; текущие ограничения конкретной пары проверяйте перед операцией.
Оглавление
Основные ошибки Bybit API: быстрый поиск
Области указаны по официальному справочнику Error Codes. «UTA» — название общего раздела справочника; «Spot Trade» — отдельный спотовый раздел. Сначала сопоставьте код с областью вашего запроса.
| Код | Область и краткое значение | Что проверить |
|---|---|---|
-2015 | UTA, Spot: истёк ключ | Статус ключа |
10003 | UTA: ключ / окружение; WS Order Entry: число сессий | Ключ / соединения |
10004 | UTA: подпись | Формирование запроса |
10005 | UTA: права | Разрешения |
10010 | UTA: разрешённый IP | Whitelist |
10002 | UTA: временное окно | Часы и задержка |
10001, 170121 | UTA: параметры; Spot Trade: символ | Схема заявки |
170131 | Spot Trade: баланс | Средства для операции |
170136, 170140 | Spot Trade: минимум количества / стоимости | Текущие ограничения Spot |
170134, 170137, 170148 | Spot Trade: точность цены / количества / суммы | Шаги и единицы |
10006, 170005 | UTA: частота запросов; Spot Trade: новых заявок | Лимиты |
10000, 170007, 170146, 170147 | UTA / Spot Trade: тайм-аут, включая создание и отмену | Результат операции |
10016, 170001 | UTA / Spot Trade: внутренний сбой | Состояние и сверка |
10014, 170141 | UTA / Spot Trade: дубликат запроса / клиентского ID | Исходная заявка |
170192, 170193, 170194 | Spot Trade: границы цены, в том числе BUY / SELL | Допустимая цена |
10009, 10024, 10027 | UTA: региональная доступность / комплаенс / запрет операций | Статус аккаунта |
Код 10018 в текущем справочнике зачёркнут: не используйте его как основной актуальный ориентир ограничения частоты. Для 10016 в WS Order Entry справочник также указывает перезапуск сервиса; контекст соединения нужно сохранить.
Как правильно прочитать ошибку
HTTP-статус описывает ответ на уровне HTTP, а retCode и retMsg — результат API внутри ответа. Полученный HTTP 200 ещё не означает, что операция успешна. При DNS-сбое или обрыве соединения JSON-ответа может вообще не быть. Отсутствие ответа не доказывает отсутствие заявки.
| Что записать | Зачем |
|---|---|
| Время и часовой пояс | Сопоставить события приложения и биржи. |
| REST или WebSocket | Выбрать область справочника. |
| Endpoint или операция | Отличить чтение от создания или отмены. |
| HTTP-статус | Проверить транспортный ответ. |
retCode и обезличенный retMsg | Определить причину отказа API. |
| Окружение и категория | Сверить аккаунт, домен и Spot. |
| Идентификаторы заявки, если сохранены | Найти фактическое состояние операции. |
Учебный обезличенный ответ: условный пример, не результат обращения к аккаунту.
{
"retCode": 170131,
"retMsg": "Balance insufficient",
"result": {},
"retExtInfo": {},
"time": 1795046400000
}
Здесь retCode — код, retMsg — пояснение, result — данные результата, retExtInfo — дополнительные сведения, time — метка времени ответа в миллисекундах. Их назначение описано в Integration Guidance. Один код без операции недостаточен: 10003 у REST/UTA и WS Order Entry имеет разный смысл. Любой HTTP 403 тоже нельзя автоматически объяснять whitelist: проверяйте текст и условия ответа.
1. Неверный, удалённый или просроченный ключ
Проблема. Подключение не проходит, хотя значения уже вводили. Причина может быть в выбранном аккаунте, статусе ключа, пробелах при копировании или несовместимом окружении.
Проверка. В API Management убедитесь, что ключ существует, активен и принадлежит нужному основному аккаунту или субаккаунту. Сверьте его назначение и тип. При повторном вводе используйте сохранённый исходный секрет: секрет от другого ключа не подходит, даже если имя одинаковое.
Mainnet, Testnet и Demo используют разные ключи. Для глобального mainnet в Integration Guidance указан api.bybit.com, для testnet — api-testnet.bybit.com. У mainnet Demo собственный аккаунт и api-demo.bybit.com; это описывает Demo Trading Service. Подмена адреса не превращает один ключ в другой и не делает региональную платформу совместимой с приложением.
Действие. Исправьте конкретное несоответствие; при истёкшем или удалённом ключе настройте подходящий новый по руководству создания API-ключа Bybit. Срок проверяйте в аккаунте: поля срока в описании ключа имеют условия применимости, включая отсутствие IP-привязки или смену пароля. Единого срока для всех ключей нет в этой инструкции.
Проверка результата. Повторите предусмотренную приложением проверку подключения без пробной покупки. Отдельно подтвердите торговые права: успешная аутентификация ещё не проверяет их все.
2. Недостаточные разрешения API
Проблема. Данные аккаунта читаются, но торговое действие отклоняется. Доступ только на чтение и разрешение спотовой торговли — разные условия.
Проверка. В Get API Key Information значение readOnly=1 означает только чтение, readOnly=0 — чтение и запись; спотовое разрешение указано отдельно как permissions.Spot с SpotTrade. Сам запрос сведений о ключе доступен с любыми разрешениями, поэтому его успех не доказывает возможность выставить ордер.
Действие. Сопоставьте права с требованиями приложения и разрешите нужную Spot-торговлю. Не добавляйте Withdraw, переводы, фьючерсы или маржу ради исправления обычного спотового доступа.
Проверка результата. Снова выполните штатную проверку настроек. Если ошибка сохранилась, запишите код, операцию и время: запрет может относиться к аккаунту, а не к недостающей галочке.
3. IP whitelist не совпадает с источником запросов
Проблема. Ключ существует, но серверное приложение не проходит IP-проверку. Для удалённого бота имеет значение публичный исходящий IP сервера, который обращается к бирже. Адрес телефона, домашнего маршрутизатора или сайта не подходит автоматически; NAT и прокси тоже могут менять адрес выхода.
- Получите актуальный адрес из действующего интерфейса или инструкции TradeMatic.
- Откройте whitelist именно того ключа, который подключён.
- Сопоставьте адрес с сервисом, отправляющим запросы, а не с устройством управления.
- Сохраните корректную привязку и повторите безопасную проверку подключения.
Проверка результата. Штатное чтение должно проходить с нужного сервера. Если IP остаётся неясным, передайте поддержке обезличенную ошибку и время. Не снимайте IP-ограничение и не разрешайте все адреса как обычный способ исправления. Связь кода и привязки подтверждают Error Codes, поле ips — сведения о ключе.
4. Подпись запроса и временное окно
Проблема. При ошибке подписи проверяют формирование подписываемых данных; при ошибке времени — timestamp, часы и задержку. Эти причины требуют разных исправлений.
Проверка для разработчика. Системный HMAC-ключ и самостоятельно созданный RSA-ключ используют соответствующие алгоритмы. Сверьте секрет с ключом, строку параметров GET или точное JSON-тело POST, способ сериализации и заголовок X-BAPI-SIGN. Изменение данных после подписания нарушает проверку. Затем проверьте UTC timestamp в миллисекундах, синхронизацию часов отправляющего сервера и сетевую задержку. Официальное правило окна:
server_time - recv_window
<= timestamp
< server_time + 1000
Действие. Администратор исправляет подпись либо синхронизацию времени и причину задержки. Не увеличивайте recv_window произвольно: оно не исправляет неверную подпись или любые отклонения часов.
Для пользователя TradeMatic. Если запрос отправляет сервер бота, настройка часов телефона его часы не изменит. После проверки правильности введённых данных передайте поддержке код, действие и время без ключей и подписи. Проверка результата: повторное штатное чтение проходит без ошибки подписи или окна; торговую операцию с неизвестным результатом сначала сверяют отдельно.
5. Недостаточный баланс для конкретной операции
Проблема. Общая стоимость аккаунта выглядит достаточной, а заявка отклонена. USD-оценка всех активов не равна доступному количеству нужной монеты.
Проверка. Для BUY проверьте котируемую валюту пары и смысл суммы; для SELL — количество продаваемого базового актива. Сверьте торговый счёт, открытые ордера и связанные ими средства, единицы заявки и применимые комиссии. Средства в Funding не становятся средствами UNIFIED только потому, что видны в общем интерфейсе.
Get Wallet Balance разделяет оценку аккаунта и монеты, а locked относится к средствам в открытых Spot-ордерах. Поле free устарело, availableToWithdraw устарело для UNIFIED с 9 января 2025 года; выводимая сумма также не тождественна торговому лимиту. Не стройте универсальную формулу доступности из старого JSON-примера: текущая схема учитывает и изменения spotBorrow.
Действие. Найдите конкретное расхождение. При необходимости пересмотрите планируемый объём или размещение собственных средств, предварительно оценив последствия. Не отменяйте все ордера и не включайте заём автоматически. Посчитать влияние комиссии поможет калькулятор спотовых комиссий.
Проверка результата. Сопоставьте доступные средства нужной монеты с окончательным объёмом заявки и её комиссиями. Новое пополнение не требуется, если причина была в неверной валюте или единицах запроса.
6. Параметры, минимальный размер, точность и цена
Проблема. Отказ относится к символу, размеру, числу знаков или ценовой границе. Начните с точного обозначения пары, её торгового статуса, category=spot, стороны и типа заявки. Символ в запросе передают в верхнем регистре, например BTCUSDT, без случайного разделителя.
Проверка для разработчика. Получите актуальные сведения нужного символа в Get Instruments Info, раздел Spot. Используйте текущую схему ответа, а не сохранённые значения чужой пары:
lotSizeFilter.minOrderAmt— минимальная стоимость заявки.basePrecisionиquotePrecisionвнутриlotSizeFilter— точность базовой и котируемой валют.priceFilter.tickSize— шаг допустимой цены.maxLimitOrderQtyиmaxMarketOrderQty— разные максимумы количества для Limit и Market.
В актуальной Spot-схеме minOrderQty, maxOrderQty и maxOrderAmt помечены устаревшими с заменами. Наличие старого поля в примере ответа не делает его действующим правилом. Код минимального количества остаётся в справочнике, но это не основание восстанавливать устаревшую проверку. Поля qtyStep и minNotionalValue из фьючерсной схемы нельзя выдавать за универсальные правила Spot.
Для рыночной Spot-заявки qty может означать базовую монету или сумму в котируемой валюте: смысл задаёт marketUnit. В Place Order указаны baseCoin и quoteCoin; для Market BUY по умолчанию используется стоимость. Проверяйте единицы явно, особенно при переносе кода между сторонами и типами ордера.
Действие. Исправьте формат или предложите пользователю допустимые параметры. Используйте точную десятичную арифметику. После округления заново проверьте минимум, максимум, доступные средства и итоговую стоимость. Для ценовых ограничений сохраните границу из ответа: разрешённая точность не гарантирует, что выбранная цена разрешена сейчас. Не сдвигайте желаемую цену молча.
Проверка результата. Окончательная заявка соответствует свежим правилам именно этой пары и прежнему торговому намерению. Если ошибка возникает при целевой продаже, дополнительно проверьте выбранные условия в руководстве автоматической продажи.
7. Слишком частые запросы или новые заявки
Проблема. Ошибка появляется сериями при частом обновлении, создании заявок или переподключении. Ограничения общего трафика по IP, UID и endpoint, частоты новых ордеров и WebSocket-соединений — разные уровни.
Проверка для разработчика. Сопоставьте нагрузку всех приложений аккаунта и исходящего IP. По Rate Limit Rules заголовок X-Bapi-Limit показывает лимит endpoint, X-Bapi-Limit-Status — остаток запросов, X-Bapi-Limit-Reset-Timestamp — время сброса при превышении; в обычном ответе последнее поле близко к текущей метке времени. Не используйте его как безусловную команду сна.
Действие. Снизьте частоту, объедините повторяющиеся чтения, соблюдайте паузы и ограничьте число переподключений. Пользователю TradeMatic следует прекратить повторные нажатия одной команды и передать сведения о повторяющейся ошибке. Для подтверждённого сообщения «403, access too frequent» Bybit требует завершить все HTTP-сессии и выждать минимум 10 минут; администратор должен применить это к соответствующему трафику. Эта инструкция не относится к любому HTTP 403.
Проверка результата. После предусмотренной паузы умеренное чтение проходит, остаток квоты не расходуется всплеском. Если ограничивалось создание заявки, перед новой финансовой операцией также проверьте результат предыдущей.
8. Тайм-ауты, внутренние сбои и повторный запрос
Проблема. Приложение не получило окончательный ответ при создании или отмене. Самый опасный вывод здесь — «ответа нет, значит покупки не было». Запрос мог дойти до биржи, а ответ потеряться.
Проверка. Установите, выполнялось чтение, создание или отмена. Найдите сохранённые orderId биржи и клиентский orderLinkId. Последний помогает связать запрос с операцией; Place Order требует его уникальности. Идентификация не означает универсальную гарантию идемпотентности любого повтора: нельзя считать, что бесконечная отправка одинакового POST всегда безопасна.
- Сохраните исходное намерение и идентификаторы; не отправляйте новую покупку только из-за тайм-аута.
- Найдите заявку через Get Open & Closed Orders, учитывая категорию, фильтры и область поиска.
- Сверьте историю заявок и исполнения. У одного ордера может быть несколько исполнений.
- Учтите задержку обновления, временное окно, пагинацию и состояние сервиса. При поиске по двум ID приоритет имеет
orderId. - Только после выяснения результата решайте, нужна ли новая операция. При сохраняющейся неопределённости передайте случай поддержке.
Пустой список открытых заявок недостаточен: ордер мог уже исполниться или закрыться. Realtime-интерфейс хранит ограниченный набор недавно закрытых записей, который очищается при обновлении или перезапуске сервиса. История может обновляться с задержкой; по умолчанию запрос охватывает семь дней, и выбранное окно одного запроса не должно превышать семь дней. Полностью отменённые без исполнения, отклонённые и деактивированные заявки доступны в истории только за последние 24 часа; для записей старше семи дней поддерживаются заявки с исполнениями. Выберите подходящий период и просмотрите все страницы, а не только первые записи.
Действие при дубликате. Сначала найдите исходный ордер. Не меняйте orderLinkId только для обхода сообщения о повторе: новая строка может превратить повтор в ещё одну покупку.
Действие при внутреннем сбое. При чтении допустим ограниченный повтор с паузой, если нет запрета по частоте. Для создания, отмены или другой финансовой операции сначала сверяют состояние. Подтверждение приёма создания означает принятие запроса, а не исполнение. Подтверждение приёма отмены тоже асинхронно: тайм-аут отмены не доказывает, что ордер отменён, и он может продолжать исполняться.
Проверка результата. Установлен фактический статус заявки и объём исполнений, а приложение сопоставило их с единственной исходной операцией. Пока результат неизвестен, новая покупка не служит способом диагностики.
9. Подключение, DNS, TLS и WebSocket
Проблема. Имя сервера не разрешается, соединение не устанавливается, TLS завершается ошибкой, поток обрывается или перестаёт присылать ожидаемые события. Это разные этапы связи; код торгового отказа может отсутствовать.
Проверка для администратора. Сначала проверьте правильный домен и окружение, затем DNS, доступность сети, TLS-сертификат и часы сервера. Не отключайте проверку сертификатов. Для WebSocket отдельно проверьте подтверждение подключения, аутентификации, подписки и heartbeat: открытое соединение ещё не подтверждает подписку на нужную тему.
WebSocket Connect разделяет публичный Spot-поток wss://stream.bybit.com/v5/public/spot и приватный поток аккаунта wss://stream.bybit.com/v5/private. Публичные темы не требуют аутентификации; приватные требуют. Поток котировок не подтверждает работоспособность авторизации аккаунта. Для Testnet предусмотрен отдельный хост; адрес должен соответствовать окружению ключа.
Действие. Исправьте выявленный этап и восстановите связь с учётом лимитов переподключения. Отсутствие новых приватных событий само по себе может означать и отсутствие соответствующих изменений — сверяйте подписку и состояние. Для 10003 в WS Order Entry проверьте количество сессий, а не начинайте с замены ключа.
Проверка результата. После восстановления подписок сверяются текущие заявки и исполнения, включая период разрыва. Потеря соединения сама по себе не подтверждает отмену биржевых ордеров. Пользователь серверного бота передаёт поддержке время и характер сбоя: переподключение Telegram на телефоне не восстанавливает автоматически соединение торгового сервера.
10. Ограничения аккаунта и доступности сервиса
Проблема. Ответ указывает на региональную доступность, проверку правил или запрет операций аккаунта. Текущий смысл 10009 — региональное ограничение сервиса; не подменяйте его старым объяснением про IP-бан.
Проверка и действие. Проверьте уведомления и статус собственного аккаунта на официальном сайте Bybit; для этих ограничений может потребоваться официальная поддержка. Сохраните код и время. Error Codes выделяет такие отказы отдельно от подписи и параметров.
Проверка результата. Доступность должна быть подтверждена для вашего аккаунта и разрешённой операции. Не рассчитывайте исправить запрет пересозданием ключа, многократным повтором или сменой домена. Не обходите региональные и аккаунтные ограничения.
Если ошибка появилась в TradeMatic
TradeMatic работает с обычным Spot на Bybit Global MAINNET и системными HMAC-ключами. Для торговли нужен поддерживаемый аккаунт UTA 2.0, Read/Write и SpotTrade; режим «только чтение» должен быть выключен. Demo, Testnet и RSA PEM в текущем подключении не поддерживаются. Withdraw, Transfer и права на деривативы для этого не нужны.
В личном чате откройте /settings и проверьте подключение, права ключа, торговое состояние, сумму покупки, пороги, задержку и отдельные статусы котировки и данных аккаунта. Доступ к настройкам требует принятых условий и действующего доступа к боту. Для текущего IP whitelist при первом подключении выберите пару; при существующем подключении нажмите «Обновить ключи Bybit» и выберите пару. Адрес появится в приглашении ввода ключа. Если вы только уточняли адрес, /cancel завершит временную настройку с сохранением действующего подключения и торгового состояния. Если адрес не подтверждён, уточните его у поддержки; адрес сайта для whitelist не подходит.
/balance показывает подтверждённые доступные и заблокированные средства выбранного аккаунта; /orders — открытые Spot-заявки выбранной пары; /ordersw — учтённые текущие ордера самого бота; /help — список команд. Эти списки не заменяют историю заявок и исполнений. /start запускает торговую автоматизацию у готового к работе пользователя, поэтому не используйте его как универсальную проверку подключения.
Отсутствие новой покупки может означать незавершённую настройку, недоступность настроек, STOP, недостаток доступных средств, ожидание порога или задержки стратегии, сверку текущей операции либо ограничение Bybit. Сообщения о неподтверждённых свежих данных и ожидании — состояния TradeMatic, а не самостоятельные коды retCode Bybit. /stop останавливает новые покупки; уже купленные собственные лоты и стоящие продажи продолжают сопровождаться.
Бот синхронизирует время, применяет паузы при лимитах и восстанавливает WebSocket с ограниченным числом попыток. Это не исправляет неверный ключ, права, IP или ограничения аккаунта. Если исход уже отправленной заявки неизвестен, бот сверяет сохранённые идентификаторы и исполнения. Не запускайте повторную покупку ради обхода тайм-аута или дубликата; при затянувшейся неопределённости передайте поддержке время, действие и обезличенное сообщение.
Как выбрать следующее действие
Что произошло с запросом?
- Явный отказ доступа → ключ, окружение, права, IP, подпись и время → штатная проверка подключения.
- Отказ по параметрам или средствам → пара, единицы, доступная монета и свежие правила Spot → проверка окончательного объёма.
- Подтверждённое ограничение частоты → прекратить лишние запросы, выдержать нужную паузу → умеренное чтение и сверка.
- Нет окончательного ответа после создания / отмены → найти исходные ID, заявку и исполнения → решить вопрос повтора после сверки результата.
Что передать в поддержку
Подготовьте время с часовым поясом, действие, торговую пару, код и обезличенный текст ответа. Укажите, использовали ли TradeMatic или собственное приложение, повторяется ли проблема и известен ли результат операции. Идентификаторы конкретной заявки передавайте через соответствующий приватный канал поддержки.
Для TradeMatic используйте официальную поддержку, для ограничений аккаунта Bybit — поддержку биржи. Не отправляйте API Secret, полный API Key, подписи запросов, пароль, cookies или необработанные журналы. На этой странице нет формы проверки ключей; вводить их на сайте не требуется.
Частые вопросы
Почему ключ работает в одном приложении, а в другом нет?
Приложения могут использовать разные окружения, типы ключа, исходящие IP и операции. Успех одного клиента не подтверждает совместимость другого. Сверьте конкретный ключ, аккаунт, поддерживаемое окружение и whitelist.
Почему баланс виден, а заявки не создаются?
Чтение не доказывает наличие записи и SpotTrade. Кроме прав, проверьте режим работы приложения, доступные средства и параметры заявки. Само отсутствие новой сделки ещё не означает ошибку API.
Какой IP добавлять для бота на удалённом сервере?
Актуальный публичный исходящий IP сервера, отправляющего запросы Bybit. Возьмите его из действующей настройки или инструкции сервиса. IP телефона или адрес сайта не подставляют автоматически.
Почему возникает ошибка времени?
Timestamp запроса может выйти за допустимое окно из-за часов отправляющего сервера, неправильных единиц времени или задержки сети. В серверном боте часы телефона не исправляют часы сервера; сообщите поддержке время и код.
Почему общего баланса хватает, а ордер отклонён?
Общая оценка активов отличается от доступной суммы нужной монеты на нужном счёте. Средства могут быть связаны ордерами; проверьте также сторону, marketUnit и комиссию. Пополнение не является универсальным решением.
Почему сумма или цена не проходят проверку?
Нужны актуальные правила именно вашей Spot-пары: минимальная стоимость, точность валют, шаг цены, максимум соответствующего типа заявки и ценовые границы. После округления перепроверьте стоимость; учебные числа из статьи не являются лимитами биржи.
Можно ли повторить покупку после тайм-аута?
Сначала установите результат исходной операции по сохранённым ID, заявкам и исполнениям. Тайм-аут не доказывает отсутствие покупки. Не создавайте новый клиентский ID только для обхода сообщения о дубликате.
Отменяются ли ордера при обрыве соединения?
Сам обрыв не является подтверждением отмены. После восстановления связи сверяйте биржевой статус и исполнения. Даже полученное подтверждение приёма запроса отмены ещё требует подтверждения результата.
Какие сведения отправить поддержке?
Время и часовой пояс, действие, пару, код, обезличенный текст, название приложения и повторяемость. ID заявки — через приватный канал. API Secret, полный ключ, пароль и подпись передавать не нужно.
Официальные источники
Документация Bybit V5 проверена 19 ноября 2026 года. Ссылки у соответствующих проверок ведут непосредственно к нужным документам. Основные источники: Error Codes, Integration Guidance, Get API Key Information, Get Wallet Balance, Get Instruments Info, Rate Limit Rules, Place Order, Get Open & Closed Orders, Get Order History, Get Trade History, WebSocket Connect.
Подключение и дальнейшая работа
Для настройки используйте инструкцию подключения TradeMatic и руководство управления через Telegram. Перед разрешением новых входов изучите правила работы алгоритма, торговые риски и условия сервиса.