Errores de Gate
Etiquetas de error de Gate en LootX: INVALID_KEY, INVALID_SIGNATURE, BALANCE_NOT_ENOUGH, REQUEST_EXPIRED y el límite de órdenes por par.
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.