LootX

Mensajes de error: cómo leerlos

nuevo Actualizado 30 de septiembre de 2026 Esta página en PDF

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í:

TEXT
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

Más

FAQ

¿Por qué el error de la orden llegó en inglés?
El terminal solo traduce los rechazos que reconoce: clave, firma, límite de solicitudes, trading no disponible por API. El resto es el texto del exchange tal cual, después del prefijo «Order:». Busca el código en ese texto y abre la página de tu exchange.
¿Dónde encuentro un mensaje que apareció y desapareció?
En la cinta «Alertas» — el botón está en el panel superior de la ventana. Ahí se registra cada etiqueta; los mensajes del terminal están en la fuente «Sistema».
¿Cómo envío los registros a soporte?
Ayuda → Informe del programa. Un archivo con los registros de hoy y de ayer aparecerá en el espacio de trabajo, y la ruta ya estará en el portapapeles. El archivo de configuración con las claves de API no se incluye en el paquete.