Erros comuns do MetaTrader: códigos do MT4 e do MT5, causas e correções no servidor

Como o MetaTrader informa erros

O MetaTrader informa erros como códigos numerados com nomes fixos documentados pela MetaQuotes, e o número indica em que ponto da cadeia a solicitação falhou. O MT4 e o MT5 usam numerações diferentes, portanto o mesmo problema tem dois códigos distintos conforme a plataforma.

No MetaTrader 5, toda solicitação de negociação recebe uma resposta do servidor de negociação. A MetaQuotes descreve o mecanismo assim:

"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."
(Tradução: "Todas as solicitações de execução de operações de negociação são enviadas como uma estrutura de solicitação de negociação MqlTradeRequest por meio da função OrderSend(). O resultado da execução da função é colocado na estrutura MqlTradeResult, cujo campo retcode contém o código de retorno do servidor de negociação.")— MQL5 Reference, Trade Server Return Codes, MetaQuotes (acessado em outubro de 2026)

Os códigos de retorno do servidor de negociação do MT5 vão de 10004 (TRADE_RETCODE_REQUOTE) a 10046 (TRADE_RETCODE_HEDGE_PROHIBITED). No MetaTrader 4, o mesmo tipo de informação vem de GetLastError(). Os códigos relacionados à negociação ficam na faixa baixa (0–150, por exemplo 130 ERR_INVALID_STOPS). Os erros de execução de programas começam em 4000 (por exemplo 4109 ERR_TRADE_NOT_ALLOWED).

Um código de sucesso não é o mesmo que uma ordem executada. A referência MQL5 de OrderSend() alerta que "um resultado bem-sucedido da função OrderSend() não significa que a ordem foi executada". Significa apenas que a solicitação foi aceita para processamento posterior. Quando um cliente diz "apareceu OK, mas nada aconteceu", verifique o journal do servidor.

Há três lugares onde procurar o código real:

• Aba Journal (eventos da plataforma: conexão, login, solicitações de ordens).
• Aba Experts (mensagens impressas por Expert Advisors e scripts, incluindo os resultados de GetLastError()).
• Arquivos de log em disco. A ajuda do MT5 da MetaQuotes afirma: "Os arquivos de log da plataforma são armazenados no diretório Logs, e os arquivos de log dos Experts são salvos em MQL5\Logs. Os nomes dos arquivos correspondem à data de geração do journal — YYYYMMDD.LOG."

O visualizador de logs integrado pode filtrar as entradas por "Full, No connection, Errors only".

Erros de conexão: "No connection" e "Invalid account"

"No connection" significa que o terminal não consegue alcançar o endereço do servidor de negociação que lhe foi informado, e "Invalid account" significa que ele alcançou um servidor que rejeitou o login. Cada um exige verificações diferentes, e a corretora consegue ver coisas que o trader não vê.

O que o trader pode verificar

1. Confirme que a conexão com a internet funciona em um navegador.
2. Digite novamente o login, a senha e o nome exato do servidor. A ajuda do MT5 observa que também é possível digitar o endereço manualmente como "[número do servidor]:[número da porta], por exemplo, 192.168.0.1:443".
3. Verifique se a senha é a senha master. A MetaQuotes explica que "a autorização de investidor permite ver o status da conta, analisar preços e trabalhar com seus próprios Expert Advisors, mas não negociar".
4. Verifique o proxy e o firewall. No MT5, a aba Server em Tools > Options contém a "configuração da conexão com o servidor, configuração de um servidor proxy".
5. Abra o visualizador de logs, filtre por "No connection" e envie o arquivo YYYYMMDD.LOG para a corretora.

O que a corretora deve verificar no lado do servidor

