Коды ошибок Binance Futures: 35 кодов, причины и решения

· 10 мин чтения

Binance Futures сообщает о проблеме на двух уровнях: HTTP-статус (например, 400, 403, 418, 429 или 503) говорит, какого рода был сбой, а код Binance (отрицательное число вроде -2019) говорит, что именно пошло не так. На этой странице собраны по группам коды, с которыми трейдеры и боты чаще всего сталкиваются на USDⓈ-M Futures: для каждого приведены формулировка самого Binance, решение и ответ на вопрос, поможет ли повторная попытка, а для самых частых — ссылки на наши подробные разборы.

Обложка: коды ошибок Binance Futures, что значит каждый и как его исправить

Как читать ошибку Binance

HTTP-статус показывает, на чьей стороне проблема. В документации API Binance сказано, что коды 4XX «используются для некорректных запросов; проблема на стороне отправителя», а коды 5XX «используются для внутренних ошибок; проблема на стороне Binance». В ответе 4XX тело JSON содержит code и msg, например {"code": -2019, "msg": "Margin is insufficient."}.

Сравнение: HTTP-статус и код ошибки Binance в одном ответе

Правило, которое бережёт больше всего денег: отклонённый ордер ничего не меняет. Прежде чем повторять, спросите себя, что должно измениться, чтобы он прошёл. Если не изменилось ничего, повтор закончится тем же.

Схема обработки ошибки Binance: прочитать статус, найти группу кода, устранить причину и только потом повторить один раз

Соединение, лимиты запросов и HTTP-статусы

Статус или код Формулировка Binance Что делать
HTTP 403 Нарушен лимит WAF (Web Application Firewall) Сбавьте темп и проверьте запрос; не долбите эндпоинт
HTTP 408 Таймаут при ожидании ответа бэкенда Запрос мог выполниться, а мог и нет: запросите ордер, прежде чем отправлять заново
HTTP 429 / -1003 Превышен лимит запросов; «Too many requests» Сделайте паузу; вместо опроса используйте потоки websocket
HTTP 418 IP автоматически забанен за запросы после 429 Прекратите все запросы, пока бан не истечёт
HTTP 503 «Unknown error» Запрос отправлен, но ответ не пришёл вовремя Статус исполнения неизвестен: проверьте, прежде чем повторять
HTTP 503 «Service Unavailable» / «Internal error» Операция не выполнена Повторите позже

О первом варианте 503 документация Binance говорит прямо: «Важно НЕ считать это неудавшейся операцией; статус исполнения НЕИЗВЕСТЕН, и запрос мог быть выполнен успешно». Бот, который после такого ответа вслепую отправляет ордер заново, может открыть одну и ту же позицию дважды. Используйте детерминированный клиентский ID ордера, запрашивайте ордер по нему и отправляйте заново, только если такого ордера нет.

Хронология эскалации при превышении лимита: запросы, ответы 429, их игнорируют, затем бан IP с кодом 418

О весе запросов и о том, как не выходить за него, рассказывает наш разбор лимитов API Binance, которые ломают торговых ботов.

Метки времени, подписи и API-ключи

Код Формулировка Binance Что делать
-1021 Timestamp for this request is outside of the recvWindow Синхронизируйте часы с серверным временем Binance; recvWindow по умолчанию 5000 мс
-1022 Signature for this request is not valid Неверный секретный ключ, либо параметры закодированы или упорядочены не так, как при подписи
-2014 API-key format invalid Ключ вставлен не полностью или с лишними символами
-2015 Invalid API-key, IP, or permissions for action Проверьте, что ключ существует, белый список IP и что фьючерсы включены

-1021 почти всегда означает, что уходят часы на машине, которая отправляет запрос, а не проблему у Binance; увеличенный recvWindow это скрывает, но не исправляет.

Иллюстрация: расхождение часов в 6200 мс не укладывается в стандартный recvWindow Binance в 5000 мс

За одним сообщением -2015 стоят три разные причины, и проверять приходится каждую: сам ключ, IP и разрешения.

Правила ордеров: точность, размер и цена

Код Формулировка Binance Что делать
-1111 Precision is over the maximum defined for this asset Округлите количество до шага количества (step size) у символа
-4003 Quantity less than zero Ошибка в расчёте размера дала нулевое или отрицательное количество
-4014 Price not increased by tick size Округлите цену до шага цены (tick size) у символа
-4164 Order's notional must be no smaller than 5.0 (unless you choose reduce only) Увеличьте стоимость ордера; на reduce-only ордера правило не распространяется
-4131 The counterparty's best price does not meet the PERCENT_PRICE filter limit Рыночный ордер в тонкий стакан; подождите или используйте лимитный ордер
-2020 Unable to fill Ордер, который должен исполниться сразу (например, fill-or-kill), ничего не нашёл по своей цене
-2025 Reach max open order limit Отмените устаревшие ордера, прежде чем добавлять новые

