CGoldSymbol - find the broker's gold and size the position correctly on it - biblioteca para MetaTrader 5

O ouro é o instrumento sobre o qual as corretoras quase não chegam a um consenso. O símbolo pode ser XAUUSD, GOLD, XAUUSD.m, XAUUSDpro ou GOLD#. Um contrato pode corresponder a 100 onças, a 10 ou a uma. O preço pode ter duas ou três casas decimais. Um EA que calcula o tamanho do lote com base em uma configuração fixa de “100 onças, dois dígitos” não está apenas um pouco errado na corretora seguinte — ele está errado por um fator de dez, na direção que esvazia a conta.

Essa classe consulta o terminal em vez de fazer suposições.

Detecção. O Detect() percorre todos os símbolos oferecidos pela conta e classifica os nomes; assim, XAUUSD tem prioridade sobre XAUUSD.m, que tem prioridade sobre uma correspondência aproximada, enquanto prata, platina e paládio são excluídos de imediato — XAGUSD nunca deve ser priorizado em uma busca por ouro. Um símbolo que já esteja no Market Watch recebe um pequeno bônus. Se sua corretora usar algo incomum, Attach("YOURNAME") ignora a busca.

Especificação. ContractSize(), Digits(), Point(), TickSize(), TickValueLoss(), MinLot(), MaxLot(), LotStep(), StopsLevel() e FreezeLevel() vêm diretamente do terminal para esse símbolo.

Dinheiro. LossForDistance(lots, distance) indica quanto custa um movimento desfavorável a você na moeda da conta. LotForRisk(riskMoney, distance) é o inverso e o que realmente importa: ela faz a conversão por meio de SYMBOL_TRADE_TICK_VALUE_LOSS, de modo que permanece correta tanto para um contrato de 10 onças quanto para uma conta denominada em euros; em seguida, arredonda o resultado para baixo, de acordo com o passo de volume da corretora e dentro de seus valores mínimo e máximo. Ela retorna zero em vez de um lote mínimo implícito quando até mesmo o menor volume representaria um risco maior do que o permitido — um caso em que a maioria dos códigos de dimensionamento erra ao arredondar para cima.

Diagnósticos. O Attach() coleta avisos para um tamanho de contrato que não seja 100, um número incomum de dígitos, um valor de tick que o terminal reporta como zero e um nível de stop diferente de zero. O PrintReport() imprime toda a especificação com um exemplo prático, o que geralmente é a maneira mais rápida de descobrir por que uma estratégia se comporta de maneira diferente em duas corretoras.

Em uma conta real com um contrato de 100 onças, um saldo em euros e um stop de 1.500 pontos, 1% de 10.000 EUR resulta em 0,07 lotes, arriscando 90,42 EUR. A mesma operação de compra em um contrato de 10 onças resulta em 0,70 lotes, e em um contrato de uma onça, 7,00 lotes. Mesmo risco, mesmo stop, uma diferença de cem vezes no volume — que é exatamente o que uma constante codificada fixamente erra.

O pacote inclui o GoldSymbolDemo.mq5, um script que detecta o símbolo do ouro, gera o relatório e converte uma porcentagem do saldo em tamanho de lote para várias distâncias de stop. Execute-o em qualquer gráfico para ver como realmente funciona o ouro da sua corretora.

A classe não abre nenhuma operação nem modifica nenhuma posição. Ela apenas responde a perguntas.