Códigos de erro MT5: 10027, 10030, 10016 e mais

Códigos de erro do MT5 / MQL5: retcodes 10004–10031 e erros de execução

O MT5 informa dois tipos de erro: os retcodes de negociação de 5 dígitos (por exemplo, 10027 AutoTrading desativado, 10030 modo de preenchimento não suportado, 10016 stops inválidos, 10019 saldo insuficiente) e os erros de execução de 4 dígitos do GetLastError() (por exemplo, 4401, 4756) — a tabela abaixo relaciona cada um à sua correção.

Consulta rápida: código → significado → correção

Os números e os nomes das constantes seguem a referência oficial do MQL5 (códigos de retorno do servidor de negociação e erros de execução).

Retcodes de negociação (MqlTradeResult.retcode)

Erros de execução (GetLastError())

Como acessar a aba Expert

Clique na aba Expert na parte inferior do MT5 para ver um log cronológico de toda a atividade dos EAs.

Formato do log:
2026.05.18 10:00:01.234  GOLD VIPER XAUUSD,M30: [ERROR] 10016

Data/Hora   Nome do EA       Símbolo   Timeframe  Mensagem

Quando um erro aparecer, use o número do código para encontrar a causa na tabela acima.

Códigos de erro mais comuns e como resolvê-los

10019 — Saldo insuficiente (TRADE_RETCODE_NO_MONEY)

Equivalente no MT4: 134 ERR_NOT_ENOUGH_MONEY. ERR_NO_MONEY é uma abreviação muito usada para a mesma situação.

Exemplos de mensagem: "Order failed: not enough money"
                      "No money"

Causa: Margem insuficiente — o EA não consegue abrir uma nova posição.

Como resolver:

1. Verifique o nível de margem atual na aba Trade do MT5
2. Se a margem estiver próxima ou abaixo de 100%, considere fazer um depósito adicional
3. Reduza a configuração RiskPercent do EA para diminuir o tamanho da posição
4. Feche manualmente algumas posições abertas para liberar margem

10027 — AutoTrading desabilitado pelo cliente (TRADE_RETCODE_CLIENT_DISABLES_AT)

Erro de execução do MT5 relacionado: 4752 ERR_TRADE_DISABLED. Equivalente no MT4: 4109 ERR_TRADE_NOT_ALLOWED.

Exemplos de mensagem: "AutoTrading disabled by client"
                      "Trade is not allowed"

Causa: A negociação automática está desativada no MT5.

Como resolver:

1. Clique no botão Algo Trading na barra de ferramentas do MT5 para ativá-lo (ele deve ficar verde)
2. Vá em Ferramentas → Opções → Expert Advisors → ative Permitir Algo Trading e reinicie o MT5

Este erro ocorre com frequência quando o MT5 inicia automaticamente após uma reinicialização do VPS.

10018 — Mercado fechado (TRADE_RETCODE_MARKET_CLOSED)

Equivalente no MT4: 132 ERR_MARKET_CLOSED.

Exemplo de mensagem: "Market closed"

Causa: O EA tentou abrir uma operação fora do horário de mercado (fim de semana ou feriado).

Como resolver: Nenhuma ação é necessária. O mercado fica fechado durante o fim de semana, e qualquer tentativa de entrada nesse intervalo gera este erro; o EA retoma automaticamente quando o mercado reabre.

10016 — Stops inválidos (TRADE_RETCODE_INVALID_STOPS)

Equivalente no MT4: 130 ERR_INVALID_STOPS.

Exemplo de mensagem: "Invalid stops"

Causa: O valor do SL (stop loss) ou do TP (take profit) viola a exigência de stop level mínimo do broker.

Como resolver:

1. Verifique o stop level do broker (distância mínima do SL): clique com o botão direito no símbolo no MT5 → Especificação → procure o campo Stops level
2. Confirme que a distância do SL do EA é maior que o stop level
3. Este erro é mais comum em períodos de baixa volatilidade, quando os valores de ATR são muito pequenos

10021 — Sem cotações (TRADE_RETCODE_PRICE_OFF)

Equivalente no MT4: 136 ERR_OFF_QUOTES.

Exemplo de mensagem: "Off quotes"

Causa: Nenhuma cotação recebida do servidor do broker — um problema de conectividade.

Como resolver:

1. Verifique o status da conexão na barra de status do MT5, na parte inferior da tela
2. Se estiver desconectado, reinicie o MT5
3. Consulte a página de status dos servidores do seu broker para verificar se há instabilidade
4. Verifique a conexão de rede do seu VPS

10012 — Tempo limite da solicitação esgotado (TRADE_RETCODE_TIMEOUT)

Equivalente no MT4: 128 ERR_TRADE_TIMEOUT.

