Límites de la API de Binance (2026): peso 2.400, 429 y 418

· 11 min de lectura

Binance Futures da a cada IP un presupuesto de 2.400 unidades de peso de solicitud por minuto móvil, y un bot de trading no lo revienta por operar demasiado, sino por leer demasiado. Colocar una orden cuesta 1 unidad. Consultar tus órdenes abiertas cuesta 40. Un bot que comprueba sus ejecuciones a base de consultas puede gastarse el minuto entero en 54 llamadas, recibir un HTTP 429, seguir insistiendo y acabar con la IP baneada, arrastrando consigo a todos los demás bots que salen por esa dirección. La solución está en el diseño, y ningún bucle de reintentos la sustituye: recibe las ejecuciones por stream en vez de consultarlas, y frénate tú al 90 % del límite antes de que Binance te frene al 100 %.

Imagen de portada sobre los límites de la API de Binance y los bots de trading

Este artículo sale de operar un autotrader que coloca órdenes para muchos usuarios en más de 500 pares desde una infraestructura compartida, donde un baneo por exceso de solicitudes no es problema de una sola persona. Las cifras de abajo son las que el bot se impone de verdad a sí mismo.

El presupuesto dentro del que vive todo bot de futuros

Tres cifras: 2.400 de peso por minuto, 2.160 como techo propio del bot y una ventana de 60 segundos

Binance no cuenta solicitudes. Cuenta peso. Cada endpoint tiene un coste, y el límite REQUEST_WEIGHT (2.400 por minuto en Futures, contado por IP) pone tope al total.

La ventana es deslizante; no sigue el reloj. Una solicitud de hace 59 segundos todavía cuenta; una de hace 61 ya ha salido. Esto importa en las ráfagas: si gastas 2.000 unidades en diez segundos, el contador no se pone a cero al empezar el minuto siguiente. Tienes que esperar a que esas entradas vayan caducando una a una.

El bot lee el límite real del endpoint exchangeInfo de Binance al arrancar, en vez de dejarlo fijo en el código, y luego le aplica un factor de seguridad de 0,9. Así que se frena a sí mismo en 2.160, no en 2.400. Las 240 unidades restantes son margen para reintentos, para el desfase de reloj entre el bot y el exchange, y para el hecho de que la cuenta de Binance y la tuya nunca coincidirán a la unidad.

No todas las llamadas cuestan lo mismo

Tabla con el peso de solicitud de cada endpoint que usa el bot

Esta es la tabla que decide si un bot sobrevive. Los endpoints que usa el bot y lo que cuesta cada uno:

  • Colocar una orden: 1
  • Colocar una orden algorítmica, o algo order (take-profit dinámico, trailing): 1
  • Fijar el apalancamiento o el tipo de margen: 1
  • Abrir o renovar la listen key del stream de datos de usuario: 1
  • Leer el riesgo de posición: 5
  • Leer las órdenes algorítmicas abiertas: 5
  • Leer las órdenes abiertas: 40

Operar es barato. Leer es caro, y leer las órdenes abiertas es carísimo. Toda la disciplina para que no te baneen se reduce a esa asimetría.

Gráfico de barras: el presupuesto de un mismo minuto da para 2.160 órdenes, 432 lecturas de posición o 54 consultas de órdenes abiertas

Si gastas un minuto entero de una sola manera, puedes colocar 2.160 órdenes. Si lo gastas leyendo posiciones, te salen 432 lecturas. Si lo gastas consultando órdenes abiertas, te salen 54, menos de una por segundo, antes de que te corten.

Cómo acaba baneado un bot casero

El patrón es siempre el mismo. El bot coloca una orden y luego quiere saber si se ejecutó. Lo obvio es preguntar: llamar al endpoint de órdenes abiertas y ver si la orden sigue ahí. Preguntar cada segundo, sin indicar el símbolo. Cada llamada cuesta 40: son 2.400 por minuto, el presupuesto entero en un solo bucle.

Línea temporal de un problema de límite de solicitudes que escala de un 429 a un baneo de IP

Binance responde con HTTP 429 y el error -1003, TOO_MANY_REQUESTS. Un bot sin limitador ni se entera y sigue preguntando. Binance trata las solicitudes que siguen llegando después de un 429 como abuso y devuelve HTTP 418: la IP queda baneada, al principio unos minutos, y más tiempo con cada reincidencia.

Lo que mucha gente pasa por alto: el baneo es por IP. Si el bot comparte servidor o conexión doméstica con cualquier otra cosa que hable con Binance, todo eso queda muerto mientras dure.

Qué ocurre antes de que cada solicitud salga del bot

Flujo: descartar las entradas de más de 60 segundos, comprobar si la llamada superaría el techo, esperar si es así, enviar y leer la cabecera de peso usado