Шаг количества, шаг цены и минимальная номинальная стоимость берутся из exchangeInfo отдельно для каждого символа и у разных монет различаются. Читайте их при запуске и округляйте по ним каждый ордер. Исключение для reduce-only в -4164 важно для выходов: тейк-профит или стоп, который закрывает небольшой остаток, может быть ниже минимума и всё равно будет принят, если отправлен как reduce-only, так что помечайте этим флагом каждый выход.

Маржа и баланс

Код Формулировка Binance Что делать
-2018 Balance is insufficient Не хватает средств в самом кошельке; переведите их
-2019 Margin is insufficient Ордер стоит больше, чем баланс, доступный для ордеров

-2019 — самый частый отказ на счетах, где открыто несколько позиций. В стоимость ордера входит запас, который Binance закладывает для рыночных ордеров, а открытые ордера, нереализованные убытки и изолированные позиции уменьшают доступную сумму. Причин у этого отказа семь, и проверять их стоит по порядку.

Стопы, тейк-профиты и выходы

Код Формулировка Binance Что делать
-2021 Order would immediately trigger Условие срабатывания уже выполнено; проверьте сторону и цену, затем решите, закрывать позицию или выставлять ордер заново
-2022 ReduceOnly Order is rejected Выход конфликтует с позицией или с уже стоящими ордерами
-2024 Position is not sufficient Количество в reduce-only ордере больше позиции
-2011 CANCEL_REJECTED Ордер не удалось отменить, обычно потому, что он уже исполнен или отменён
-2013 Order does not exist Неверный ID ордера, либо ордера уже нет
-4120 Order type not supported for this endpoint. Please use the Algo Order API endpoints instead. С 9 декабря 2025 года стопы и тейк-профиты с триггером отправляются через Algo Order API

-2021 на стопе важнее всех остальных: позиция остаётся открытой без защиты, которую вы хотели ей дать. Правила срабатывания у каждой стороны свои, а код -2022 разобран в статье о том, почему отклоняется reduce-only ордер.

Плечо

Код Формулировка Binance Что делать
-4028 Invalid leverage Выше максимума для монеты; выберите значение, которое монета допускает
-4421 Subaccounts are restricted from using leverage greater than 5x Для субаккаунтов плечо ограничено 5x
-2027 Exceeded the maximum allowable position at current leverage Снизьте плечо или уменьшите позицию
-2028 Leverage is smaller than permitted: insufficient margin balance Не хватает маржи, чтобы снизить плечо
-4161 Leverage reduction is not supported in Isolated Margin Mode with open positions Закройте позицию, прежде чем снижать плечо

-4421 нет в публичном списке ошибок Binance, но Binance возвращает именно это сообщение, а правило о 5x для субаккаунтов, которое за ним стоит, записано в его FAQ. Кроме правила для субаккаунтов, плечо на Binance Futures ограничивают уровни плеча по размеру позиции и лимит 20x для новых аккаунтов.

Режимы счёта: тип маржи, режим позиции, Multi-Assets

Код Формулировка Binance Что делать
-4046 No need to change margin type Уже установлен; делать ничего не нужно
-4047 / -4048 Margin type cannot be changed if there exists open orders / position Сначала отмените ордера или закройте позицию по этому символу
-4175 Cannot change to ISOLATED mode due to credit status В публичном списке Binance его нет; изолированная маржа этому аккаунту недоступна, используйте кросс-маржу
-4059 No need to change position side Счёт уже в этом режиме
-4061 Order's position side does not match user's setting Несоответствие между односторонним режимом и режимом хеджирования
-4067 / -4068 Position side cannot be changed if there exists open orders / position Закройте всё на счёте, включая COIN-M, и после этого переключайте
-4167 / -4168 Isolated margin and Multi-Assets mode cannot be combined Используйте кросс-маржу или переведите счёт в режим Single-Asset

Коды режима позиции объясняет статья о том, что такое positionSide, а к семейству Multi-Assets относятся коды от -4167 до -4172.

После каких ошибок можно повторять запрос

Таблица: какие ошибки Binance можно повторять без изменений, а какие сначала требуют что-то поменять