Exemplo de mensagem: "Request canceled by timeout"

Causa: A ordem expirou por congestionamento do servidor ou latência de rede.

Como resolver:

1. É mais comum logo após notícias importantes, quando a carga do servidor está alta
2. Em geral, o EA tenta novamente no próximo tick — nenhuma ação é necessária
3. Se acontecer com frequência, revise o ambiente de rede do seu VPS ou considere outro broker

10006 — Solicitação rejeitada (TRADE_RETCODE_REJECT)

Exemplo de mensagem: "Request rejected"

Causa: O broker rejeitou a ordem — normalmente porque o spread ultrapassou os limites ou o preço se moveu rápido demais.

Como resolver:

1. Revise a configuração MaxSpreadPoints; este erro é comum quando os spreads se ampliam de forma significativa
2. Durante as notícias e logo depois delas, esse é o comportamento esperado — você pode ignorá-lo
3. Se ocorrer com frequência, aumente ligeiramente o valor de MaxSpreadPoints

"Margin level too low"

Exemplo de mensagem: "Margin level too low. Skip signal."

Causa: A configuração UseMarginCheck = true do EA detectou que o nível de margem caiu abaixo de MinMarginLevel (por exemplo, 200%), então as novas entradas são bloqueadas automaticamente.

Como resolver:

1. Este é um comportamento de proteção normal — não é um erro
2. As entradas serão retomadas automaticamente quando o nível de margem se recuperar
3. Solução definitiva: deposite mais fundos ou reduza o RiskPercent

"No signal on this bar" ou "Wait for next bar"

Não são erros — são registros de depuração do log.

"No signal. ATR=1245, EMA(50)=1998.23"

O EA avalia o gráfico a cada candle e registra quando as condições de entrada não são atendidas. É o funcionamento normal.

Classificação dos erros por prioridade

Como ler a aba Expert com eficiência

Filtrar o log

Clique com o botão direito dentro da aba Expert e selecione Filter para exibir apenas os logs de um EA ou de um tipo de erro específico.

Localização dos arquivos de log

Os arquivos de log do MT5 são salvos aqui:

C:\Users\[NomeDeUsuário]\AppData\Roaming\MetaQuotes\Terminal\[ID]\MQL5\Logs\

Os arquivos são criados automaticamente por data. Abra esta pasta ao investigar erros.

Resumo

A maioria dos erros de EA se enquadra em quatro categorias:

1. Margem insuficiente (10019) — Deposite mais fundos ou reduza o tamanho do lote
2. AutoTrading desligado (10027 / 4752) — Clique no botão Algo Trading para ativá-lo
3. Problemas de conexão (10021 / 10031) — Reinicie o MT5 ou verifique a rede do VPS
4. Comportamento normal — Nenhuma ação necessária (mercado fechado no fim de semana, espera para evitar spread amplo, etc.)

Crie o hábito de verificar a aba Expert diariamente para identificar rapidamente os erros críticos (10019 e 10027) antes que causem problemas.

Perguntas Frequentes

P: Onde posso consultar os códigos de erro?

A referência oficial do MQL5 lista todos os códigos: códigos de retorno do servidor de negociação para a faixa 10004–10046 e erros de execução para a faixa 4xxx. Você também pode pesquisar na ajuda integrada do MT5 (pressione F1).

P: Qual é a diferença entre um retcode e GetLastError()?

Um retcode (10004–10046) é a resposta do servidor de negociação a uma ordem e fica armazenado em MqlTradeResult.retcode. GetLastError() retorna um erro de execução do próprio programa MQL5 (4xxx e 5xxx). Quando OrderSend() falha, você geralmente recebe os dois: 4756 do GetLastError() mais um retcode que informa o motivo real.

P: Devo parar o EA se os erros aparecerem com frequência?

Se 10018 (mercado fechado) ou 10012 (tempo limite) aparecerem ocasionalmente, não é necessário parar o EA. No entanto, se 10019 (saldo insuficiente) se repetir, pause o EA, revise a situação da margem e reinicie-o depois de resolver.

P: Está aparecendo o erro “Invalid account”.

Suas credenciais de login do MT5 (nome do servidor, ID de login ou senha) podem estar incorretas. Vá em Arquivo → Abrir uma Conta para fazer login novamente.

P: Nenhum erro aparece, mas o EA não abre operações.

Se não há erros nem entradas, o EA está simplesmente aguardando que suas condições de entrada sejam atendidas — isso é perfeitamente normal. Os EAs não entram em todo candle; eles entram apenas quando todas as condições se alinham. Dê um tempo a ele. Um EA de H1 que entra de uma a três vezes por dia está operando normalmente.