El limitador del bot es un presupuesto de ventana deslizante. Antes de cualquier solicitud, descarta las entradas de más de sesenta segundos y comprueba si el peso de la llamada llevaría la ventana por encima de 2.160. Si es así, el bot registra un aviso con el motivo, espera un segundo, vuelve a descartar y vuelve a comprobar, el tiempo que haga falta. Solo cuando la llamada cabe la envía, y anota una marca de tiempo por cada unidad de peso.

Tras la respuesta, lee la cabecera de peso usado que devuelve Binance y cuadra las cuentas. La cuenta de Binance es la que manda; si las dos se separan, el bot se fía del exchange.

Gráfico ilustrativo del peso usado en los últimos 60 segundos durante un minuto de mucha actividad, que se aplana al llegar al techo

El efecto visible es una cima plana. Durante una ráfaga de señales la ventana sube, llega a 2.160 y se queda ahí mientras el bot se frena a sí mismo; cuando las entradas antiguas pasan del minuto, la línea baja y el bot continúa. Nunca toca los 2.400, así que nunca ve un 429.

Consultar frente a recibir por stream

Comparación entre consultar las órdenes abiertas y usar el stream de datos de usuario

El limitador evita que el bot se meta en problemas. El diseño es lo que lo hace barato. Binance ofrece un stream WebSocket de datos de usuario: abres una listen key (peso 1) y el exchange te envía cada ejecución y cada cambio de posición en el momento en que ocurre. Sin consultas. Sin lecturas de 40 de peso para enterarte de algo que ya te podían haber contado.

Así se entera el bot de las ejecuciones, y por eso una ráfaga de señales que arruinaría el presupuesto de un bot que consulta apenas le cuesta a un bot con stream algo más que las propias órdenes. Las lecturas de posición siguen haciéndose, con peso 5 y de forma programada, pero la lectura cara de órdenes abiertas se reserva para la conciliación. Las ejecuciones nunca se descubren así.

Que el coste no crezca con el número de símbolos es lo que permite a un solo proceso operar más de 500 pares. Un diseño basado en consultas escala linealmente con los símbolos; uno basado en stream no escala en absoluto, en el buen sentido.

Síntomas de que tu bot está chocando con el límite

Lista de síntomas de un bot frenado por el límite de solicitudes

Si tienes tu propio bot, estas son las pistas:

  • HTTP 429 en cualquier parte de los logs.
  • Error -1003.
  • Órdenes que se colocan segundos después de la señal y no al instante. El limitador, o Binance, te está haciendo esperar.
  • HTTP 418 y todas las solicitudes fallando a la vez.
  • Un pico de consumo justo después de un reinicio, cuando el bot lee un estado que podría haber conservado.
  • Añadir un símbolo más lo empeora todo. Esa es la firma de un bot que consulta.

Señales a ráfagas contra un diseño que consulta

Cuadrante de stream frente a consultas y de llegada de señales a ráfagas frente a llegada uniforme

Las señales no llegan de forma uniforme. En una hora volátil el modelo puede dispararse en decenas de pares en cuestión de minutos y luego quedarse en silencio. Un bot que consulta agota su presupuesto en la ráfaga y pasa baneado la calma que viene después. Un bot con stream se frena un momento durante la ráfaga y se recupera en menos de un minuto.

Desglose ilustrativo de cómo se gasta el presupuesto de peso en un minuto de mucha actividad

Incluso un bot bien diseñado gasta la mayor parte de un minuto ajetreado en lecturas (riesgo de posición y conciliación) y no en órdenes, y por eso importa el techo del 90 %. Las órdenes son la parte barata; el factor de seguridad protege las lecturas que mantienen fiel la imagen que el bot tiene de tu cuenta.

Dónde se frena el bot y dónde te frena Binance

Indicador de 0 a 2.400 con el techo del bot en 2.160

Hay dos techos. El del bot está en 2.160 y produce una espera de un segundo y una línea en el log. El de Binance está en 2.400 y produce un 429 y después un baneo. El hueco entre los dos es toda la diferencia entre un bot que a veces espera y un bot que a veces muere.

Si estás evaluando cualquier bot, esta es una pregunta técnica legítima para quien lo opera: ¿cuál es vuestro techo de peso de solicitud y cómo os enteráis de las ejecuciones? Tanto «consultamos» como «nunca hemos llegado a un límite» son respuestas que te dicen algo.

El límite de órdenes es un presupuesto aparte

El peso de solicitud no es el único límite que aparece en exchangeInfo. Binance publica también un límite ORDERS: un tope al número de órdenes colocadas por intervalo corto, independiente del peso. Un bot puede estar muy por debajo de 2.400 de peso y aun así rebasarlo si dispara una ráfaga de entradas, salidas y stops en el mismo segundo, porque cada una de ellas es una orden.

Los dos límites fallan de forma distinta. El peso se agota leyendo; las órdenes se agotan con una ráfaga de señales en muchos símbolos a la vez. Un bot que recibe las ejecuciones por stream ha resuelto lo primero y todavía tiene que dosificar lo segundo, que es una razón más para colocar la entrada, el take-profit y el stop en secuencia y no todos de golpe, y para que un máximo de posiciones proteja el presupuesto del bot tanto como tu cartera.