Повторять без изменений стоит лишь немногие ошибки: превышение лимита после паузы, варианты 503 «Service Unavailable» и «Internal error», а также таймауты, но только после того, как вы убедились, что ордер не прошёл. Всё остальное сообщает что-то о вашем запросе или вашем счёте, и на тот же самый запрос придёт тот же самый ответ. Повторять -2019, -2021 или -4028 в цикле значит только тратить вес запросов, а заодно можно довести 429 до бана 418.

Матрица: ошибки по тому, на чьей стороне проблема и временная ли она

Что мы видим на счетах участников

HafizeBot записывает каждый отказ, который Binance возвращает, когда бот выставляет ордера участника. За 30 дней до 5 октября 2026 года за неудавшимися ордерами стояли такие коды, от самых частых к редким: недостаточно маржи (-2019) и лимит 5x для субаккаунтов (-4421), по 13 раз; смена режима позиции, заблокированная открытыми ордерами (-4067), и недопустимое плечо (-4028), по 5; точность количества (-1111), 3; отказ в изолированной марже при Multi-Assets (-4168) и несовпадение стороны позиции (-4061), по 2; затем смена типа маржи, заблокированная открытой позицией (-4048), и требование Binance подписать соглашение TradFi-Perps (-4411), по одному разу. Почти каждый из них — настройка или соглашение на счёте участника, а не баг, и команда бота /lastsignals объясняет каждый простыми словами.

Столбчатая диаграмма: отказы Binance на счетах участников HafizeBot по кодам ошибок за 30 дней

Прежде чем запускать бота на Binance Futures

Чек-лист перед запуском торгового бота на Binance Futures

Несколько проверок убирают большинство перечисленных кодов ещё до того, как они появятся: ключ с включёнными фьючерсами, выключенным выводом и белым списком IP; односторонний режим, если бот рассчитан на него; режим Single-Asset, если бот использует изолированную маржу; USDT на кошельке USDⓈ-M Futures; плечо в пределах лимитов монеты и аккаунта; часы, синхронизированные с интернетом. О самом ключе рассказывает руководство о том, как безопасно подключить бота к Binance по API.

Три числа об ошибках Binance, которые стоит запомнить

Часто задаваемые вопросы

Что такое коды ошибок Binance Futures? Отрицательные числа, которые Binance возвращает в ответе API вместе с HTTP-статусом, чтобы объяснить, почему запрос отклонён. Binance делит их на группы: -10xx — проблемы сервера или сети, -11xx — проблемы запроса, -20xx — проблемы обработки (ордера, маржа, ключи), -40xx — фильтры и прочее (правила символа, плечо, режимы счёта), -50xx — проблемы исполнения ордеров.

Что означает ошибка Binance -2015? «Invalid API-key, IP, or permissions for action»: ключа не существует или он удалён, запрос пришёл с IP, которого нет в белом списке ключа, либо у ключа нет нужного разрешения, например на торговлю фьючерсами.

Как исправить ошибку Binance -1021? Синхронизируйте часы машины, которая отправляет запросы, с серверным временем Binance. recvWindow по умолчанию равен 5000 мс; если его увеличить, небольшое расхождение перестанет мешать, но неверно идущие часы это не исправит.

Что означает HTTP 418 на Binance? Ваш IP автоматически забанен за то, что вы продолжали слать запросы после ответов 429 о превышении лимита. Прекратите запросы, дождитесь окончания бана и добавьте в код паузы между повторами (back-off).

Безопасно ли повторять ордер на Binance после ошибки 503? Только после проверки. Если в сообщении «Unknown error», Binance говорит, что статус исполнения неизвестен и ордер мог пройти; сначала запросите его по клиентскому ID ордера.

Что означает -4164 на Binance? Стоимость ордера ниже минимальной номинальной стоимости, которая в сообщении Binance для отправленного вами ордера указана как 5.0. На reduce-only ордера это правило не распространяется.

Коротко

По HTTP-статусу определите, на чьей стороне проблема, по коду — в чём она, измените то, на что код указывает, и повторяйте запрос, только когда что-то изменилось. При таймаутах и 503 «Unknown error» проверьте ордер, прежде чем отправлять заново.

Каждый сигнал, который отправляет HafizeBot, публикуется вместе с результатом на странице результатов, включая промахи, а самые сильные, с силой 3 и выше, попадают в бесплатный Telegram-канал через 20 минут после VIP, который получает все сигналы сразу. Это информация, а не инвестиционная рекомендация: на фьючерсах с плечом можно потерять больше, чем вы ожидаете, поэтому торгуйте только тем, что можете позволить себе потерять.

коды ошибок binance futures ошибки api binance ошибка 2015 binance ошибка 1021 binance api ошибки binance фьючерсы