• Acessibilidade de cada ponto de acesso. Teste cada endereço e porta publicados na lista de servidores a partir de fora da sua própria rede, e teste a partir de mais de uma região.
• Alterações recentes de infraestrutura. Novos IPs, registros DNS, mudanças de data center ou regras de proteção contra DDoS costumam causar ondas de "No connection".
• Saúde do servidor. CPU, memória e disco nos servidores de negociação e de acesso. A sobrecarga aparece como timeouts (128 ERR_TRADE_TIMEOUT, 10012 TRADE_RETCODE_TIMEOUT) antes de desconexões completas.
• Estado da conta. A conta está ativada? Está no grupo correto? Foi transferida durante uma migração? A troca obrigatória de senha foi ativada? A ajuda do MT5 confirma que "a troca obrigatória de senha pode ser ativada pelo administrador do servidor de negociação".
• Builds antigos do cliente. 5 ERR_OLD_VERSION ("Old version of the client terminal") significa que o terminal precisa ser atualizado.

Para problemas mais profundos de rede e de host, veja diagnóstico de servidores forex e hospedagem de servidores MetaTrader.

Códigos de erro do MT4 e seus equivalentes no MT5

Os erros de negociação do MT4 usam números pequenos que a MetaQuotes lista na MQL4 Reference, e a maioria tem uma contrapartida direta no MT5. Use o mapeamento abaixo quando os clientes passarem de uma plataforma para outra ou quando você operar os dois servidores durante uma migração de MT4 para MT5.

O mapeamento é o nosso guia prático, não uma tabela oficial da MetaQuotes. As descrições em si são citadas da página MQL4 Trade Server Return Codes.

Trade context busy (146) é específico do MT4. A função MQL4 IsTradeContextBusy() "retorna true se uma thread de negociação estiver ocupada por outro Expert Advisor". É um problema do lado do cliente. Vários EAs em um mesmo terminal disputam a thread de negociação, e a correção é uma lógica de nova tentativa ou menos EAs por terminal. A corretora não pode corrigi-lo no servidor.

Erros de autotrading e de permissão

Os erros de autotrading se distinguem claramente pelo nome: o 10026 diz que o servidor o desativou, e o 10027 diz que foi o terminal do cliente. No MT4, o equivalente do lado do cliente é o erro de execução 4109.

Plugins também podem bloquear ou reescrever solicitações. Um plugin de risco ou de roteamento que rejeita ordens aparece para o cliente como uma rejeição genérica (10006) ou um erro comum (2). Se as rejeições começaram após a atualização de um plugin, verifique esse plugin primeiro. Desenvolvemos e mantemos esses plugins como parte do desenvolvimento de plugins MetaTrader.

Do combate a incêndios ao monitoramento

A maioria dos erros recorrentes do MetaTrader pode ser detectada nos logs do servidor antes que os clientes reclamem. Chega-se a isso acompanhando taxas de erro em vez de chamados individuais. Um aumento de 10021 em um símbolo, timeouts durante uma sessão ou rejeições após um reinício do bridge ficam visíveis nos logs minutos depois de começarem.

A FXSUPPORT oferece suporte às plataformas MT4/MT5 para corretoras e prop firms: instalação, atualizações, backups, configuração, monitoramento de logs e configuração de bridges. Também cuidamos da infraestrutura de servidores no Reino Unido e na Holanda, com monitoramento e meta de 99,9% de disponibilidade. Na prática, isso significa que:

• acompanhamos os logs da plataforma e do bridge em busca de padrões de erro, e não apenas de interrupções;
• revisamos as configurações de símbolos, sessões e grupos após cada alteração e antes das mudanças de horário de verão;
• verificamos o comportamento dos plugins após atualizações da plataforma;
• reforçamos os servidores contra DDoS e mantemos os backups restauráveis.

Se você administra uma corretora e sua equipe de suporte passa os dias respondendo aos mesmos chamados de erro, isso é sinal de que a causa está no servidor. Veja suporte MT5 e suporte MT4 para saber o que cobrimos, ou entre em contato para uma revisão técnica gratuita.