Errores de Gate

Gate reporta un error no con un número, sino con una etiqueta de texto: {"label":"BALANCE_NOT_ENOUGH","message":"…"}. La etiqueta es lo principal: con ella queda claro qué ocurrió, y message añade detalles. Si el terminal no reconoce la etiqueta, en el mensaje emergente después de «Order:» aparece la respuesta del exchange tal cual — por ejemplo, Gate POST …: HTTP 400 {"label":"BALANCE_NOT_ENOUGH",…}.

Spot y futuros USDT en Gate son secciones distintas de la API con sus propios permisos de key. Los límites de solicitudes en spot se cuentan por separado para cada par, por lo que el trading activo de una sola moneda choca con el límite antes que el flujo total de solicitudes. El procedimiento general para analizar errores está en la página Mensajes de error: cómo leerlos, y la configuración de keys, en Conexiones de exchanges y API keys.

Qué explica el terminal por sí mismo

Situación	Etiqueta	Qué verás
El exchange rechazó la key	`INVALID_KEY` — en la respuesta a la solicitud o a la suscripción del stream privado	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 Ajustes → Conexiones, la conexión muestra la sugerencia «El exchange rechazó la API key o el secret». El terminal reintenta aproximadamente cada 30 segundos
La firma no fue confirmada	`INVALID_SIGNATURE`	Al conectar — la misma etiqueta; en la orden — «Orden rechazada: API key o secret incorrectos»
La firma no coincidió solo para una moneda con nombre no latino	`INVALID_SIGNATURE`	Nada: el terminal repite la solicitud con otra forma de firma y luego firma correctamente para esa moneda
Demasiadas solicitudes	HTTP 429 y 418	«⚠ … rate limit (429), pausa ~3 s — hasta las 12:00:03 UTC». El terminal espera una pausa de hasta tres segundos y envía la solicitud después. Los rechazos consecutivos alargan la pausa: 8, 25 y luego 60 segundos
Relojes desincronizados	`REQUEST_EXPIRED`	El rechazo no se considera error de key, la conexión no se corta. El terminal sincroniza la hora con el exchange al conectar y una vez por minuto
La orden ya no existe	`ORDER_NOT_FOUND`	Nada: la cancelación se considera completada
No hay posición	`POSITION_NOT_FOUND`	Nada: el terminal considera la posición del contrato como cero
El volumen o monto de la orden spot es menor al mínimo	—	«Gate …: el volumen … es menor al mínimo …» o «Gate …: el monto de la orden … es menor al mínimo del exchange …». El terminal lo verifica antes de enviar; la orden no se envía al exchange
No alcanzaron las monedas al cerrar una posición spot	`BALANCE_NOT_ENOUGH`	El terminal repite la venta con un volumen reducido por el tamaño de la comisión. Si no funcionó, muestra el texto del exchange
Nada que cerrar en spot	—	«Gate …: no hay SOL en la wallet — la posición ya está cerrada». La orden no se envía al exchange
Modo de posiciones en futuros	—	El terminal detecta el modo de la cuenta — unidireccional o bidireccional — y construye la orden en consecuencia
El exchange suspendió el trading de la moneda por API	según las palabras en la respuesta	«El trading por API no está disponible para esta moneda — restricción del exchange»

Las solicitudes de referencia — historial de operaciones y movimientos de fondos — no cortan la conexión si falla la autorización: el trading sigue funcionando aunque esa solicitud no se complete.

Códigos frecuentes

