Errores de Binance

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.

Mensajes de error

Dónde muestra el terminal los errores y cómo leerlos.

Conexión de exchanges

Cómo crear una clave y agregar una conexión en LootX.

Errores de Bybit

Códigos de Bybit: claves, saldo, límites.