La listen key hay que mantenerla viva

El stream de datos de usuario no dura para siempre. La listen key que lo abre caduca si el bot no la renueva, y la regla de Binance es que una clave desatendida durante una hora se descarta. Una clave descartada significa que el stream se queda mudo. Dejan de llegar ejecuciones, la imagen que el bot tiene de tu cuenta se queda desfasada, y lo siguiente que hace es recurrir a lecturas caras para averiguar qué se ha perdido.

Por eso el bot renueva la listen key de forma programada, con peso 1 cada vez. Es la solicitud más barata que hace y la que menos se puede permitir saltarse. Si alguna vez ves que el peso de lectura de un bot se dispara sin motivo aparente, lo primero de lo que hay que sospechar es de una listen key caducada.

Qué registra el bot cuando se frena

El freno no es silencioso. Cada vez que el limitador retiene una solicitud, escribe un aviso con el motivo por el que se hacía la solicitud, cuánto peso hay ya en la ventana, el techo y cuánto necesita la solicitud. Con eso basta para saber, a posteriori, si una orden lenta se debió a una ráfaga de señales o a un bucle de lecturas desbocado. Desde fuera los dos casos parecen idénticos y se arreglan de maneras opuestas.

Por qué importa más en una infraestructura compartida

El bot de un solo usuario en una conexión doméstica deja baneada a una persona. Un servicio que coloca órdenes para muchos usuarios desde servidores compartidos no puede permitirse ni un solo baneo, porque pararía a todos a la vez, justo en el tramo volátil en que saltaban las señales. El limitador y el stream no son optimizaciones. Son lo que hace posible llevar muchas cuentas desde un mismo sitio.

Por eso mismo el bot desactiva a un usuario cuya clave API no funciona en lugar de reintentar: una clave rechazada que se reintenta sin fin es puro peso gastado en una solicitud que no puede salir bien. Y por eso también se puede sobrevivir a una caída: las salidas esperan en el exchange, así que un bot frenado o reiniciándose no deja ninguna posición desprotegida.

Qué sacar de esto si estás eligiendo un bot y no construyéndolo

No hace falta construir nada de esto para que te sirva conocerlo. Si estás decidiendo si usar un bot, ¿merecen la pena los bots de trading de criptomonedas? es un buen panorama general, y conectar un bot de trading a Binance con una clave API segura repasa los permisos. Si la ingeniería da resultados se ve en un solo sitio: la página de rendimiento en vivo, que se regenera cada hora, con las señales expiradas contadas en contra de la tasa de acierto. Un bot baneado en mitad de una ráfaga lo mostraría como operaciones perdidas. Las preguntas, al bot en t.me/hafizebot.

Preguntas frecuentes

¿Cuál es el límite de solicitudes de la API de Binance Futures? 2.400 unidades de peso de solicitud por ventana móvil de 60 segundos y por IP. Se cuenta peso, no número de solicitudes: colocar una orden cuesta 1 y leer las órdenes abiertas cuesta 40.

¿Qué significa el error -1003 en Binance? TOO_MANY_REQUESTS, que llega con un HTTP 429 cuando tu peso supera el límite. Si sigues enviando después de un 429, Binance sube a HTTP 418, un baneo de IP que se alarga con cada reincidencia.

¿Por qué consultar las órdenes abiertas hace que baneen a los bots? Porque la llamada cuesta 40 de peso. Con cincuenta y cuatro se llena el minuto entero. Un bot que consulta cada segundo agota su presupuesto en un minuto y, si sigue, acaba baneado.

¿Cómo se entera un bot de las ejecuciones sin consultar? Por el stream WebSocket de datos de usuario. Abrir una listen key cuesta 1 de peso, y a partir de ahí Binance envía cada ejecución y cada cambio de posición en cuanto ocurre.

¿Por qué frenarse al 90 % del límite y no al 100 %? Porque tu cuenta y la de Binance nunca coincidirán del todo, los reintentos cuestan peso y los relojes se desfasan. El bot se frena en 2.160 para no llegar nunca a los 2.400 en los que lo frenaría Binance.

¿Un baneo por límite de solicitudes afecta a mis posiciones abiertas? No. Un baneo corta las solicitudes nuevas; las posiciones existentes y las órdenes de take-profit y stop que esperan en Binance no se ven afectadas.

Nota final

Los límites de solicitudes no rompen a los bots que operan mucho. Rompen a los que preguntan mucho. Recibe por stream lo que puedas, presupuesta lo que no te quede más remedio que leer y deja en paz el último 10 %.

Nada de esto es asesoramiento de inversión. Los futuros de criptomonedas conllevan un alto riesgo de pérdida; opera solo con dinero que puedas permitirte perder.

límite de solicitudes api binance peso de solicitud binance binance 429 too many requests baneo de ip api binance bot error 1003 binance