Лимиты API Binance (2026): вес 2400, ошибки 429 и 418

· 11 мин чтения

Binance Futures выделяет на каждый IP-адрес 2400 единиц веса запросов на скользящую минуту, и торговый бот выходит за этот бюджет не потому, что много торгует, а потому, что много читает. Выставить ордер стоит 1 единицу. Запросить открытые ордера стоит 40. Бот, который узнаёт об исполнениях опросом, тратит всю минуту за 54 вызова, получает HTTP 429, продолжает слать запросы и зарабатывает бан по IP, а вместе с ним ложатся все остальные боты на этом адресе. Циклом повторных попыток это не лечится, нужно другое устройство бота: получать исполнения потоком, а не опросом, и останавливаться самому на 90% лимита, не дожидаясь, пока на 100% остановит Binance.

Обложка: лимиты API Binance и торговые боты

Статья написана по опыту работы автотрейдера, который выставляет ордера за многих пользователей на 500+ парах с общей инфраструктуры, где бан за превышение лимита касается далеко не одного человека. Числа ниже бот действительно применяет к самому себе.

Бюджет, в котором живёт любой фьючерсный бот

Три числа: 2400 единиц веса в минуту, 2160 как собственный потолок бота, окно в 60 секунд

Binance считает не запросы. Он считает вес. У каждого эндпоинта своя цена, а лимит REQUEST_WEIGHT (на Futures это 2400 в минуту на один IP-адрес) ограничивает их сумму.

Окно скользящее и к часам не привязано. Запрос, сделанный 59 секунд назад, ещё учитывается; сделанный 61 секунду назад уже выпал. Это важно при всплесках: если потратить 2000 единиц за десять секунд, в начале следующей минуты счётчик не обнулится. Придётся ждать, пока эти записи устареют одна за другой.

Бот не зашивает лимит в код, а при запуске читает его действующее значение из эндпоинта exchangeInfo и умножает на коэффициент запаса 0,9. Поэтому он останавливает себя на 2160, а не на 2400. Оставшиеся 240 единиц нужны на повторные попытки, на расхождение часов бота и биржи и на то, что подсчёт Binance и ваш собственный никогда не сойдутся до единицы.

Не все вызовы стоят одинаково

Таблица: вес запроса для каждого эндпоинта, которым пользуется бот

От этой таблицы зависит, выживет ли бот. Эндпоинты, которыми он пользуется, и цена каждого:

  • Выставить ордер: 1
  • Выставить алго-ордер (трейлинг-тейк-профит): 1
  • Задать плечо или тип маржи: 1
  • Открыть или продлить listen key для потока пользовательских данных: 1
  • Прочитать риск по позициям: 5
  • Прочитать открытые алго-ордера: 5
  • Прочитать открытые ордера: 40

Торговать дёшево. Читать дорого, а читать открытые ордера очень дорого. Вся наука о том, как не получить бан, сводится к этой асимметрии.

Столбчатая диаграмма: на один и тот же минутный бюджет можно выставить 2160 ордеров, 432 раза прочитать позиции или 54 раза опросить открытые ордера

Если потратить всю минуту на ордера, их можно выставить 2160. Если на чтение позиций, выйдет 432 чтения. Если на опрос открытых ордеров, то 54, то есть меньше одного в секунду, и дальше вас начнут ограничивать.

Как самодельный бот получает бан

Сценарий всегда один и тот же. Бот выставляет ордер и хочет узнать, исполнился ли он. Самый очевидный способ — спросить: вызвать эндпоинт открытых ордеров и посмотреть, на месте ли ордер. И спрашивать раз в секунду, не указывая символ. Каждый такой вызов стоит 40 единиц: это 2400 в минуту, весь бюджет на один цикл.

Хронология: проблема с лимитом запросов разрастается от ответа 429 до бана по IP

Binance отвечает HTTP 429 и ошибкой -1003, TOO_MANY_REQUESTS. Бот без ограничителя этого не замечает и продолжает спрашивать. Запросы, которые идут после 429, Binance расценивает как злоупотребление и возвращает HTTP 418: IP забанен, сначала на минуты, а с каждым повтором на всё больший срок.

И вот что многие упускают: бан выдаётся на IP. Если бот делит сервер или домашнее подключение с чем-то ещё, что обращается к Binance, на время бана не работает всё.

Что происходит перед каждым запросом бота

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

Ограничитель бота — это бюджет в скользящем окне. Перед любым запросом он выбрасывает записи старше шестидесяти секунд, затем проверяет, не выйдет ли окно за 2160, если добавить вес этого вызова. Если выйдет, бот пишет в лог предупреждение с причиной, ждёт одну секунду, снова чистит окно и проверяет ещё раз, и так столько, сколько потребуется. Запрос уходит, только когда он помещается в бюджет, и на каждую единицу его веса записывается одна отметка времени.

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

