Códigos de error de Binance Futures: 35 códigos y solución

· 10 min de lectura

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.

Portada: códigos de error de Binance Futures, qué significa cada uno y cómo solucionarlo

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."}.

Comparación entre el estado HTTP y el código de error de Binance en una misma respuesta

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.

Flujo para gestionar un error de Binance: leer el estado, localizar el grupo del código, corregir la causa y reintentar una sola vez

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.

Línea temporal de una escalada por límite de solicitudes: solicitudes, respuestas 429 ignoradas y después un baneo de IP con 418

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.

Ilustración: un desfase de reloj de 6.200 ms queda fuera del recvWindow por defecto de Binance, de 5.000 ms

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

Tabla de qué errores de Binance se pueden reintentar tal cual y cuáles necesitan antes un cambio

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.

Cuadrante: errores según de qué lado está el problema y según si es temporal

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.

Gráfico de barras de los rechazos de Binance en las cuentas de miembros de HafizeBot por código de error durante 30 días

Antes de poner un bot a operar en Binance Futures

Lista de comprobación antes de poner un bot de trading 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í.

Tres cifras que conviene recordar sobre los errores de Binance

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.

códigos de error binance futures códigos de error api binance error 2015 binance error 1021 api binance errores api binance futures