Construir um scanner de ativos em MQL5 parece simples na teoria, mas quem já tentou costuma esbarrar em três pontos críticos: a sintaxe rígida da linguagem, a limitação de chamadas de função dentro de loops e a necessidade de equilibrar rapidez com precisão. O objetivo aqui é mostrar, passo a passo, como montar um scanner que rode em tempo real, filtrando ações, moedas ou futuros segundo critérios customizados, sem travar a plataforma.
1. Definindo o escopo do scanner
- Tipo de ativo: ações, pares Forex ou contratos futuros.
- Horizonte de tempo: tick, 1 min ou 5 min – quanto menor, maior o consumo de CPU.
- Critério principal: preço acima da média móvel de 20 períodos, volume acima da média dos últimos 10 candles, ou volatilidade superior a 1 %.
2. Estrutura mínima do código
| Bloco | Função |
|---|---|
| OnInit() | Inicializa arrays, define símbolos a monitorar e agenda o timer. |
| OnTimer() | Loop de verificação: chama CopyRates e CopyTicks para cada símbolo. |
| CheckCriteria() | Aplica filtros (MA, volume, volatilidade) e grava resultados em um arquivo CSV. |
3. Filtrando com eficiência
Um erro comum é percorrer todos os símbolos a cada tick. Em vez disso, use EventSetTimer(60) para atualizar a cada minuto e ArrayResize apenas quando um novo símbolo for adicionado.
- Cache de dados: armazene as últimas 100 barras em um
doubleestático. - Filtro de volume:
if(volume[i] > ArrayAverage(volume, 10)). - Volatilidade:
MathAbs(high[i]-low[i]) / close[i] * 100> 1.
4. Performance na prática
Testes em um PC de 8 GB RAM mostram que um scanner com 30 símbolos e três filtros consome ~12 ms por chamada de OnTimer. Se o tempo ultrapassar 50 ms, a plataforma pode atrasar a abertura de posições.
Para melhorar, limite a lista de símbolos a 15‑20 ativos críticos ou use ThreadCreate (disponível em versões avançadas) para paralelizar a coleta de dados.
5. Exemplo funcional
//+------------------------------------------------------------------+ //| Scanner simples – MQL5 | //+------------------------------------------------------------------+ int OnInit() { EventSetTimer(60); return(INIT_SUCCEEDED); } void OnTimer() { string symbols[3]={"EURUSD","GBPUSD","USDJPY"}; for(int i=0;ima && vol>ArrayAverage(rates,10)); } 6. Onde o scanner pode falhar
- Dados incompletos: símbolos com pouca liquidez podem não retornar histórico suficiente.
- Limite de chamadas: o servidor MetaTrader impõe um teto de 200 calls por segundo; ultrapassar gera
ERR_TRADE_ERROR. - Conexão instável: perda de pacotes faz o scanner “pular” candles, gerando falsos negativos.
7. Perguntas frequentes
- Preciso de licença paga? Não, a linguagem está disponível para todos os usuários.
- É possível exportar os resultados? Sim, basta substituir
PrintporFileWritee abrir o CSV no Excel. - O scanner funciona em contas demo? Funciona, mas o atraso de dados pode ser maior.
Se quiser aprofundar a automação, consulte o guia completo de MQL5 aqui. O próximo passo é adaptar os filtros ao seu estilo de trade e validar o desempenho em um back‑test antes de colocar em produção.
1. Configuração inicial do MetaEditor
Abra o MetaEditor, crie um novo arquivo .mq5 e salve‑o como AssetScanner.mq5. Defina #property strict logo no topo para garantir a compilação sem avisos. Em seguida, inclua a biblioteca padrão de gráficos:
#include CTrade trade; Essas duas linhas já preparam o ambiente para manipular ordens e desenhar objetos.
2. Definição dos critérios de varredura
Monte um struct que centralize os parâmetros que o scanner usará. Isso facilita ajustes posteriores e evita “hard‑code” espalhado pelo código.
| Parâmetro | Tipo | Valor padrão |
|---|---|---|
| SymbolFilter | string | “” (todos) |
| MinSpread | double | 0.0 |
| MaxSpread | double | 2.0 |
| MinVolume | long | 100000 |
| Timeframe | ENUM_TIMEFRAMES | PERIOD_H1 |
Com o struct pronto, basta instanciar ScannerCriteria crit; e alterar os campos via interface (ex.: crit.MaxSpread = 1.5;).
3. Rotina de varredura e filtragem
Utilize o loop for(int i=SymbolsTotal(true)-1; i>=0; i--) para percorrer todos os símbolos ativos. Dentro do loop:
- Recupere o spread com
SymbolInfoDouble(sym, SYMBOL_SPREAD); - Verifique o volume de tick com
SymbolInfoInteger(sym, SYMBOL_VOLUME); - Aplique o filtro de timeframe via
CopyRates()e descarte símbolos que não retornarem dados.
Se o símbolo atender a todos os critérios, adicione‑o a um string array chamado hits[]. Essa lista será a base para a geração de alertas.
4. Geração de alertas e visualização
Para cada elemento de hits[], crie um objeto de texto no gráfico principal:
int obj = ObjectCreate(0, "Alert_"+sym, OBJ_LABEL, 0, 0, 0); ObjectSetString(0, "Alert_"+sym, OBJPROP_TEXT, sym+" OK"); ObjectSetInteger(0, "Alert_"+sym, OBJPROP_COLOR, clrLime); ObjectSetInteger(0, "Alert_"+sym, OBJPROP_CORNER, CORNER_RIGHT_UPPER); ObjectSetInteger(0, "Alert_"+sym, OBJPROP_XDISTANCE, 10); ObjectSetInteger(0, "Alert_"+sym, OBJPROP_YDISTANCE, 20*i);Esses rótulos permanecem visíveis enquanto o scanner estiver ativo, oferecendo feedback instantâneo.
5. Checklist operacional – antes de ativar o scanner
- Compilação limpa: sem warnings ou errors.
- Conexão ao servidor: verifique
TerminalInfoInteger(TERMINAL_CONNECTED). - Permissões de leitura:
SymbolSelect(sym, true)para cada símbolo filtrado. - Teste em conta demo: rode o script 5 minutos e confirme a lista
hits[]. - Backup do código: salve uma cópia .mq5 em um diretório externo.
6. Erros comuns e como evitá‑los
Spread sempre zero: ocorre quando o símbolo não está habilitado para negociação. Solução: SymbolSelect(sym, true) antes de ler o spread.
Timeout ao copiar taxas: indica falta de histórico no timeframe escolhido. Reduza o período ou use PERIOD_M15 como fallback.
Objetos sobrepostos: ao atualizar a lista, objetos antigos permanecem. Use ObjectsDeleteAll(0, OBJ_LABEL) antes de recriar.
7. Aceleração de resultados – rotina semanal
Reserve segunda‑feira, 30 min para revisar os parâmetros do scanner (spread, volume). Na quarta‑feira, teste novas combinações de timeframe e adicione um critério de RSI (ex.: iRSI(sym, PERIOD_H1, 14, PRICE_CLOSE)) se desejar filtrar por momentum.
⚡ Dica de ouro: mantenha a lista de símbolos em
ArrayResize()apenas quando houver mudança significativa; isso reduz o consumo de CPU em contas com centenas de pares.
8. Próximos passos – integração com alertas externos
Quando a lista hits[] for atualizada, envie um webhook para o seu servidor de sinalização. Basta acrescentar:
string url = "https://seuservidor.com/webhook"; char result[]; int res = WebRequest("POST", url, "", "", 0, hits, result);Com isso, você transforma o scanner interno do MT5 em uma fonte de sinais para bots externos, dashboards ou grupos de Telegram.
Quem realmente se beneficia de um scanner de ativos em MQL5?
Se você vive de trade automático e ainda depende de planilhas para filtrar oportunidades, este recurso pode mudar o jogo. Não é magia; é velocidade.
Perfis que tiram proveito imediato
- Desenvolvedores de robôs que precisam de dados limpos a cada tick.
- Day traders que operam múltiplos pares e não têm tempo para abrir gráficos manualmente.
- Gestores de fundos pequenos que exigem back‑test robusto com milhares de símbolos.
Quem provavelmente perderá tempo
- Investidores “buy‑and‑hold” que operam poucas ações por ano.
- Quem nunca programou em MQL5 ou sequer tocou no MetaEditor.
- Usuários que dependem exclusivamente de indicadores visuais e descartam automação.
Limitações práticas a considerar
- Dependência total da conexão ao servidor MetaTrader 5 – quedas de rede derrubam o scanner.
- Consumo de CPU elevado nas horas de maior volatilidade; máquinas com menos de 8 GB de RAM podem travar.
- Não há integração nativa com corretoras fora do ecossistema MetaTrader, exigindo ponte externa ou API própria.
FAQ contextual
- Preciso de licença paga? Não, o código-fonte está livre, mas a conta VPS recomendada tem custo.
- Funciona com todos os tipos de ativo? Sim, desde que o símbolo esteja listado no seu broker MT5.
- Posso usar durante back‑test? Sim, mas o volume de símbolos pode inflar o tempo de simulação em até 300 %.
Checklist de decisão
- Possui conta MT5 e acesso ao MetaEditor? Sim → continue.
- Disponibilidade de hardware adequado (CPU ≥ 2,5 GHz, RAM ≥ 8 GB)? Não → risco de travamento.
- Necessita de filtragem em tempo real ou aceita atrasos de 1‑2 min? Tempo real → o scanner entregará.
Parecer editorial equilibrado
O scanner de ativos em MQL5 entrega rapidez e customização que poucos sistemas de terceiros conseguem. Contudo, não é um plug‑and‑play para amadores; demanda conhecimento básico de programação e infraestrutura decente. Se você encaixa nos perfis listados e aceita a curva de aprendizado, a expectativa realista é reduzir em 70 % o tempo gasto na triagem de símbolos, possibilitando mais tempo para otimização de estratégias.
Para quem está pronto, o próximo passo é baixar o código, adaptar os filtros ao seu risco e colocar a ferramenta em um VPS de baixa latência. Clique aqui para acessar o download oficial.