Примерный график веса, потраченного за последние 60 секунд в напряжённую минуту: линия выравнивается у потолка

Снаружи это выглядит как плоская вершина графика. Во время всплеска сигналов окно растёт, упирается в 2160 и держится там, пока бот сам себя притормаживает; когда старым записям исполняется больше минуты, линия опускается, и бот продолжает работу. До 2400 он не доходит никогда, поэтому и 429 никогда не видит.

Опрос или поток

Сравнение: опрос открытых ордеров и поток пользовательских данных

Ограничитель спасает бота от неприятностей. А дешёвым его делает архитектура. У Binance есть WebSocket-поток пользовательских данных (user-data stream): открываете listen key (вес 1), и биржа сама присылает каждое исполнение и каждое изменение позиции в тот момент, когда оно происходит. Никакого опроса. Никаких чтений по 40 единиц ради того, что вам и так бы сообщили.

Именно так бот узнаёт об исполнениях, и поэтому всплеск сигналов, который съел бы весь бюджет бота на опросе, боту на потоке не стоит почти ничего сверх самих ордеров. Позиции он по-прежнему читает, по 5 единиц и по расписанию, а дорогое чтение открытых ордеров оставлено для сверки. Об исполнениях бот таким способом не узнаёт никогда.

Одному процессу удаётся торговать на 500+ парах именно потому, что расход не растёт вместе с числом символов. У бота на опросе он растёт линейно, с каждым новым символом, а у бота на потоке не растёт вообще, и это тот редкий случай, когда отсутствие роста радует.

Признаки того, что ваш бот упирается в лимит

Чек-лист: признаки того, что бот упирается в лимит запросов

Если у вас свой бот, вот по чему это видно:

  • HTTP 429 где угодно в логах.
  • Ошибка -1003.
  • Ордера выставляются через несколько секунд после сигнала, а не сразу. Ждать вас заставляет ограничитель или сам Binance.
  • HTTP 418, и все запросы падают разом.
  • Скачок расхода сразу после перезапуска, когда бот заново читает состояние, которое мог бы сохранить.
  • Стоит добавить ещё один символ, и всё становится хуже. Так выдаёт себя опрос.

Сигналы идут пачками, а бот опрашивает биржу

Матрица: поток и опрос при неравномерном и равномерном поступлении сигналов

Сигналы приходят неравномерно. В волатильный час модель может за считаные минуты сработать по десяткам пар, а потом затихнуть. Бот на опросе исчерпывает бюджет во время всплеска и сидит в бане всё затишье после него. Бот на потоке во время всплеска ненадолго притормаживает и в пределах минуты приходит в норму.

Примерная раскладка: на что уходит бюджет веса в напряжённую минуту

Даже у хорошо спроектированного бота большая часть напряжённой минуты уходит на чтение (риск по позициям и сверку), а не на ордера, и поэтому потолок в 90% так важен. Ордера — дешёвая часть; коэффициент запаса бережёт чтения, благодаря которым представление бота о вашем счёте остаётся верным.

Где бот останавливает себя сам и где вас останавливает Binance

Шкала от 0 до 2400 с потолком бота на отметке 2160

Потолков два. У бота он 2160, и за ним следует секундная пауза и строка в логе. У Binance он 2400, и за ним следует 429, а потом бан. Зазор между ними и отличает бота, который иногда ждёт, от бота, который иногда умирает.

Если вы присматриваетесь к какому-нибудь боту, его оператору можно задать честный технический вопрос: какой у вас потолок по весу запросов и как вы узнаёте об исполнениях? И «мы опрашиваем», и «мы ни разу не упирались в лимит» — ответы, которые кое о чём говорят.

Лимит ордеров — отдельный бюджет

Вес запросов — не единственный лимит в exchangeInfo. Binance публикует ещё и лимит ORDERS: ограничение на число ордеров, выставленных за короткий интервал, которое от веса не зависит. Бот может быть далеко от 2400 единиц веса и всё равно нарушить его, если в одну секунду выпустит пачку входов, выходов и стопов, ведь каждый из них — ордер.

Эти два лимита исчерпываются по-разному. Вес кончается из-за чтения, лимит ордеров — из-за всплеска сигналов сразу по многим символам. Бот, который получает исполнения потоком, первую задачу решил, а вторую ему всё ещё приходится решать темпом. Это ещё одна причина, по которой вход, тейк-профит и стоп выставляются по очереди, а не все сразу, и по которой настройка максимума позиций бережёт бюджет бота не меньше, чем ваш кошелёк.

