Errores comunes de MetaTrader: códigos de MT4 y MT5, causas y soluciones en el servidor

Cómo informa MetaTrader de los errores

MetaTrader informa de los errores mediante códigos numerados con nombres fijos que MetaQuotes documenta, y el número indica en qué punto de la cadena falló la solicitud. MT4 y MT5 utilizan numeraciones diferentes, por lo que el mismo problema tiene dos códigos distintos según la plataforma.

En MetaTrader 5, cada solicitud de operación recibe una respuesta del servidor de operaciones. MetaQuotes describe el mecanismo así:

"All requests to execute trade operations are sent as a structure of a trade request MqlTradeRequest using function OrderSend(). The function execution result is placed to structure MqlTradeResult, whose retcode field contains the trade server return code."
(Traducción: «Todas las solicitudes para ejecutar operaciones de trading se envían como una estructura de solicitud de operación MqlTradeRequest mediante la función OrderSend(). El resultado de la ejecución de la función se coloca en la estructura MqlTradeResult, cuyo campo retcode contiene el código de retorno del servidor de operaciones».)— MQL5 Reference, Trade Server Return Codes, MetaQuotes (consultado en octubre de 2026)

Los códigos de retorno del servidor de operaciones de MT5 van desde 10004 (TRADE_RETCODE_REQUOTE) hasta 10046 (TRADE_RETCODE_HEDGE_PROHIBITED). En MetaTrader 4, ese mismo tipo de información procede de GetLastError(). Los códigos relacionados con el trading se sitúan en el rango bajo (0–150, por ejemplo 130 ERR_INVALID_STOPS). Los errores de ejecución de programas empiezan en 4000 (por ejemplo 4109 ERR_TRADE_NOT_ALLOWED).

Un código de éxito no equivale a una orden ejecutada. La referencia de MQL5 sobre OrderSend() advierte que «un resultado satisfactorio de la función OrderSend() no significa que la orden se haya ejecutado». Solo significa que la solicitud se aceptó para su procesamiento posterior. Cuando un cliente dice «me dio OK pero no pasó nada», revise el journal del servidor.

Hay tres lugares donde buscar el código real:

• Pestaña Journal (eventos de la plataforma: conexión, login, solicitudes de órdenes).
• Pestaña Experts (mensajes impresos por Expert Advisors y scripts, incluidos los resultados de GetLastError()).
• Archivos de log en disco. La ayuda de MT5 de MetaQuotes indica: «Los archivos de log de la plataforma se almacenan en el directorio Logs, y los archivos de log de los Expert Advisors se guardan en MQL5\Logs. Los nombres de archivo corresponden a la fecha de generación del journal — YYYYMMDD.LOG».

El visor de logs integrado permite filtrar las entradas por «Full, No connection, Errors only».

Errores de conexión: "No connection" e "Invalid account"

"No connection" significa que el terminal no puede alcanzar la dirección del servidor de operaciones que se le indicó, e "Invalid account" significa que alcanzó un servidor que rechazó el login. Cada uno requiere comprobaciones distintas, y el bróker puede ver cosas que el trader no ve.

Qué puede comprobar el trader

1. Confirmar en un navegador que la conexión a internet funciona.
2. Volver a introducir el login, la contraseña y el nombre exacto del servidor. La ayuda de MT5 señala que también se puede escribir la dirección manualmente como «[número de servidor]:[número de puerto], por ejemplo, 192.168.0.1:443».
3. Comprobar que la contraseña es la contraseña maestra. MetaQuotes explica que «la autorización de inversor permite ver el estado de la cuenta, analizar precios y trabajar con sus propios Expert Advisors, pero no operar».
4. Comprobar el proxy y el firewall. En MT5, la pestaña Server de Tools > Options contiene la «configuración de la conexión al servidor y de un servidor proxy».
5. Abrir el visor de logs, filtrar por "No connection" y enviar el archivo YYYYMMDD.LOG al bróker.

Qué debe comprobar el bróker en el lado del servidor

