Parameters & Features
For versions released in 2026 and later
Manual do EA (edição MQL5 Market)
Guia comum de uso e parâmetros dos EAs da AT_SYSTEM
Índice
Introdução
Este manual explica o uso, os parâmetros e outras funções comuns aos EAs que eu ofereço.
As descrições e as capturas de tela são do MT5. As versões para MT4 são iguais, salvo indicação em contrário.
As funções e os parâmetros podem estar presentes ou ter nomes diferentes conforme o EA e a versão. Ignore os itens que o seu EA não tiver.
Como configurar o EA
- Arraste e solte o EA sobre o gráfico de qualquer par de moedas de Forex.
- O gráfico passará automaticamente para o par de moedas e o período do EA
(função de configuração automática do gráfico). - As cores dos candles mudam e, à direita, aparecem as configurações dos parâmetros.
(Os detalhes são explicados adiante. No mais, a configuração é igual à de qualquer outro EA.)
Você também pode confirmar que o EA foi configurado pelo registro na aba «Experts» da Caixa de ferramentas (Toolbox).
Ao anexar o EA, a aba «Common» (no MT4, a aba «About») mostra uma especificação resumida. Defina o número de barras carregadas no gráfico como, no mínimo, o número indicado ali.
Parâmetros e comentário do gráfico
A seguir, cada bloco é explicado separadamente.
Os itens entre [ ] aparecem no comentário do gráfico.
1. Configurações básicas e de juros compostos
| Parâmetro | Descrição |
|---|---|
| Magic Number [magic] | Número de identificação do EA. Use um valor diferente para cada EA. Se coincidir com o de outro EA, os EAs funcionarão de forma incorreta. |
| Fixed Lot [lots] | Tamanho do lote na operação com lote fixo. Também é usado quando se escolhem juros compostos, mas não há SL. |
| Lot Calculation Mode [met] | Configuração dos juros compostos. 0 = lote fixo, 1 = juros compostos (saldo), 2 = juros compostos (margem livre) |
| Risk Percent [risk] | Configuração de risco nos juros compostos. É a perda máxima por SL como porcentagem da base escolhida (saldo ou margem livre). |
| Initial Balance | Saldo com que os juros compostos começam, na moeda da conta. Não aparece no comentário do gráfico. |
| Lot Growth Rate [ver] | Define, de 0 a 100, em que medida as variações dos fundos se refletem no tamanho do lote. Suaviza as mudanças bruscas do lote causadas por variações bruscas dos fundos. |
Diferenças entre os modos de juros compostos
- Balance (saldo): método de cálculo em que o tamanho do lote muda pouco com as oscilações da margem livre, mesmo quando operações de vários EAs se sobrepõem. No entanto, a margem livre pode ficar baixa.
- Free Margin (margem livre): quando operações de vários EAs se sobrepõem e a margem livre muda muito, o cálculo do lote é afetado. Por outro lado, também pode ser usado com margem livre baixa.
Initial Balance é consultado independentemente de quantos anos se passaram desde o início da operação. Mesmo que o EA pare (por exemplo, após reiniciar o terminal), o lote pode ser recalculado nas mesmas condições.
Nos backtests, os juros compostos são calculados supondo 1 USD = 150 JPY. Por isso, os lotes podem diferir dos da operação real.
Se o lote ficar no valor de Fixed Lot mesmo com juros compostos selecionados, verifique a aba Experts e adicione ao Market Watch (Observação do mercado) os pares de moedas necessários para o cálculo. Talvez o cálculo passe a funcionar.
Exemplo: ao operar AUDCAD em uma conta em ienes, os juros compostos não podem ser calculados se o USDCAD não estiver no Market Watch, e o lote fica no valor de Fixed Lot.
Fórmula dos juros compostos
Lote com juros compostos = valor de risco ÷ perda por SL a cada 1 lote
Valor de risco = saldo base × percentual de risco (Risk Percent)
Saldo base = saldo inicial (Initial Balance) + (fundos atuais − saldo inicial) × taxa de variação do lote (Lot Growth Rate)
Fundos atuais = saldo atual + crédito, ou a margem livre atual
Exemplo: USDJPY, Lot Calculation Mode = margem livre, Risk Percent 5 %, Initial Balance 700.000 ienes, fundos atuais 1.000.000 de ienes, Lot Growth Rate 30 %, SL de 210 pips
{700.000 ienes + (1.000.000 ienes − 700.000 ienes) × 30 %} × 5 % ÷ 210.000 ienes ≈ 0,188 → 0,18 lote (arredondado para baixo ao passo do lote)
Se o lote calculado for inferior ao lote mínimo da corretora, usa-se o lote mínimo. Nesse caso, o risco fica maior do que o configurado.
2. Filtros e controle das operações
| Parâmetro | Descrição |
|---|---|
| Allowed Max Spread [max] | Limite superior do spread (em pips) com o qual a operação é permitida. Na figura, é o 8 no canto superior esquerdo dentro do quadro. |
| Allowed range from average spread [adj] | Pips somados ao spread médio medido internamente (mostrado como [avg] no comentário do gráfico). Se o spread ultrapassar «média + este valor», o EA deixa de operar. Quando a média sobe ou desce, o spread permitido também sobe ou desce gradualmente. Allowed Max Spread define o seu limite superior. |
| TP e SL de Buy / Sell [Buy TP,SL / Sell TP,SL] | Nos EAs em que o TP e o SL podem ser alterados, eles aparecem na lista de parâmetros. A unidade é, em princípio, o pip (1 pip = 10 pontos). |
| Stop new entries after loss Loss that triggers entry stop [cooldown h,pips] | Somente nos EAs que a incluem. Quando um único fechamento resulta em uma perda de Loss that triggers entry stop (pips) ou mais, novas entradas ficam proibidas por Stop new entries after loss (horas). Se as horas forem 0, a função fica desativada. Para mais detalhes, consulte o item 5 das funções de apoio integradas. |
| Operation Mode | Nos parâmetros, você pode alternar entre somente compra, somente venda, ambas ou ambas paradas. No MT5 funciona da mesma forma. No lado que não está ativo, o TP e o SL aparecem escurecidos. |
| Allow hedging [2way] | true: hedging permitido; false: não permitido. O valor padrão varia conforme o EA. Em princípio, essa chave vem de série para que possa ser alterada quando uma corretora proíbe o hedging. |
| Weekend carry-over [weekend] | true: as posições são mantidas durante o fim de semana; false: não. O valor padrão varia conforme o EA. Se for false, qualquer posição aberta é fechada na sexta-feira às 23:00. |
| Triple swap stop control [3xSwapTrade] | Somente nos EAs que a incluem. O EA detecta automaticamente o dia com swap triplo e deixa de abrir operações pouco antes da virada desse dia. O momento exato varia conforme o EA. |
| Summertime [DST] | Somente nos EAs afetados pelo horário de verão. O EA o detecta automaticamente e um item é adicionado ao comentário do gráfico. none: nenhum | American: estilo americano | European: estilo europeu/britânico |
3. Utilitários (Utilities)
| Parâmetro | Descrição |
|---|---|
| Export trade info to CSV [csv] | Para cada entrada, fechamento, TP/SL e ordem com falha, grava em um arquivo CSV o spread, o gap, o slippage, a latência, o lucro ou prejuízo flutuante, o swap e mais. Os detalhes são apresentados adiante. |
| Show P/L pips on chart [pips] | Com base no histórico de operações do terminal, mostra no gráfico as linhas da entrada até o fechamento e os pips obtidos. |
| Order Comment [cmt] | O texto digitado aparece no campo de comentário das ordens. Texto com mais de 31 caracteres é cortado automaticamente pelo final. Mesmo que o comentário se perca, é exibido o comentário interno padrão. |
4. Parâmetros de cada estratégia de compra/venda
| Parâmetro | Descrição |
|---|---|
| Enable Strategy1~ | Ativa: true / Inativa: false |
| TP [pips] | Você pode alterar o TP máximo. Em alguns EAs, o valor varia conforme as condições. |
| SL [pips] | O SL máximo. Em alguns EAs, o valor varia conforme as condições. É usado no cálculo dos juros compostos. Se uma estratégia tiver vários SLs, o cálculo usa o máximo entre as estratégias ativas. O máximo aparece na aba Experts durante a inicialização, logo após configurar o EA. |
Funções de apoio integradas
Para evitar perdas desnecessárias por erro humano, o EA inclui várias funções de apoio que reduzem a probabilidade de erros de operação. Como apoio à verificação, ele também mantém as funções que usei durante o desenvolvimento, como a saída detalhada das operações e a exibição do histórico de operações no gráfico.
1. Configuração automática do gráfico
Ao arrastar e soltar o EA sobre um gráfico de Forex, o gráfico passa automaticamente para o par de moedas e o período corretos, e os parâmetros aparecem à direita. As cores das barras e de outros elementos também mudam.
Nos instrumentos que não são Forex (criptomoedas, índices etc.), os caracteres que seguem o nome do símbolo variam conforme a corretora. Por isso, abra você mesmo o gráfico com o símbolo e o período corretos antes de configurar o EA.
2. Comentário do gráfico
As informações resumidas, como os parâmetros, ficam à direita do gráfico para facilitar a leitura. O «Magic Number» e o «tamanho do lote», que podem causar problemas se estiverem errados, aparecem maiores e em outra cor.
O comentário é compacto para continuar visível mesmo que você reduza o gráfico e coloque vários lado a lado, e os itens de maior prioridade ficam no alto. Se o comentário da ordem for longo, a fonte fica menor. Usa-se a fonte padrão para evitar caracteres ilegíveis.
3. Mudanças no gráfico por erros e outros estados
Quando o EA não consegue operar, a aparência do gráfico muda conforme a situação, para que isso seja percebido de imediato. Se o EA ficar inativo, por exemplo por perda de conexão, tudo, exceto o Magic Number e o tamanho do lote, fica escurecido.
Se o EA for removido, por exemplo após uma atualização do terminal, o comentário pode permanecer com o nome do EA, no canto superior direito, em branco. Como nada fica escurecido, é fácil confundir com funcionamento normal, por isso tenha cuidado.
4. Verificação de fundos insuficientes
A verificação de margem insuficiente já vem de série há algum tempo. No entanto, o EA podia entrar com fundos que não suportavam nem uma pequena perda flutuante, apesar de haver muita folga até o SL.
Por isso, se os fundos não suportarem um SL, o EA deixa de abrir novas entradas e exibe um aviso. Quando esse aviso aparecer, verifique seus fundos e o tamanho do lote.
5. Cooldown (pausa após uma perda)
Esta função está disponível somente nos EAs que a incluem. Após uma perda grande no fechamento anterior, ela interrompe novas entradas por um tempo determinado. É usada para evitar entradas consecutivas (excesso de operações) quando o mercado se move de repente.
- Loss that triggers entry stop [pips]: tamanho da perda que aciona a parada.
- Stop new entries after loss [0=off, hours]: por quanto tempo as novas entradas ficam paradas. Se for 0, a função fica desativada.
Durante a pausa, o tempo restante (horas:minutos) é exibido em laranja na parte inferior do comentário do gráfico.
O tempo é contado a partir do horário de fechamento da posição com perda. Só é avaliado o fechamento mais recente do mesmo par de moedas e do mesmo Magic Number. Param as novas entradas tanto de compra quanto de venda. O fechamento de posições continua normalmente.
6. Alerta de Magic Number duplicado
Se parecer que um Magic Number está duplicado dentro do mesmo MT4/MT5, é exibida uma janela de alerta.
Se você desligar o PC sem fechar o terminal MT4/MT5, o processamento de encerramento não é executado e o alerta pode aparecer mesmo sem duplicidade. Ele também pode aparecer inesperadamente em outros casos. Se não houver duplicidade, você pode ignorá-lo e continuar a configuração.
7. Aviso para corretoras GMT0
Para algumas corretoras GMT0 definidas internamente, é exibido um alerta de aviso. As demais corretoras GMT0 não são verificadas. Avalie por conta própria.
Para o GMT compatível, consulte GMT em «Outras observações».
8. Controle automático do horário de verão
Nos EAs que precisam de uma configuração de horário de verão, ele é detectado automaticamente para cada corretora. Ao configurar o EA, a aba Experts mostra uma das opções a seguir.
- No summertime
- American summertime
- European(UK) summertime
Ele também é exibido na parte inferior do comentário do gráfico. A detecção se baseia nas corretoras que conheço. Em outras corretoras, a detecção pode ser diferente. Se o que for exibido não coincidir com a sua corretora, avise-me.
9. Medição automática do spread
O EA calcula automaticamente o spread médio e define internamente, como valor do filtro de spread, essa média mais alguns pips. Não é mais preciso medir e conferir o spread toda vez que o EA é configurado.
- Como parâmetros, definem-se o limite superior (Allowed Max Spread) e a margem em relação à média (Allowed range from average spread).
- Também funciona nos backtests. Os parâmetros relacionados ao spread podem ser otimizados com os spreads variáveis do TDS ou com os ticks reais do MT5.
- A média exclui a hora 0:00 do horário do servidor. Se o EA continuar funcionando sem reiniciar, faz a média de, no máximo, um mês. Os dados acumulados são zerados quando o terminal é reiniciado e quando o mês muda.
- Nada é medido enquanto o gráfico não se move.
10. Linhas do histórico de operações e exibição de pips
Mostra o histórico de operações de forma visual no gráfico. É exibido mesmo que você mude o período. Quando não for necessário, ative ou desative (ON/OFF) nos parâmetros. Mostra a linha da entrada até o fechamento e os pips obtidos.
O MT4 também pode exibir nos backtests. No MT5, funciona nos backtests somente no modo visual.
11. Exibição do tester
Durante os backtests, é exibido o fator de recuperação anualizado (YRF). É uma das métricas que consulto durante o desenvolvimento.
YRF = lucro ÷ drawdown ÷ anos
- MT4: exibido na aba «Journal» após um backtest. Durante a otimização, também é exibido na coluna OnTester.
- MT5: o YRF é exibido na aba «Journal» após um backtest. Nos resultados da otimização, a coluna de resultado mostra o drawdown máximo.
12. Registro das informações das operações (saída CSV)
As informações de cada operação podem ser registradas em um arquivo CSV. Ative nos parâmetros. A saída deixa o processamento um pouco mais pesado.
| Ticket | Order Time | Hour | Minute | Day of Week | Order Type | Order Price | Fill Price | Allowed Spread(pips) | Average Spread(pips) | Fill Spread(pips) | Gap(pips) | Slippage(pips) | Latency(ms) | Runtime(ms) | Order Retries | Profit/Loss(pips) | Max Floating Profit(pips) | Max Floating Loss(pips) | Commission | Swap | Gross P/L | Net P/L | Hold Time | Lot Size | Symbol | Timeframe | EA Name | Version | Magic Number |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2 | 2021.01.06 02:00:00 | 2 | 0 | Wed | Buy | 139.933 | 139.933 | 3.8 | 0.8 | 0.6 | 0.6 | 0.0 | 0 | 0 | 1 | --- | --- | --- | --- | --- | --- | --- | --- | 0.1 | GBPJPY- | M5 | Murasame | 6.4 | 852431095 |
| 3 | 2021.01.06 06:25:00 | 6 | 25 | Wed | Sell | 139.926 | 139.926 | 3.9 | 0.9 | 0.7 | 0.0 | 0.0 | 0 | 0 | 1 | --- | --- | --- | --- | --- | --- | --- | --- | 0.1 | GBPJPY- | M5 | Murasame | 6.4 | 852431095 |
| 3 | 2021.01.06 11:00:00 | 11 | 0 | Wed | Close | 140.1 | 140.1 | 3.9 | 0.9 | 0.7 | -0.7 | 0.0 | 0 | 0 | 1 | -17.4 | 8.5 | -45.2 | 0.0 | 0.0 | -16.92 | -16.92 | 4:35:00 | 0.1 | GBPJPY- | M5 | Murasame | 6.4 | 852431095 |
| 2 | 2021.01.08 09:04:58 | 9 | 4 | Fri | TP | 141.099 | 141.099 | 3.9 | 0.9 | 0.9 | 0.0 | 0.0 | 0 | 0 | 1 | 116.6 | 116.7 | -16.2 | 0.0 | 2.69 | 112.19 | 114.88 | 55:04:58 | 0.1 | GBPJPY- | M5 | Murasame | 6.4 | 852431095 |
| 6 | 2021.01.19 01:00:00 | 1 | 0 | Tue | Buy | 140.835 | 140.835 | 3.9 | 0.9 | 2.8 | 2.8 | 0.0 | 0 | 0 | 1 | --- | --- | --- | --- | --- | --- | --- | --- | 0.1 | GBPJPY- | M5 | Murasame | 6.4 | 852431095 |
| 6 | 2021.01.20 10:34:59 | 10 | 34 | Wed | TP | 141.884 | 141.884 | 3.9 | 0.9 | 0.7 | 0.0 | 0.0 | 0 | 0 | 1 | 104.9 | 106.3 | -5.4 | 0.0 | 0.67 | 101.06 | 101.73 | 33:34:59 | 0.1 | GBPJPY- | M5 | Murasame | 6.4 | 852431095 |
| 8 | 2021.01.21 01:10:00 | 1 | 10 | Thu | Sell | 141.456 | 141.456 | 3.9 | 0.9 | 2.1 | -0.1 | 0.0 | 0 | 0 | 1 | --- | --- | --- | --- | --- | --- | --- | --- | 0.1 | GBPJPY- | M5 | Murasame | 6.4 | 852431095 |
| 8 | 2021.01.21 06:20:00 | 6 | 20 | Thu | Close | 141.561 | 141.561 | 3.9 | 0.9 | 1.1 | -1.1 | 0.0 | 0 | 0 | 1 | -10.5 | 0.4 | -26.7 | 0.0 | 0.0 | -10.15 | -10.15 | 5:10:00 | 0.1 | GBPJPY- | M5 | Murasame | 6.4 | 852431095 |
| Local | Operação real/demo: a pasta Files dentro da pasta MQL4 ou MQL5 Backtest (MT4): tester\files dentro da pasta de dados do MT4 Backtest (MT5): MQL5\Files dentro da pasta própria do tester (exemplo: MetaQuotes\Tester\(ID)\Agent-127.0.0.1-(número da porta)\MQL5\Files) |
|---|---|
| Nome do arquivo | Nome do EA_número da conta_TradeLog.csv (comum ao MT4/MT5; um arquivo separado para cada EA) |
| Delimitador | Separado por tabulação |
| Colunas | Ticket / Order Time / Hour / Minute / Day of Week / Order Type / Order Price / Fill Price / Allowed Spread(pips) / Average Spread(pips) / Fill Spread(pips) / Gap(pips) / Slippage(pips) / Latency(ms) / Runtime(ms) / Order Retries / Profit/Loss(pips) / Max Floating Profit(pips) / Max Floating Loss(pips) / Commission / Swap / Gross P/L / Net P/L / Hold Time / Lot Size / Symbol / Timeframe / EA Name / Version / Magic Number |
- A pasta de dados do MT4 pode ser aberta pelo menu: File → Open Data Folder.
- A pasta própria do tester no MT5 tem um ID e um número de porta que variam conforme o ambiente. Se não conseguir encontrá-la, procure _TradeLog.csv dentro da pasta MetaQuotes\Tester.
- O tipo de ordem (Order Type) é registrado separadamente como buy / sell / Close / TP / SL.
- TP/SL pode ser contado duas vezes.
Lógica e técnicas integradas
| Nome | Descrição |
|---|---|
| Sem novas entradas durante a hora 0:00 do servidor | Em princípio, não se abrem novas entradas durante a hora 0:00, quando os spreads tendem a se ampliar. Conforme a lógica, algumas estratégias fecham posições nessa hora e outras não. |
| Filtro de spread no fechamento | Também se aplica um filtro de spread aos fechamentos, para que seja menos provável que as posições sejam fechadas quando o spread está amplo no início da manhã. No entanto, ele não consegue controlar os fechamentos por SL e não se aplica a eles. Alguns EAs não o têm devido à natureza de sua lógica. |
| Filtro de gap | Não há entrada quando a diferença entre o fechamento da barra anterior e o preço atual supera um valor determinado. O valor é definido para cada EA. Muitas estratégias se baseiam no fechamento da barra anterior, portanto um preço de execução distante dele é desvantajoso; este filtro visa limitar isso. Também ajuda a evitar os problemas em que o preço salta e a ordem é executada a um preço com gap. Não se aplica aos fechamentos. Você pode conferir o gap de cada operação na saída CSV. |
| Prevenção de execuções por salto de preço | No passado, houve casos em que o preço saltou logo após a entrada e atingiu o SL. Parece que isso aconteceu enquanto o preço mostrava um valor anormal. Um filtro de spread não conseguia evitar, nem o momento de colocar o SL ou a configuração de slippage. Um método que pode evitar isso está integrado a todos os EAs que podem incluí-lo. |
| Controle de fim de ano e Ano-Novo | De cerca de 20 de dezembro (varia conforme o EA) até 3 de janeiro do ano seguinte, não são abertas novas entradas e só se realizam fechamentos. Se quiser fechar posições mais cedo nesse período, faça isso manualmente. |
| Verificação de margem e de permissão para operar | Evita enviar ordens com um lote que exceda a sua margem ou enquanto a operação não é permitida no MT4/MT5. Isso evita enviar continuamente comunicações inúteis ao servidor por causa de erros de ordens. |
| AMPAC (Anti Miss Positioning Auto Control) | Tecnologia desenvolvida por mim para melhorar a execução das ordens. No MT4/MT5, as ordens podem ser ignoradas porque as cotações chegam atrasadas por demoras de comunicação ou porque o processamento do EA está congestionado. Minha própria lógica de reenvio de ordens e o processamento leve compensam isso e melhoram a execução. |
| Magnet coding | Técnica de programação que desenvolvi para o MT4 para que o EA funcione corretamente na operação real. O MT4 às vezes não se comporta como indica o código, e um filtro que funciona nos backtests pode não funcionar na operação real. Esta é uma forma de evitar isso. Não é perfeita e podem restar algumas diferenças, mas a diferença entre os backtests e a operação real no mesmo período tende a ser menor do que nos EAs criados antes de 2024. |
Outras observações
GMT
Meus EAs usam muito os candles diários, por isso só funcionam com corretoras com GMT+2 no inverno / GMT+3 no verão que tenham cinco candles diários por semana. Com qualquer outro GMT há seis candles diários, mudam os cálculos entre os candles diários e os de 4 horas, e a lógica não se sustenta.
Número de barras exibidas no gráfico
A maioria dos EAs precisa de 1000 barras ou mais. O número de barras necessário consta da especificação resumida exibida na aba «Common» (no MT4, «About») ao configurar o EA. Defina, no mínimo, esse número.
Configuração em fins de semana
Nos fins de semana o gráfico não se move, então, após configurar o EA no MT5, o comentário do gráfico pode não aparecer. Nesse caso, clique novamente em «OK» na tela de parâmetros e talvez ele apareça.
Observações e isenção de responsabilidade
- Dependendo do EA e da versão, cada função pode não estar incluída ou ser descrita de forma diferente.
- As funções de apoio e o comentário do gráfico são apenas auxílios. Não há garantia de que funcionem com exatidão.
- Faço o possível, mas podem ser encontrados erros. Se encontrar algum, agradeceria se me avisasse por meio de um comentário na página do EA correspondente no MQL5 ou de uma mensagem privada.