Mensajes de error: cómo leerlos
1Mensajes de error: cómo leerlos
Dónde muestra el terminal los errores, en qué se diferencia su explicación de la respuesta del exchange, cómo encontrar el código del exchange en el texto y armar un reporte para soporte.
Cuando algo sale mal —el exchange rechazó una orden, se cortó la conexión, una clave no pasó—, el terminal lo informa en varios lugares. Aquí se describe dónde buscar el mensaje, cómo distinguir la explicación del terminal de la respuesta del exchange, cómo encontrar en el texto el código del exchange y qué enviar a soporte si no lograste resolverlo por tu cuenta.
Los códigos y textos de exchanges específicos están reunidos en páginas separadas — enlaces al final.
Dónde aparecen los mensajes
- Etiquetas — aparecen en la esquina superior derecha de la ventana y desaparecen a los 8 segundos. Roja: rechazo o corte; verde: éxito; azul: información. Si el evento se refiere a un exchange, en la línea aparece su logo. Los mensajes iguales no se multiplican, sino que se agrupan en una sola etiqueta con un contador de repeticiones.
- Cinta «Alertas» — botón Alertas en el panel superior de la ventana. Allí se registra cada etiqueta, así podés releer un mensaje que pasó rápido. El punto azul en el botón indica que hay mensajes sin leer. Los mensajes del terminal están en la fuente Sistema.
- Línea de conexión en Configuración → Conexiones. El color del punto muestra el estado de la conexión; la sugerencia al pasar el cursor muestra la causa: «El exchange rechazó la API key o el secret», «Desconectado» o la última respuesta del exchange mientras se restablece la conexión.
- Ícono «solo lectura» (ojo) en el libro de órdenes — no se puede operar desde ese panel en este momento. Pasá el cursor sobre él: la sugerencia indicará la causa.
- Órdenes semitransparentes en el libro de órdenes — el terminal temporalmente no puede confirmarlas en el exchange: se cortó la conexión o el exchange limitó las solicitudes. Cuando la conexión vuelva, las órdenes se volverán a verificar.
- Banner rojo en la parte superior de la ventana — Windows no dejó iniciar parte del terminal (Smart App Control o antivirus). No desaparece por sí solo. Mientras esté visible, según el texto no se actualizan los datos de mercado o no se envían órdenes.
- Ventanas de inicio de sesión y de actualización muestran sus propios errores directamente en la ventana.
- Logs — registro completo del funcionamiento del terminal, incluido lo que no se muestra en etiquetas. Cómo obtenerlos — abajo.
Dos tipos de mensajes
El terminal reconoció el error y lo explica por sí mismo
Varias situaciones frecuentes el terminal las reconoce en la respuesta de cualquier exchange y muestra, en lugar del texto crudo, uno propio — en el idioma de la interfaz y con una sugerencia sobre qué hacer.
| Situación | Qué ves |
|---|---|
| El exchange no aceptó la API key, el secret o la passphrase | Etiqueta «…: el exchange rechazó la API key o el secret — revisalos en la configuración de la conexión», punto rojo en la conexión |
| Rechazo por firma en una orden concreta | «Orden rechazada: API key o secret incorrectos» |
| Se superó el límite de solicitudes o la IP está bloqueada | Etiqueta con la hora de finalización de la restricción en UTC |
| El exchange temporalmente no acepta órdenes por API para esta moneda | «El trading por API no está disponible para esta moneda — restricción del exchange» |
| No hay conexión, está apagada o la plataforma no tiene trading | «⚠ El exchange no está conectado», «⚠ Conexión apagada», «⚠ Esta plataforma no tiene trading» |
| La orden ya se ejecutó o fue cancelada al momento de la cancelación | Nada: el terminal consulta por sí mismo al exchange el estado final de la orden |
| El reloj de la computadora se desincronizó con el reloj del exchange | Nada: el terminal sincroniza el reloj con el exchange y repite la solicitud |
Cada uno de estos mensajes está analizado en la página Mensajes del terminal.
El terminal transmite la respuesta del exchange tal cual
Todo lo demás —margen insuficiente, volumen mínimo, paso de precio, permisos de la clave, whitelist de IP— el terminal no lo traduce. Muestra el texto del exchange completo, normalmente en inglés. Antes aparece un prefijo corto que indica qué acción no se completó.
| Prefijo | Dónde | Qué no se completó |
|---|---|---|
Order: … |
etiqueta | Colocación de la orden. El prefijo permanece en inglés también en la interfaz en español |
Orden: … |
log | La misma colocación rechazada — registro en el log |
Cancelación rechazada: … |
etiqueta o log | Cancelación de la orden — quedó en el exchange |
No se pudo mover la orden: … |
etiqueta | Mover la orden a otro precio |
Apalancamiento … ×… no modificado: … |
etiqueta | Cambio de apalancamiento |
Trading: desactivado (…) |
log | Corte de la conexión de trading. Entre paréntesis, el nombre de la conexión y la causa |
El texto después de los dos puntos es la respuesta del exchange. Buscá en él el código (ver la siguiente sección) y abrí la página de tu exchange.
Cómo encontrar el código del exchange en el texto
Cada exchange tiene su propio formato de respuesta. Por ejemplo, Binance responde así:
Order: {"code":-2019,"msg":"Margin is insufficient."}Aquí el código es -2019, y msg es la explicación del exchange. En otros exchanges el código se ve distinto:
| Exchange | Cómo se ve el código |
|---|---|
| Binance, Aster | Número negativo después de "code":, por ejemplo -2019 |
| Bybit | Número después de retCode |
| OKX | Número de cinco dígitos, por ejemplo 51008 |
| Bitget | Número entre comillas: "code":"40009" |
| Gate | No es un número, sino una palabra en mayúsculas: INVALID_KEY, BALANCE_NOT_ENOUGH |
| MEXC | Número después de code= |
| KuCoin | Número después de KuCoin POST /orders, por ejemplo 200004 |
| BingX | Número después de la palabra error: BingX … error 100437: … |
| Hyperliquid | No hay códigos — solo texto, por ejemplo Order must have minimum value of $10. |
Si no hay código en el texto, buscá por palabras clave: insufficient — fondos insuficientes, timestamp o recvWindow — reloj, signature — firma, permission — permisos de la clave.
Logs y reporte para soporte
Si el mensaje no se entiende o se repite, armá un reporte — es un solo archivo con todos los logs necesarios.
Armar el reporte
Presioná Ayuda (botón con signo de pregunta en el panel superior) → Reporte del programa. El terminal empaquetará los logs de hoy y ayer en un archivo lootx-report-<fecha>-<hora>.zip de hasta 50 MB.
Encontrá el archivo
El archivo se guarda en el escritorio, la ruta ya está copiada al portapapeles y el explorador se abrirá con el archivo seleccionado.
Envialo a soporte
Adjuntá el archivo y escribí: cuándo ocurrió (hora y zona horaria), qué exchange y qué conexión, qué estabas haciendo y qué texto apareció en la etiqueta — podés encontrarlo en la cinta «Alertas».
El archivo de configuración con las API keys y el historial de operaciones no se incluyen en el reporte. Si hay poco espacio en disco, el terminal lo dirá: «Poco espacio en disco para el reporte: se necesitan … MB, hay … MB libres».
La carpeta con los logs se puede abrir también manualmente: Ayuda → Logs. En Windows es %AppData%\TradingTerminal\Logs, en macOS — ~/Library/Application Support/TradingTerminal/Logs. Los logs se guardan una semana, los antiguos se eliminan solos.
Si no cargan los clústeres o el screener — es decir, no responden los servidores de LootX, no el exchange — abrí Configuración → Nube → Diagnóstico de conexión y presioná Verificar conexión. La verificación mostrará en qué paso se corta la conexión, y Copiar reporte dará un texto para soporte.
Códigos de error por exchange
Todo lo que el terminal explica por sí mismo: conexión, claves, límites, proxy, actualización, inicio de sesión.
BinanceCódigos como -2019 y -1013, bloqueo de IP hasta una hora determinada.
BybitCódigos retCode: clave, permisos, balance, límites.
OKXCódigos de cinco dígitos, passphrase, whitelist de IP.
BitgetFirma, modo de cuenta unificada, permisos y lista de IP de la clave.
GateEtiquetas de texto en lugar de códigos, límite por una moneda.
MEXCFuturos sin KYC y permisos, balance, límites.
KuCoinTres campos de la clave, passphrase, balance.
BingXClave y firma, trading API por moneda desactivado.
HyperliquidClave de wallet y agent, volumen mínimo, límite de la dirección.
AsterWallet y Account Id, hora del dispositivo, bloqueo de IP.
Más
https://docs.lootx.trade/es/terminal/errors