• Accesibilidad de cada punto de acceso. Pruebe cada dirección y puerto publicados en la lista de servidores desde fuera de su propia red, y desde más de una región.
• Cambios recientes de infraestructura. Nuevas IP, registros DNS, traslados de centro de datos o reglas de protección DDoS provocan a menudo oleadas de "No connection".
• Estado del servidor. CPU, memoria y disco en los servidores de operaciones y de acceso. La sobrecarga se manifiesta en forma de timeouts (128 ERR_TRADE_TIMEOUT, 10012 TRADE_RETCODE_TIMEOUT) antes de las desconexiones completas.
• Estado de la cuenta. ¿Está habilitada la cuenta? ¿Está en el grupo correcto? ¿Se trasladó durante una migración? ¿Se activó un cambio de contraseña obligatorio? La ayuda de MT5 confirma que «el cambio de contraseña obligatorio puede ser activado por el administrador del servidor de operaciones».
• Builds de cliente antiguas. 5 ERR_OLD_VERSION ("Old version of the client terminal") significa que el terminal debe actualizarse.

Para problemas más profundos de red y de host, consulte diagnóstico de servidores de forex y alojamiento de servidores MetaTrader.

Códigos de error de MT4 y sus equivalentes en MT5

Los errores de trading de MT4 utilizan números pequeños que MetaQuotes enumera en la MQL4 Reference, y la mayoría tiene un equivalente directo en MT5. Utilice la correspondencia siguiente cuando los clientes cambien de plataforma o cuando opere ambos servidores durante una migración de MT4 a MT5.

La correspondencia es nuestra guía práctica, no una tabla oficial de MetaQuotes. Las descripciones en sí se citan de la página Trade Server Return Codes de MQL4.

Trade context busy (146) es específico de MT4. La función de MQL4 IsTradeContextBusy() «devuelve true si un hilo de trading está ocupado por otro Expert Advisor». Es un problema del lado del cliente. Varios EA en un mismo terminal compiten por el hilo de trading, y la solución es una lógica de reintentos o menos EA por terminal. El bróker no puede resolverlo en el servidor.

Errores de autotrading y de permisos

Los errores de autotrading se distinguen claramente por su nombre: 10026 indica que lo desactivó el servidor, y 10027, que lo desactivó el terminal del cliente. En MT4, el equivalente del lado del cliente es el error de ejecución 4109.

Los plugins también pueden bloquear o reescribir solicitudes. Un plugin de riesgo o de enrutamiento que rechaza órdenes aparece ante el cliente como un rechazo genérico (10006) o un error común (2). Si los rechazos empezaron tras actualizar un plugin, revise primero ese plugin. Desarrollamos y mantenemos estos plugins como parte del desarrollo de plugins para MetaTrader.

De apagar fuegos a monitorizar

La mayoría de los errores recurrentes de MetaTrader pueden detectarse en los logs del servidor antes de que los clientes se quejen. Se consigue vigilando las tasas de error en lugar de tickets individuales. Un aumento de 10021 en un símbolo, timeouts durante una sesión o rechazos tras un reinicio del bridge son visibles en los logs minutos después de empezar.

FXSUPPORT ofrece soporte de plataforma MT4/MT5 para brókers y empresas de fondeo (prop firms): instalación, actualizaciones, copias de seguridad, configuración, monitorización de logs y configuración del bridge. También cubrimos la infraestructura de servidores en el Reino Unido y los Países Bajos, con monitorización y un objetivo de disponibilidad del 99,9 %. En la práctica, esto significa que:

• vigilamos los logs de la plataforma y del bridge en busca de patrones de error, no solo de caídas;
• revisamos la configuración de símbolos, sesiones y grupos tras cada cambio y antes de los cambios de horario de verano;
• comprobamos el comportamiento de los plugins tras las actualizaciones de la plataforma;
• reforzamos los servidores frente a ataques DDoS y mantenemos las copias de seguridad restaurables.

Si dirige un bróker y su equipo de soporte pasa los días respondiendo a los mismos tickets de error, es señal de que la causa está en el servidor. Consulte soporte MT5 y soporte MT4 para ver qué cubrimos, o contáctenos para obtener una revisión técnica gratuita.