Etiqueta	Cómo se ve	Causa	Qué hacer
`INVALID_KEY`	Etiqueta «el exchange rechazó la API key o el secret»	La key es incorrecta o fue eliminada	Verifica la key en el sitio de Gate y pégala de nuevo en API Key — ver El exchange rechazó la key
`INVALID_SIGNATURE`	Etiqueta o «Orden rechazada: API key o secret incorrectos»	El secret no corresponde a la key	Pega de nuevo el API Secret
`REQUEST_EXPIRED`	Texto del exchange en el mensaje de la orden	El reloj de la computadora se desincronizó del exchange, normalmente tras salir de la suspensión	Reintenta la orden en un minuto. Si se repite, activa la sincronización de hora en Windows
`BALANCE_NOT_ENOUGH`	Texto del exchange en el mensaje de la orden	No hay fondos libres suficientes: una parte está bloqueada por órdenes o se fue en comisiones	Ver No hay fondos suficientes
HTTP 429, «Request Rate Limit Exceeded»	«rate limit (429), pausa ~N s…»	Se superó el límite de solicitudes	Espera a que termine la pausa
«Request Rate Limit Exceeded (007), currency_pair:…»	Lo mismo	Más de 10 órdenes por segundo en un mismo par spot	Ver Límite de órdenes por par
`ORDER_NOT_FOUND`	Nada	La orden que se iba a cancelar ya no existe: fue ejecutada o cancelada	No hay que hacer nada
`POSITION_NOT_FOUND`	Nada	No hay posición abierta en el contrato	No hay que hacer nada

Cómo corregir problemas frecuentes

El exchange rechazó la key

Verifica que la key exista

Abre la gestión de keys APIv4 en el perfil de Gate. Si la key no está en la lista, fue eliminada: crea una nueva.

Copia la key y el secret de nuevo

Gate muestra el secret solo al crear la key: si no lo guardaste, crea una key nueva. En Ajustes → Conexiones, pega los valores en API Key y API Secret sin espacios en los extremos.

Verifica los permisos de la key

La key debe tener habilitado el trading en los mercados marcados en la conexión con los interruptores Spot y Futuros: trading spot para spot, futuros perpetuos para futuros. Los permisos de lectura de datos de la cuenta no son obligatorios para operar.

Verifica el vínculo con IP

Si la key está vinculada a una lista de IP, debe incluir la dirección externa de tu computadora. Si trabajas a través de un proxy (sección Proxy en la tarjeta de conexión), agrega la dirección del proxy.

Después de corregirlo, el terminal se reconectará solo en el siguiente intento.

Límite de órdenes por par

En spot, Gate limita la colocación de órdenes por separado para cada par: no más de 10 solicitudes por segundo por moneda, y los límites de pares distintos son independientes. La respuesta «Request Rate Limit Exceeded (007), currency_pair:…» es exactamente esta restricción por segundo para una sola moneda, no un bloqueo de cuenta.

El terminal espera una pausa corta por sí mismo: la orden se enviará en un par de segundos y el trading de otras monedas no se detiene.
Si los rechazos son consecutivos, la pausa crece hasta un minuto. La hora de fin se ve en el mensaje, en UTC.

No hay fondos suficientes

Los fondos bajo órdenes abiertas están bloqueados: cancela las órdenes sobrantes o reduce el volumen. En futuros, para una orden se requiere margen considerando el apalancamiento.

Al cerrar una posición spot con una venta, la insuficiencia suele deberse a la comisión: al comprar, puede descontarse en la moneda comprada, y ya no es posible vender todo el volumen adquirido. El terminal compara el volumen con la wallet y, si hay rechazo, repite la venta con un volumen ligeramente menor. Después puede quedar en la wallet «polvo» menor al paso de volumen: no se puede vender con una orden.

Relojes desincronizados

La etiqueta REQUEST_EXPIRED significa que la hora de la solicitud está demasiado lejos de la hora del exchange. Suele ocurrir tras salir de la suspensión de la computadora. El terminal sincroniza el reloj con Gate una vez por minuto, así que el rechazo pasa solo. Si se repite constantemente, activa en Windows la configuración automática de la hora y sincroniza el reloj manualmente una vez en los parámetros de fecha y hora.

Mensajes de error

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

Conexiones de exchanges

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

Errores de Binance

Códigos de Binance: keys, baneos de IP, filtros de órdenes.