Verificação prévia da cesta de corretoras — diagnóstico de contratos somente para leitura e de volume mínimo - script para MetaTrader 5

Verificação prévia da cesta da corretora

Um script MetaTrader 5 original e independente para verificar a configuração de múltiplos símbolos de uma corretora antes de desenvolver ou testar um EA de portfólio. Ele lê os símbolos exatos já selecionados no Market Watch e gera um relatório de diagnóstico no diário de Experts. O código-fonte MQ5 inclui a licença MIT e não requer nenhuma biblioteca externa, DLL ou solicitação de rede.

Guia de instalação: o arquivo START-HERE.txt anexado explica a instalação, as três entradas e unidades, os rótulos do diário e um resumo do teste gravado em inglês e francês.

Utilização

1. Copie o arquivo BrokerBasketPreflight.mq5 para a pasta MQL5/Scripts, abra-o no MetaEditor e compile com a tecla F7.
2. Selecione cada símbolo exato da corretora no Market Watch e aguarde a chegada das cotações de compra/venda. Prefixos e sufixos não são adivinhados.
3. Execute o script em um gráfico separado. Deixe InpSymbols em branco para o símbolo desse gráfico ou insira uma cesta separada por vírgulas usando os nomes exatos da sua corretora.
4. Leia as linhas SPEC, QUOTE, CALC, WARN, SKIP e SUMMARY no diário do Expert. Corrija qualquer problema de nome, dados ou especificação e execute novamente.

Entradas

• InpSymbols — vazio por padrão; caso contrário, de uma a 64 entradas separadas por vírgulas. Os nomes são truncados. Entradas desconhecidas, não selecionadas, vazias e duplicadas são ignoradas independentemente, para que as entradas válidas posteriores ainda possam ser inspecionadas.
• InpMaxQuoteAgeSeconds — padrão 120. Avisará quando a última cotação for mais antiga do que esse limite; 0 desativa o limite de idade para cotações desatualizadas.
• InpMaxSpreadPoints — padrão 0, o que significa desativado. Um limite opcional de alerta de spread em pontos da corretora, não em pips ou na moeda da conta.

Saídas

O relatório mostra o tamanho do contrato, volume mínimo/máximo/incremento, limite agregado de volume direcional, ponto, tamanho do tick negociável, dígitos, distâncias de stop/congelamento, modos de cálculo e negociação, modo de execução e políticas relatadas de preenchimento de ordens de mercado. Ele verifica as grades de volume e preço, sincronização, hora da cotação e spread. Esses campos seguem as propriedades de símbolos do MQL5; a cotação atual de compra/venda é lida com SymbolInfoTick.

Para cotações válidas e alinhadas à grade, além do volume mínimo, o script estima a margem isolada de COMPRA e VENDA, o resultado de um movimento de preço de um tick para cima e para baixo para cada lado e o resultado imediato apenas do spread para cada lado. Os valores são indicados na moeda da conta. Falhas no OrderCalcMargin e no OrderCalcProfit são relatadas como avisos; um resultado indisponível nunca é substituído por um zero fictício. Cálculos com cotações desatualizadas são identificados como históricos.

Limitações

O script não envia ordens nem gerencia posições. Ele não chama APIs para alterar configurações de gráficos, seleções do Market Watch ou variáveis globais do terminal. Ele não informa identificador de conta, saldo ou lista de posições. A saída é apenas texto de diário.

As estimativas de margem ignoram posições atuais e ordens pendentes e não constituem uma verificação da margem disponível. Os cálculos de variação de preço e spread excluem comissão, swap e slippage. O script não valida o histórico diário, sinais de indicadores ou horários de abertura das sessões de negociação. Um relatório sem erros não comprova que os fundos sejam suficientes ou que a corretora aceitará uma ordem. Símbolos personalizados, cotações desatualizadas e dados de conversão de moeda ausentes exigem análise separada.

Validação

Verificado em 7 de outubro de 2026: o script independente foi compilado no MetaEditor com 0 erros e 0 avisos. Um teste de funcionamento isolado no MT5 Strategy Tester executou o mesmo diagnóstico por meio de um wrapper de EA apenas para teste no US500 com uma conta simulada em USD. Ele inspecionou um símbolo válido, ignorou quatro entradas inválidas/duplicadas/vazias e produziu duas estimativas de margem e seis verificações de lucro, sem nenhum aviso. Dezoito verificações auxiliares determinísticas também foram aprovadas. O wrapper não faz parte deste envio. Trata-se de um teste de funcionamento do software, não de uma validação de todas as corretoras, símbolos ou moedas de conta.