Listen key нужно поддерживать живым

Поток пользовательских данных не бесплатен навечно. Listen key, который его открывает, истекает, если бот его не продлевает, и правило Binance таково: ключ, оставленный без внимания на час, удаляется. Удалённый ключ означает, что поток замолкает. Исполнения перестают приходить, представление бота о вашем счёте устаревает, и следующим шагом он скатывается к дорогим чтениям, чтобы выяснить, что пропустил.

Поэтому бот продлевает listen key по расписанию, каждый раз за 1 единицу веса. Это самый дешёвый его запрос и тот, который ему меньше всего можно пропускать. Если вес чтения у какого-то бота вдруг подскочил без видимой причины, первым делом стоит подозревать истёкший listen key.

Что бот пишет в лог, когда притормаживает

Бот притормаживает не молча. Каждый раз, когда ограничитель задерживает запрос, он записывает предупреждение: зачем делался запрос, сколько веса уже в окне, каков потолок и сколько нужно этому запросу. Этого хватает, чтобы задним числом понять, чем был вызван медленный ордер: всплеском сигналов или зациклившимся чтением. Снаружи они выглядят одинаково, а лечатся противоположным образом.

Почему на общей инфраструктуре это важнее

Бот одного пользователя на домашнем подключении банит одного человека. Сервис, который выставляет ордера за многих пользователей с общих серверов, не может позволить себе ни одного бана: он остановил бы всех пользователей разом, причём именно в тот волатильный отрезок, когда шли сигналы. Ограничитель и поток — не оптимизация. Без них вести много счетов из одного места было бы вообще невозможно.

По той же причине при негодном API-ключе бот отключает пользователя, а не повторяет попытки: отклонённый ключ, который пробуют снова и снова, — это вес, потраченный впустую на запрос, который не может пройти. И по той же причине сбой можно пережить: выходы стоят на бирже, так что бот, который притормаживает или перезапускается, не оставляет позицию без защиты.

Что из этого вынести, если вы выбираете бота, а не пишете его

Чтобы эти знания пригодились, строить всё это самому не нужно. Если вы решаете, пользоваться ли ботом вообще, начните со статьи о том, стоят ли криптоботы своих денег, а о разрешениях рассказывает руководство по безопасному подключению бота к Binance по API. Даёт ли вся эта инженерия результат, видно в одном месте: на живой странице результатов, которая пересобирается каждый час и на которой истёкшие сигналы снижают процент попаданий. Бот, забаненный посреди всплеска, показал бы это пропущенными сделками. Вопросы можно задать боту в t.me/hafizebot.

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

Какой лимит запросов у API Binance Futures? 2400 единиц веса запросов в скользящем 60-секундном окне на один IP-адрес. Считается вес, а не число запросов: выставить ордер стоит 1, прочитать открытые ордера стоит 40.

Что означает ошибка -1003 на Binance? TOO_MANY_REQUESTS, она приходит вместе с HTTP 429, когда ваш вес превышает лимит. Если после 429 продолжать слать запросы, Binance переходит к HTTP 418, то есть к бану по IP, срок которого растёт с каждым повтором.

Почему за опрос открытых ордеров ботов банят? Потому что этот вызов стоит 40 единиц веса. Пятьдесят четыре таких вызова занимают всю минуту. Бот, который опрашивает раз в секунду, исчерпывает бюджет за минуту и, если не остановится, получает бан.

Как бот узнаёт об исполнениях без опроса? Через WebSocket-поток пользовательских данных. Открыть listen key стоит 1 единицу веса, после чего Binance сам присылает каждое исполнение и каждое изменение позиции по мере того, как они происходят.

Зачем останавливаться на 90% лимита, а не на 100%? Потому что ваш подсчёт и подсчёт Binance никогда не совпадут в точности, повторные попытки стоят веса, а часы расходятся. Бот притормаживает себя на 2160, чтобы никогда не дойти до 2400, где его притормозит Binance.

Влияет ли бан за превышение лимита на мои открытые позиции? Нет. Бан останавливает новые запросы; уже открытые позиции и их тейк-профиты и стопы, стоящие на Binance, он не затрагивает.

В заключение

Лимиты ломают не тех ботов, которые много торгуют. Они ломают тех, которые много спрашивают. Получайте потоком всё, что можно, считайте бюджет там, где без запросов не обойтись, и не трогайте последние 10%.

Ничто из этого не является инвестиционной рекомендацией. Торговля криптофьючерсами сопряжена с высоким риском потерь; торгуйте только теми деньгами, которые можете позволить себе потерять.

лимиты api binance вес запросов binance binance 429 too many requests бан ip binance api ошибка 1003 binance