Errores de Binance
Códigos de error de Binance en LootX: qué explica el terminal por sí mismo, rechazos frecuentes en spot y futuros, y cómo corregirlos.
Binance informa de un error con un código numérico negativo y un texto breve en inglés, por ejemplo {"code":-2010,"msg":"Account has insufficient balance for requested action."}. Además, el exchange responde con los estados HTTP 429 y 418 cuando hay demasiadas solicitudes. Aquí se recopilan los códigos que aparecen con más frecuencia al operar desde LootX y qué hacer con ellos.
Spot y futuros USDT-M de Binance son dos API distintas, con sus propios límites de solicitudes y sus propios permisos de clave. Por eso, una clave que opera en spot puede recibir un rechazo en futuros, y viceversa. El procedimiento general para analizar cualquier error está en la página Mensajes de error: cómo leerlos, y la configuración de claves en Conexión de exchanges y API keys.
Qué explica el terminal por sí mismo
LootX reconoce algunos rechazos por su código y muestra su propio mensaje o corrige la situación sin tu intervención:
| Situación | Códigos | Qué verás |
|---|---|---|
| El exchange rechazó la clave al conectar | -2014, -2015, -1022, cualquier rechazo de autorización 401/403 |
Etiqueta con el nombre de la conexión: «…: el exchange rechazó la API key o el secret; revísalos en la configuración de la conexión». En Configuración → Conexiones, la conexión muestra la sugerencia «El exchange rechazó la API key o el secret». El terminal reintenta aproximadamente cada 30 segundos |
| Firma incorrecta en la orden | -1022 |
«Orden rechazada: API key o secret incorrectos» |
| Demasiadas solicitudes | HTTP 429 | «⚠ … Rate limit (429), pausa ~N s — hasta HH:MM:SS UTC». El terminal respeta la pausa automáticamente |
| Dirección IP baneada | HTTP 418, -1003 |
«⚠ … Se superó la cantidad de solicitudes al exchange, la dirección IP está baneada hasta el 30.09.2026 19:37:54 UTC». Hasta ese momento, el terminal no envía solicitudes desde esa IP por ninguna conexión |
| Reloj desincronizado | -1021 |
Nada: el terminal sincroniza la hora con el exchange al conectar y una vez por minuto; ante un rechazo, recalcula el ajuste y repite la solicitud |
| La orden ya no existe | -2011, -2013 |
Nada: la cancelación se considera completada, la orden se ejecutó o se canceló antes |
| Faltaron monedas al vender en spot | -2010 |
El terminal repite la venta con un volumen reducido por el importe de la comisión. Si no funciona, muestra el texto del exchange |
| No hay nada que cerrar en spot | — | «Binance SOLUSDT: no hay nada que vender; el saldo de SOL = 0, la posición ya está cerrada». La orden no se envía al exchange: la billetera está vacía o el saldo es menor que el paso de volumen |
| El exchange suspendió el trading de la moneda por API | según las palabras de la respuesta | «El trading por API no está disponible para esta moneda: restricción del exchange» |
Todo lo demás, el terminal no lo traduce: en el mensaje emergente, después de «Order:» aparece la respuesta de Binance tal cual: código y texto. En las tablas siguientes se indica como «texto del exchange en el mensaje de la orden».
Códigos frecuentes
| Código | Cómo se ve | Causa | Qué hacer |
|---|---|---|---|
-2014 |
Etiqueta «el exchange rechazó la API key o el secret» | Clave con formato incorrecto: copiada de forma incompleta o con un carácter de más | Vuelve a copiar la clave en el campo API Key |
-2015 |
La misma etiqueta | La clave no existe, tu IP no está en la lista de la clave o la clave no tiene permiso para esa acción | Revisa la clave, la vinculación por IP y los permisos; consulta El exchange rechazó la clave |
-1022 |
Etiqueta o «Orden rechazada: API key o secret incorrectos» | El secret no corresponde a la clave | Vuelve a pegar el API Secret; si la clave se volvió a crear, actualiza ambos campos |
-1021 |
Normalmente nada | El reloj del ordenador se desincronizó de la hora del exchange | El terminal corrige la hora automáticamente. Si los rechazos se repiten, activa la sincronización de hora en Windows |
| HTTP 429 | «Rate limit (429), pausa ~N s…» | Se superó el límite de peso de solicitudes por minuto | Espera a que termine la pausa y cierra las ventanas innecesarias de este exchange |
HTTP 418, -1003 |
«Dirección IP baneada hasta …» | Las solicitudes continuaron tras la advertencia 429 y Binance bloqueó temporalmente la IP | Espera hasta la hora indicada; consulta Dirección IP baneada |
-2010 |
Texto del exchange en el mensaje de la orden: «Account has insufficient balance…» | Faltan fondos libres: una parte está bloqueada por órdenes o se dedujo por comisiones | Revisa el saldo libre y cancela las órdenes innecesarias |
-2019 |
Texto del exchange en el mensaje de la orden: «Margin is insufficient» | En futuros, falta margen para la orden con el apalancamiento actual | Reduce el volumen, deposita en la billetera de futuros o cancela las órdenes innecesarias |
-1013 |
Texto del exchange en el mensaje de la orden: «Filter failure: …» | La orden infringe las reglas del instrumento: paso de volumen (LOT_SIZE), importe mínimo (MIN_NOTIONAL) o paso de precio (PRICE_FILTER) | Aumenta el importe de la orden o corrige el precio. El nombre del filtro en el texto indicará qué está mal |
-4164 |
Texto del exchange en el mensaje de la orden: «Order’s notional must be no smaller than …» | El importe de la orden de futuros es menor que el mínimo del contrato | Aumenta el volumen. Una orden de cierre «solo reducción» no está sujeta a esta regla |
-2022 |
Texto del exchange en el mensaje de la orden: «ReduceOnly Order is rejected» | La orden «solo reducción» supera la posición o ya no hay posición | Actualiza la posición y reduce el volumen de cierre |
-2011 |
Nada | La orden que se intentaba cancelar ya no existe | No hay que hacer nada |
-2013 |
Nada | No se encontró la orden al comprobar el estado | No hay que hacer nada |
-1121 |
El libro de órdenes o el gráfico de la moneda no carga | El símbolo no existe: error de tipeo o la moneda se retiró de la negociación | Revisa el ticker y el mercado: spot o futuros |
Cómo corregir problemas frecuentes
El exchange rechazó la clave
La etiqueta «el exchange rechazó la API key o el secret» aparece ante cualquier rechazo de autorización al conectar. En Binance, detrás de ella puede haber no solo un error en la clave: el código -2015 también significa clave incorrecta, IP ajena o permisos insuficientes.
Comprueba que la clave siga activa
Abre la gestión de API en el perfil de Binance. Si la clave no está en la lista, fue eliminada: crea una nueva.
Vuelve a copiar la clave y el secret
Binance muestra el secret solo al crear la clave. Si no se guardó, crea una clave nueva. En Configuración → Conexiones, pega los valores en API Key y API Secret sin espacios en los extremos.
Revisa la vinculación por IP
Si la clave tiene habilitada una lista de IP permitidas, debe incluir la dirección externa de tu ordenador. Si trabajas a través de un proxy (sección Proxy en la tarjeta de la conexión), agrega la dirección del proxy, no la tuya.
Revisa los permisos
Para operar en spot, la clave debe tener habilitado el permiso de trading spot; para futuros, el de futuros. Habilita los permisos para los mercados marcados en la conexión con los interruptores Spot y Futures.
Después de corregirlo, el terminal se reconectará automáticamente en el siguiente intento.
La clave funciona en spot, pero no en futuros
Binance otorga el permiso de futuros por separado, y solo se puede habilitar después de abrir la cuenta de futuros en el sitio web del exchange. Abre la cuenta USDT-M y luego habilita los futuros para la clave en la gestión de API. No es necesario volver a crear la clave.
Dirección IP baneada
Binance responde primero con 429 y, si las solicitudes continúan, bloquea la dirección IP completa (HTTP 418). El exchange envía la hora de fin del baneo y el terminal la muestra en el mensaje.
- Hasta ese momento, LootX no envía solicitudes desde esa IP por ninguna conexión a Binance: cada solicitud adicional prolongaría el baneo.
- La hora del mensaje está en UTC. En ciudades con otro huso horario, súmale la diferencia correspondiente.
- Si los baneos se repiten, reduce la carga: menos ventanas y paneles de Binance en un mismo ordenador, y menos conexiones desde una misma IP.
Faltan monedas al vender todo el saldo en spot
Cuando la comisión de compra se deduce en la moneda comprada, la billetera queda con un poco menos de lo que compraste. El terminal compara el volumen de venta con el saldo real de la billetera y, si Binance responde -2010, repite la orden con un volumen reducido por el importe de la comisión.
Después de esa venta, puede quedar «polvo» en la billetera: un saldo menor que el paso mínimo de volumen. No se puede vender con una orden: es una restricción del exchange. Si el -2010 persiste tras los reintentos, realmente hay menos monedas en la billetera; revisa si están bloqueadas por otra orden.
Cuenta en modo de cobertura
LootX trabaja con posiciones de futuros en modo unidireccional: una posición por moneda. Si en la configuración de futuros de Binance está habilitado el modo de cobertura (dos posiciones: largo y corto), el exchange rechaza las órdenes del terminal con un mensaje sobre la discrepancia del lado de la posición (position side). Cambia el modo de posiciones a unidireccional en la configuración de futuros del sitio web de Binance. El exchange solo permite cambiar el modo cuando no hay posiciones ni órdenes abiertas.