Binance Futures comunica un problema en dos capas: un estado HTTP (como 400, 403, 418, 429 o 503), que indica qué tipo de fallo fue, y un código de Binance (un número negativo como -2019), que indica exactamente qué estaba mal. Esta página agrupa los códigos con los que más se topan traders y bots en USDⓈ-M Futures, y da para cada uno el texto original de Binance, la solución y si sirve de algo reintentar, con enlaces a nuestras guías completas de los más habituales.
Cómo leer un error de Binance
El estado HTTP te dice de qué lado está el problema. La documentación de la API de Binance dice que los códigos 4XX se usan «for malformed requests; the issue is on the sender's side» (solicitudes mal formadas; el problema está del lado de quien envía), y los 5XX «for internal errors; the issue is on Binance's side» (errores internos; el problema está del lado de Binance). Dentro de una respuesta 4XX, el cuerpo JSON trae un code y un msg, por ejemplo {"code": -2019, "msg": "Margin is insufficient."}.
La regla que más dinero ahorra: una orden rechazada no cambia nada. Antes de reintentar, pregúntate qué tiene que cambiar para que salga bien. Si no ha cambiado nada, el reintento fallará igual.
Conexión, límites de solicitudes y estados HTTP
| Estado o código | Texto de Binance | Qué hacer |
|---|---|---|
| HTTP 403 | Web Application Firewall limit violated | Baja el ritmo y revisa la solicitud; no machaques el endpoint |
| HTTP 408 | Timeout waiting for the backend | La solicitud puede haberse ejecutado o no: consulta la orden antes de reenviarla |
| HTTP 429 / -1003 | Request rate limit broken; "Too many requests" | Espera antes de seguir; usa streams websocket en vez de consultas repetidas |
| HTTP 418 | IP auto-banned for continuing after 429 | Detén todas las solicitudes hasta que termine el baneo |
| HTTP 503 "Unknown error" | Sent, but no response in time | El estado de ejecución es desconocido: comprueba antes de reintentar |
| HTTP 503 "Service Unavailable" / "Internal error" | A failed operation | Reintenta más tarde |
La documentación de Binance es explícita sobre la primera variante del 503: «It is important to NOT treat this as a failure operation; the execution status is UNKNOWN and could have been a success» (es importante no tratarlo como una operación fallida; el estado de ejecución es desconocido y pudo haber salido bien). Un bot que reenvía a ciegas después de recibirlo puede abrir la misma posición dos veces. Usa un ID de orden de cliente determinista, consulta por él y reenvía solo si la orden no existe.
Nuestra guía sobre los límites de la API de Binance que rompen los bots de trading explica los pesos de solicitud y cómo mantenerse por debajo.
Marcas de tiempo, firmas y claves API
| Código | Texto de Binance | Qué hacer |
|---|---|---|
| -1021 | Timestamp for this request is outside of the recvWindow | Sincroniza tu reloj con la hora del servidor de Binance; recvWindow vale 5.000 ms por defecto |
| -1022 | Signature for this request is not valid | Secreto equivocado, o parámetros codificados u ordenados de forma distinta a como los firmaste |
| -2014 | API-key format invalid | La clave se pegó incompleta o con caracteres de más |
| -2015 | Invalid API-key, IP, or permissions for action | Comprueba que la clave existe, la lista blanca de IP y que los futuros están habilitados |
El -1021 casi siempre es un reloj desajustado en la máquina que envía la solicitud, no un problema de Binance; un recvWindow mayor lo esconde, pero no lo arregla.
El -2015 tiene tres causas distintas detrás de un solo mensaje, y hay que revisarlas una a una.
Reglas de las órdenes: precisión, tamaño y precio
| Código | Texto de Binance | Qué hacer |
|---|---|---|
| -1111 | Precision is over the maximum defined for this asset | Redondea la cantidad al step size del símbolo |
| -4003 | Quantity less than zero | Un fallo de dimensionado produjo una cantidad cero o negativa |
| -4014 | Price not increased by tick size | Redondea el precio al tick size del símbolo |
| -4164 | Order's notional must be no smaller than 5.0 (unless you choose reduce only) | Aumenta el valor de la orden; las órdenes reduce-only están exentas |
| -4131 | The counterparty's best price does not meet the PERCENT_PRICE filter limit | Una orden a mercado contra un libro con poca liquidez; espera o usa una orden límite |
| -2020 | Unable to fill | Una orden que debe ejecutarse ya (como una fill-or-kill) no encontró nada a su precio |
| -2025 | Reach max open order limit | Cancela las órdenes obsoletas antes de añadir otras |
El step size, el tick size y el nocional mínimo salen de exchangeInfo para cada símbolo, y cambian de una moneda a otra. Léelos al arrancar y redondea cada orden según ellos. La exención de las reduce-only en el -4164 importa para las salidas: un take-profit o un stop que cierra un resto pequeño puede quedar por debajo del mínimo y aun así aceptarse, siempre que se envíe como reduce-only, así que marca así todas las salidas.
Margen y saldo
| Código | Texto de Binance | Qué hacer |
|---|---|---|
| -2018 | Balance is insufficient | A la propia cartera le faltan fondos; transfiere |
| -2019 | Margin is insufficient | La orden cuesta más que el saldo disponible para órdenes |
El -2019 es el rechazo más habitual en cuentas que llevan varias posiciones. El coste de la orden incluye el colchón que Binance aplica a las órdenes a mercado, y las órdenes abiertas, las pérdidas no realizadas y las posiciones en margen aislado reducen lo disponible. Detrás de un «Margin is insufficient» (-2019) puede haber hasta siete causas distintas, y conviene revisarlas por orden.
Stops, take-profits y salidas
| Código | Texto de Binance | Qué hacer |
|---|---|---|
| -2021 | Order would immediately trigger | La condición de activación ya se cumple; revisa el lado y el precio, y decide si cerrar o volver a colocarla |
| -2022 | ReduceOnly Order is rejected | La salida choca con la posición o con órdenes existentes |
| -2024 | Position is not sufficient | La cantidad reduce-only es mayor que la posición |
| -2011 | CANCEL_REJECTED | No se pudo cancelar la orden, normalmente porque ya se había ejecutado o cancelado |
| -2013 | Order does not exist | El ID de la orden es incorrecto, o la orden ya no existe |
| -4120 | Order type not supported for this endpoint. Please use the Algo Order API endpoints instead. | Los stops y take-profits con precio de activación van a la Algo Order API desde el 9 de diciembre de 2025 |
Un -2021 en un stop es el que más importa: la posición sigue abierta sin la protección que querías darle. Las reglas de activación de «Order would immediately trigger» (-2021) cambian según el lado de la orden, y reduce-only order failed trata el -2022.
Apalancamiento
| Código | Texto de Binance | Qué hacer |
|---|---|---|
| -4028 | Invalid leverage | Por encima del máximo de la moneda; elige un valor que la moneda permita |
| -4421 | Subaccounts are restricted from using leverage greater than 5x | Las subcuentas tienen un tope de 5x |
| -2027 | Exceeded the maximum allowable position at current leverage | Menos apalancamiento o una posición más pequeña |
| -2028 | Leverage is smaller than permitted: insufficient margin balance | No hay margen suficiente para bajar el apalancamiento |
| -4161 | Leverage reduction is not supported in Isolated Margin Mode with open positions | Cierra la posición antes de bajarlo |
El -4421 no figura en la lista pública de errores de Binance, pero es el mensaje que Binance devuelve, y sus preguntas frecuentes recogen la regla de 5x para subcuentas que hay detrás. Aparte de los tramos de apalancamiento de cada moneda y de la regla de las subcuentas, las cuentas nuevas tienen un límite de 20x.
Modos de la cuenta: tipo de margen, modo de posición, Multi-Assets
| Código | Texto de Binance | Qué hacer |
|---|---|---|
| -4046 | No need to change margin type | Ya está configurado; no hay nada que hacer |
| -4047 / -4048 | Margin type cannot be changed if there exists open orders / position | Cancela antes las órdenes o cierra la posición en ese símbolo |
| -4175 | Cannot change to ISOLATED mode due to credit status | No figura en la lista pública de Binance; el margen aislado no está disponible para la cuenta, así que usa el cruzado |
| -4059 | No need to change position side | Ya está en ese modo |
| -4061 | Order's position side does not match user's setting | Desajuste entre modo unidireccional (one-way) y modo de cobertura (hedge) |
| -4067 / -4068 | Position side cannot be changed if there exists open orders / position | Deja la cuenta sin posiciones ni órdenes, COIN-M incluido, y después cambia |
| -4167 / -4168 | Isolated margin and Multi-Assets mode cannot be combined | Usa margen cruzado, o pasa la cuenta al modo Single-Asset |
Los códigos del modo de posición se explican en qué es positionSide; la familia Multi-Assets va del -4167 al -4172.
Qué errores se pueden reintentar sin riesgo
Solo unos pocos errores merecen un reintento sin cambios: los límites de solicitudes tras una pausa, las variantes "Service Unavailable" e "Internal error" del 503, y los timeouts después de haber comprobado que la orden no entró. Todo lo demás es una afirmación sobre tu solicitud o tu cuenta, y reenviar lo mismo obtiene la misma respuesta. Reintentar en bucle un -2019, un -2021 o un -4028 solo gasta peso de solicitud, y puede convertir un 429 en un baneo 418.
Lo que vemos en las cuentas de los miembros
HafizeBot registra cada rechazo que Binance devuelve cuando coloca las órdenes de un miembro. En los 30 días hasta el 5 de octubre de 2026, los códigos detrás de las órdenes fallidas fueron, de más a menos frecuente: margen insuficiente (-2019) y el límite de 5x en subcuentas (-4421), 13 veces cada uno; cambios de modo de posición bloqueados por órdenes abiertas (-4067) y apalancamiento no válido (-4028), 5 cada uno; precisión de la cantidad (-1111), 3; el rechazo del margen aislado con Multi-Assets (-4168) y un desajuste del lado de la posición (-4061), 2 cada uno; y por último un cambio de tipo de margen bloqueado por una posición abierta (-4048) y la petición de Binance de firmar su acuerdo de TradFi-Perps (-4411), una vez cada uno. Casi todos son un ajuste o un acuerdo pendiente en la cuenta del miembro, no un fallo, y el comando /lastsignals del bot explica cada uno con palabras sencillas.
Antes de poner un bot a operar en Binance Futures
Unas pocas comprobaciones eliminan la mayoría de los códigos anteriores antes de que aparezcan: una clave con futuros habilitados, retiros desactivados y lista blanca de IP; modo unidireccional si el bot lo espera; modo Single-Asset si usa margen aislado; USDT en la cartera de USDⓈ-M Futures; un apalancamiento dentro de los límites de la moneda y de la cuenta; y un reloj sincronizado con internet. Cómo conectar un bot de trading a Binance de forma segura se ocupa de la clave en sí.
Preguntas frecuentes
¿Qué son los códigos de error de Binance Futures? Números negativos que Binance devuelve en una respuesta de la API para decir por qué se rechazó una solicitud, junto a un estado HTTP. Binance los agrupa así: -10xx, problemas de servidor o de red; -11xx, problemas de la solicitud; -20xx, problemas de procesamiento (órdenes, margen, claves); -40xx, filtros y otros problemas (reglas del símbolo, apalancamiento, modos de la cuenta); y -50xx, problemas de ejecución de órdenes.
¿Qué significa el error -2015 de Binance? "Invalid API-key, IP, or permissions for action": la clave no existe o fue eliminada, la solicitud llegó desde una IP que no está en su lista blanca, o a la clave le falta el permiso, por ejemplo el de operar futuros.
¿Cómo soluciono el error -1021 de Binance?
Sincroniza el reloj de la máquina que envía con la hora del servidor de Binance. El recvWindow por defecto es de 5.000 ms; subirlo esconde un desfase pequeño, pero no un reloj que está mal.
¿Qué significa HTTP 418 en Binance? Que tu IP fue baneada automáticamente por seguir enviando solicitudes después de recibir respuestas 429 por límite de solicitudes. Deja de enviar, espera a que termine el baneo y añade esperas progresivas (back-off) a tu código.
¿Es seguro reintentar una orden de Binance después de un error 503? Solo después de comprobar. Si el mensaje es "Unknown error", Binance dice que el estado de ejecución es desconocido y que la orden puede haber entrado; consúltala primero por su ID de orden de cliente.
¿Qué significa -4164 en Binance? Que el valor de la orden está por debajo del nocional mínimo, que el mensaje de Binance cifra en 5.0 para la orden que enviaste. Las órdenes reduce-only están exentas.
En resumen
Lee el estado HTTP para saber de qué lado está el problema, lee el código para saber cuál es, cambia aquello a lo que apunta el código y reintenta solo cuando algo haya cambiado. Con los timeouts y el 503 "Unknown error", comprueba la orden antes de reenviarla.
Cada señal que envía HafizeBot se publica con su resultado en la página de rendimiento, fallos incluidos, y las más fuertes, las de fuerza 3 o superior, llegan al canal gratuito de Telegram 20 minutos después que al VIP, que recibe todas las señales al instante. Esto es información, no asesoramiento de inversión: los futuros con apalancamiento pueden hacerte perder más de lo que esperas, así que opera solo con lo que puedas permitirte perder.