EA Performance Guard by Magic Number
- Utilitários
-
Kazuma Uezono
Desenvolvedor MQL5 / MQL4 / Pine Script v6. Crio indicadores, utilitários e Expert Advisors para MetaTrader 4/5 e TradingView.
Serviços:
- Conversão de Pine Script do TradingView para MT5/MT4
- Migração de MT4 para MT5
- Correção de erros e novos recursos em EAs e indicadores existentes - Versão: 1.3
- Atualizado: 17 novembro 2026
- Ativações: 5
O EA Performance Guard acompanha separadamente cada EA da sua conta MetaTrader 5, pelo seu número mágico. Quando um EA atinge um limite que você definiu (drawdown, perda diária ou queda nos resultados recentes: sequência de perdas, fator de lucro, resultado médio, curva de capital abaixo da sua média móvel), ele para somente esse EA: fecha as posições desse EA, exclui as suas ordens pendentes e fecha qualquer nova operação que esse EA abrir enquanto estiver parado. Os seus outros EAs continuam funcionando.
É uma ferramenta que aplica as regras que você define. Nunca abre operações, não dá sinais de compra ou venda e não é uma estratégia de trading. Não evita perdas e não julga se um EA é bom: age somente quando os valores escolhidos são atingidos, e o resultado pode ser pior que o limite (gaps, slippage, atrasos). A escolha dos limites é decisão sua.
Para quem: traders que executam vários EAs em uma mesma conta (por exemplo em um VPS) e querem que cada EA tenha o seu próprio limite de perda e a sua própria regra de "parar quando os resultados caírem", em vez de um único limite para a conta inteira.
Recursos
- Detecção automática: cada número mágico encontrado no histórico da conta, nas posições abertas e nas ordens pendentes recebe a sua própria linha. Operações manuais (magic 0) são opcionais. É possível limitar a ferramenta a uma lista de símbolos.
- Limites de perda por EA: drawdown máximo (valor ou %) e perda diária (valor). O lucro/prejuízo flutuante pode ser incluído.
- Limites de resultado por EA (só começam após um número mínimo de operações fechadas, padrão 20): sequência de perdas, fator de lucro das últimas N operações, resultado médio das últimas N operações abaixo de 0 e curva de operações fechadas do EA abaixo da sua média móvel.
- Ajustes por EA em um único campo de texto: outros limites para alguns números mágicos, somente aviso para outros, ou excluir alguns.
- Ação: parar o EA (fechar, excluir ordens pendentes, fechar novas operações enquanto parado) ou somente aviso (nenhuma ação de trading).
- Variável global do terminal opcional EPG_BLOCK_<magic> = 1 enquanto um EA está parado, para EAs cujo código você pode editar.
- Retomada: após N dias, no início do dia seguinte, somente manual (botão do painel) ou nunca automaticamente.
- O estado de parada é mantido quando o terminal é reiniciado (arquivo e variáveis globais).
- Painel com uma linha por EA e botões Stop / Resume, log CSV, alertas pop-up / push / e-mail.
- Sem DLL, sem WebRequest, sem servidor externo.
Parâmetros principais
- Which EAs: histórico usado nas estatísticas (dias, 0 = tudo), acompanhar também operações manuais (magic 0), lista de símbolos (vazio = todos).
- Loss limits: drawdown máximo sim/não (padrão sim), unidade valor ou % (padrão %), valor (padrão 5), capital por EA para o % (0 = automático, veja abaixo), perda diária sim/não (padrão não) e valor, início de um novo dia (hora e minuto, horário do servidor), incluir lucro/prejuízo flutuante (padrão sim).
- Performance limits: mínimo de operações fechadas (padrão 20); sequência de perdas sim/não e número (padrão sim, 6); fator de lucro sim/não, últimas N operações e mínimo (padrão sim, 30, 0.8); expectativa sim/não e últimas N operações (padrão não, 50); curva abaixo da MA sim/não e período (padrão não, 20).
- Per-EA overrides: uma linha de texto (formato abaixo).
- Action: parar o EA ou somente aviso (padrão: somente aviso), variável global sim/não (padrão sim), slippage máximo ao fechar (pontos).
- Resume: regra (padrão: somente manual), N dias (padrão 3), estatísticas após a retomada (reiniciar a partir do horário da retomada ou manter todo o histórico).
- Log and notifications: log CSV (padrão sim), pop-up (padrão sim), push, e-mail.
- Panel: mostrar, idioma (automático, inglês, japonês), posição, tamanho da fonte, EAs por página.
Como funciona
- As estatísticas de cada EA vêm das operações fechadas do histórico da conta, incluindo swap e comissão. O número mágico do deal de abertura decide a qual EA uma operação pertence. Um deal de fechamento é uma operação: um fechamento parcial conta como uma operação, e o restante conta novamente quando é fechado.
- Condições de parada (cada uma pode ser ligada ou desligada):
- Drawdown máximo: o ponto mais alto do lucro/prejuízo fechado do EA menos o seu valor atual (lucro/prejuízo fechado, mais o flutuante se incluído). Em %, é dividido pelo capital mais esse ponto mais alto. Capital = o seu valor, ou se for 0: saldo da conta menos o lucro/prejuízo fechado deste EA.
- Perda diária: lucro/prejuízo das operações fechadas desde o início de hoje, mais todo o lucro/prejuízo flutuante das posições abertas do EA se incluído (também das posições abertas antes de hoje). "Hoje" começa na hora e minuto que você definir, no horário do servidor (padrão 00:00 do servidor), e não à meia-noite do seu computador.
- Sequência de perdas: operações perdedoras seguidas (uma operação com exatamente 0 encerra a sequência).
- Fator de lucro: lucro bruto / prejuízo bruto das últimas N operações. Não é verificado enquanto essas operações não tiverem nenhuma perda.
- Expectativa: o resultado médio das últimas N operações é menor que 0.
- Curva abaixo da MA: o lucro/prejuízo fechado acumulado do EA está abaixo da sua média móvel simples das últimas N operações.
- O drawdown e a perda diária funcionam desde a primeira operação. As outras quatro começam após o número mínimo de operações fechadas.
- A ferramenta verifica aproximadamente a cada 1 a 2 segundos e logo após cada evento de trading.
- Parar um EA: a ferramenta fecha as posições desse EA e exclui as suas ordens pendentes. Se o mercado estiver fechado, o nível de congelamento impedir ou a corretora rejeitar, ela tenta novamente. Enquanto o EA estiver parado, toda nova posição ou ordem pendente com o seu número mágico é fechada ou excluída; essas operações são registradas como "blocked" e não entram nas estatísticas do EA. Outros números mágicos nunca são tocados.
- Somente aviso: a linha mostra WARN, o evento é registrado e os alertas são enviados, mas nada é fechado ou excluído. O aviso permanece até que a regra de retomada o limpe.
- Botão Stop do painel (clicar duas vezes em 5 segundos): para o EA manualmente, também no modo somente aviso. Um EA parado manualmente só é retomado manualmente.
- Retomada: após N dias, no início do dia seguinte, somente manual ou nunca automaticamente. O botão Resume (clicar duas vezes) funciona em todos os casos.
- Estatísticas após a retomada: "Restart" conta somente as operações após a retomada, então os limites de resultado esperam novamente o número mínimo de operações. "Keep" mantém todo o histórico, mas a avaliação recomeça a partir do horário da retomada: o drawdown e a perda diária são medidos a partir dos valores na retomada, a sequência de perdas conta somente perdas novas, e o fator de lucro, a expectativa e a MA esperam novas operações (o menor entre N e o mínimo). O painel ainda pode mostrar uma sequência mais longa que inclui operações antigas.
- Formato dos ajustes por EA: magic:key=value,key=value, com | entre EAs. Exemplo: 12345:maxdd=3,pf=1.0|67890:off|24680:warn,losses=8. Chaves: off (não acompanhar), warn (somente aviso), stop (parar mesmo no modo somente aviso), maxdd (mesma unidade do ajuste global), daily, losses, pf, pfn (N do fator de lucro), expn (N da expectativa), ma (período da MA), min (mínimo de operações), cap (capital para o %). Um valor acima de 0 liga esse limite para o EA, 0 o desliga. Use | entre EAs: o texto após um ; pode ser cortado quando os parâmetros são salvos em um arquivo .set. Uma entrada errada mostra um erro e a ferramenta não inicia.
- Painel: número mágico, nome do EA (do comentário da ordem, se houver), operações, fator de lucro, expectativa, sequência de perdas atual, drawdown, hoje, estado (Running, WARN, STOP, CLOSING, com o horário de retomada) e um botão Stop / Resume. Passe o mouse sobre um valor para ver detalhes. Botão de recolher e páginas.
- Log CSV: MQL5\Files\EPG\EPG_log_<conta>.csv com horário do servidor, magic, nome, evento (STOP, WARN, RESUME, POSITION_CLOSED, BLOCKED_CLOSED, ORDER_DELETED, CLOSE_FAIL, DELETE_FAIL), motivo, detalhe, as estatísticas naquele momento e o resultado.
- Variável global: EPG_BLOCK_<magic> vale 1 enquanto esse EA está parado e 0 após a retomada. Ela é excluída quando a ferramenta é removida do seu gráfico. O seu próprio EA pode pular novas entradas enquanto GlobalVariableGet("EPG_BLOCK_12345") == 1.
Notas e limitações
- Somente aviso é o padrão. Ao ser anexada, a ferramenta lê o histórico da conta e avalia cada EA que aparece nele: com o histórico padrão (0 = tudo), EAs antigos que não operam mais também são avaliados, e um EA que já está além de um limite (por exemplo, um drawdown passado ainda aberto, ou 6 perdas seguidas no final do histórico) mostra WARN e envia um alerta. Verifique se tudo funciona como você pretende e depois mude Action para "Stop the EA": a partir daí, um EA além de um limite é parado imediatamente e as suas posições são fechadas. Os EAs que mostrarem WARN nesse momento também são parados imediatamente; por isso, retome antes os que você não quer parar.
- A ferramenta não consegue desligar outro EA. Um EA parado continua rodando no seu gráfico; se continuar abrindo operações, cada uma é fechada imediatamente e cada fechamento custa spread e comissão. Remova o EA parado do seu gráfico, ou faça o seu EA ler EPG_BLOCK_<magic>.
- Contas hedging são recomendadas. Em uma conta netting, os EAs que operam o mesmo símbolo compartilham uma posição, que tem o número mágico do deal que a abriu: não podem ser medidos nem parados separadamente, e fechar essa posição também fecha o volume adicionado por outros EAs.
- Todos os valores estão na moeda da conta (por exemplo USD ou JPY), não em pips nem em pontos.
- As perdas podem ir além do limite: a ferramenta age somente depois que um limite é atingido, e gaps, slippage, mercado fechado, ordens rejeitadas ou perda de conexão podem atrasar o fechamento ou dar um preço pior.
- Funciona somente enquanto o MetaTrader 5 está aberto e conectado. Para fechar é preciso que o Algo Trading esteja ligado (botão da barra de ferramentas) e permitido nas configurações do EA. Recomenda-se um VPS.
- Execute uma cópia por conta. Uma segunda cópia no mesmo terminal fica em espera e o painel informa isso. Dois terminais conectados à mesma conta não se enxergam, então ambos agiriam.
- Os EAs são distinguidos somente pelo número mágico. EAs que compartilham um número mágico são tratados como um só EA; EAs que usam magic 0 são tratados como operações manuais.
- Close-by: um close-by conta como uma operação. Quando posições de dois EAs diferentes são fechadas uma pela outra, a operação é atribuída ao EA em cujo lado a corretora lançou o lucro ou a perda.
- As operações que a ferramenta fecha enquanto um EA está parado são reconhecidas pelo comentário que ela coloca no fechamento. Se a corretora apagar ou mudar esse comentário, essas operações podem voltar a contar nas estatísticas do EA depois da retomada.
- O nome do EA vem do comentário da ordem. Pode estar vazio ou ser alterado pela corretora.
- Estatísticas sobre poucas operações variam muito; por isso os limites de resultado esperam um número mínimo de operações. Uma parada por esses limites não significa que o EA é ruim nem que teria perdido.
- Testador de estratégia: não há outros EAs no testador, então a ferramenta não encontra operações de EA e lá só é possível verificar o painel. Teste-a em uma conta demo junto com os seus EAs.
Compatibilidade e suporte
- Somente MetaTrader 5 (contas hedging recomendadas). Anexe a um gráfico de qualquer símbolo; acompanha todos os símbolos da conta, a menos que você defina uma lista de símbolos.
- Sem DLL e sem servidor externo. Os arquivos são gravados somente em MQL5\Files\EPG\.
- Painel em inglês ou japonês (automático pelo idioma do terminal).
- Suporte pelas mensagens do MQL5, resposta em até 3 dias úteis: instalação, configurações e relatos de erros. Não podemos dizer quais limites usar nem quais EAs executar ou parar, e não damos opiniões de mercado nem decisões de trading.
Aviso legal
- Este produto é uma ferramenta de software, não uma recomendação de investimento. Não recomenda nenhum EA, símbolo ou ajuste. Operar produtos alavancados envolve alto risco de perda. Nenhum lucro é prometido ou sugerido, e não há garantia de que uma perda seja evitada ou fique dentro dos seus limites. Teste primeiro em uma conta demo. Os seus ajustes e o seu trading são de sua própria responsabilidade.
