ENUM_SYMBOL_OPTION_MODE: Tipos, Estilos e Automação MQL5
A enumeração ENUM_SYMBOL_OPTION_MODE parece um detalhe burocrático na documentação do MetaTrader 5, mas define se sua estratégia de opções vive ou morre no backtest. O valor retornado — SYMBOL_OPTION_MODE_EUROPEAN ou SYMBOL_OPTION_MODE_AMERICAN — dita qual modelo matemático o terminal usa para calcular os gregos e o preço teórico exibido no Market Watch. Errar a premissa aqui não é um bug de arredondamento; é uma falha estrutural na precificação de risco.
Na rotina diária, o desenvolvedor assume que o ativo segue o padrão da bolsa (geralmente europeu no Brasil para índices, americano para ações). O problema surge quando a corretora mapeia o contrato de forma errada ou quando o terminal não consegue distinguir a série específica. Você roda o EA, os gregos parecem coerentes, mas o Delta ignora a possibilidade de exercício antecipado antes de um dividendo gordo. Resultado: a hedge de delta neutro vira especulação direcional disfarçada.
O gargalo real não está no SymbolInfoInteger, mas na confiança cega no retorno dele. Corretoras brasileiras frequentemente ofertam apenas opções europeias no mercado de balcão, mas o ativo-objeto pode ter liquidez apenas no modelo americano sintético. Se o enum retorna 0 (Europeu) para um contrato que permite exercício antecipado por regra de negócio do emissor, sua árvore binomial roda em vão. A documentação oficial alerta que a propriedade é somente leitura, mas não avisa que a fonte do dado pode ser o contrato padrão da bolsa, não a série específica que você está operando.
é como tentar dirigir um carro manual sem saber onde fica a embreagem: você até entende a lógica do movimento, mas o sistema simplesmente não engata. A maioria dos desenvolvedores MQL5 migra do Forex, onde o símbolo é estático e linear. Quando entram no mercado de opções, a expectativa é que a função
SymbolInfoDouble resolva tudo, mas eles batem de frente com erros de “símbolo inválido” ou preços que não fazem sentido.
O problema real não está na lógica da estratégia, mas na forma como o terminal interpreta a natureza do ativo. Sem definir corretamente o modo da opção, o algoritmo não consegue distinguir entre a volatilidade de uma Call e a de uma Put, resultando em execuções erradas ou, pior, ordens rejeitadas pelo servidor da corretora. Para quem busca profissionalizar a automação, utilizar as ferramentas corretas de Domine a Precisão de Opções no MetaTrader 5
Pare de enfrentar erros de execução e otimize seus robôs com a sintaxe correta de derivativos.
Acessar Documentação e Ferramentas Oficiais
A Curva de Adaptação: Do Forex às Opções
A transição para o uso de ENUM_SYMBOL_OPTION_MODE revela um choque de realidade para o programador. No Forex, você lida com pares. Nas opções, você lida com contratos. A primeira barreira é entender que o símbolo da opção não é apenas um nome, mas um conjunto de propriedades que mudam conforme o modo selecionado.
A experiência prática mostra que a maioria dos iniciantes ignora a necessidade de validar se o símbolo suporta o modo de opção antes de solicitar dados. Isso gera o clássico erro de return 0 em funções de preço. A curva de aprendizado é íngreme porque a documentação oficial é técnica demais e pouco pragmática. Você não precisa de teoria acadêmica, precisa saber qual flag levantar para que o MT5 retorne o strike price correto.
Expectativa vs Realidade: Muitos acreditam que basta trocar o nome do ativo no SymbolSelect. A realidade é que, sem o modo de opção definido, o terminal trata a opção como um ativo comum, ignorando a data de expiração e a natureza do contrato (Call/Put), o que torna qualquer cálculo de Delta ou Gamma completamente inútil.
Desempenho Prático e Eficiência de Execução
Quando implementamos o ENUM_SYMBOL_OPTION_MODE corretamente, a eficiência do robô aumenta drasticamente. O sistema deixa de “tentar adivinhar” as propriedades do ativo e passa a solicitar exatamente o que precisa do servidor.
Em testes de estresse, a diferença de latência na recuperação de dados de opções é mínima, mas a estabilidade é brutalmente superior. Um código que não especifica o modo de opção tende a gerar mais requisições redundantes para tentar validar o símbolo, enquanto a implementação direta via ENUM reduz o overhead de processamento do Expert Advisor (EA).
| Abordagem | Estabilidade | Risco de Erro | Precisão de Dados |
|---|
| Símbolo Genérico | Baixa | Alto (Invalid Symbol)Implementação Prática e Execução ProgressivaO ENUM_SYMBOL_OPTION_MODE não é configuração de EA. É leitura de contrato. Você consulta, não define. A maioria erra tentando forçar valor em propriedade de só leitura. O terminal decide. Seu código reage. Primeiro passo: pare de adivinhar. Use SymbolInfoInteger(_Symbol, SYMBOL_OPTION_MODE) no OnInit. Guarde o retorno. É inteiro. Mapeia direto para a enum: SYMBOL_OPTION_MODE_EUROPEAN (0), SYMBOL_OPTION_MODE_AMERICAN (1). Binário. Simples. Perigoso se ignorado. Cronograma de Adaptação ao ENUM_SYMBOL_OPTION_MODE Fase 1 Leitura única no OnInit; validação de contrato antes de qualquer cálculo de Greeks. Fase 2 Monitoramento dinâmico em OnTick para detectar troca de série (rollover) ou split corporativo. Fase 3 Engine de precificação ramificada: árvore binomial para Americana, Black-Scholes fechado para Europeia. Configuração inicial exige saber o ativo. Opções sobre ações no Brasil (B3) são Americanas. Índice (WIN/OPTIONS) costuma ser Europeu. Forex options? Quase sempre Europeu. Cripto? Caos. Verifique a especificação do broker. Não confie no nome do símbolo. Confie no enum retornado. Rotina recomendada: logue o modo no Journal a cada nova sessão. Print("Option Mode: ", EnumToString((ENUM_SYMBOL_OPTION_MODE)mode)). Custa zero ciclos. Salva dias de debug quando o broker muda a especificação do contrato sem aviso. Acontece mais do que você imagina. Alerta de LógicaExercício Antecipado Quebra Modelo EuropeuSe o modo for AMERICAN, o valor intrínseco vira piso. Precificação Black-Scholes padrão subestima o prêmio. Use árvore binomial (Cox-Ross-Rubinstein) ou Leisen-Reimer. Erro comum: aplicar BS em put americana deep ITM com dividendo. Prejuízo garantido. Ferramentas necessárias: MetaEditor 5. Biblioteca padrão Math\Stat\Binomial.mqh ou implementação própria de árvore. Não reinvente a roda para Americana. Para Europeia, Math\Functions\MathNormalDistribution.mqh resolve CDF. Performance: cacheie d1, d2. Recalcule só se spot ou tempo mudarem beyond threshold. Aceleração de resultados: vetorize. ArrayCopy de strikes para buffer. Calcule IV em lote via Newton-Raphson paralelo (OpenCL se disponível). O enum dita o branch. switch(mode) fora do loop quente. Branch prediction do CPU agradece. Checklist de Validação de Contrato- [✓] Confirmar
SYMBOL_OPTION_MODE via SymbolInfoInteger antes de iniciar engine. - [✓] Verificar
SYMBOL_OPTION_RIGHT (Call/Put) e SYMBOL_OPTION_STRIKE para montar payoff correto. - [✓] Testar cenário de exercício antecipado (dividendo > custo de carry) no Strategy Tester modo “Every Tick”.
Dica: SYMBOL_TRADE_MODE igual a SYMBOL_TRADE_MODE_FULL não garante que a opção está negociável agora. Cheque SYMBOL_SESSION_DEALS e volume real.
Sinais de progresso: seu P&L de hedging delta-neutral para de sangrar theta nos finais de semana longos (Europeias) ou para de explodir em dividendos (Americanas). O enum é a chave mestra. Errar ele invalida todo o surface de volatilidade. Resumo do Aprendizado Sintese Operacional O que aprendemos na prática sobre o Como utilizar ENUM_SYMBOL_OPTION_MODE? 1. Ponto Forte Principal Leitura direta da regra de exercício evita modelagem errada; separa América de Europa em uma instrução. 2. Cuidados e Cuidados Propriedade de só leitura; muda no rollover; brokers obscuros podem reportar errado — valide no log. 3. Veredito de Aplicação Obrigatório para qualquer bot que precifique ou hedgie opções; inútil para quem só opera spot ou futuros puros. Relacionado |
