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

El oro es el instrumento sobre el que los brókers no se ponen de acuerdo prácticamente en nada. El símbolo puede ser XAUUSD, GOLD, XAUUSD.m, XAUUSDpro o GOLD#. Un contrato puede equivaler a 100 onzas, a 10 o a una sola. El precio puede tener dos o tres dígitos. Un EA que calcula el tamaño de su lote a partir de un valor fijo programado de «100 onzas, dos dígitos» no solo se equivoca ligeramente con el siguiente bróker, sino que se equivoca por un factor de diez, en la dirección que vacía la cuenta.

Esta clase consulta a la plataforma en lugar de dar nada por sentado.

Detección. Detect() recorre todos los símbolos que ofrece la cuenta y puntúa los nombres, de modo que XAUUSD prevalece sobre XAUUSD.m, que a su vez prevalece sobre una coincidencia aproximada, mientras que la plata, el platino y el paladio se excluyen directamente: XAGUSD nunca debe aparecer en una búsqueda de oro. Un símbolo que ya se encuentre en «Market Watch» obtiene una pequeña bonificación. Si tu bróker utiliza algo inusual, Attach("TU NOMBRE") omite la búsqueda.

Especificaciones. ContractSize(), Digits(), Point(), TickSize(), TickValueLoss(), MinLot(), MaxLot(), LotStep(), StopsLevel() y FreezeLevel() proceden directamente de la plataforma para ese símbolo.

Dinero. LossForDistance(lots, distance) indica cuánto cuesta un movimiento en tu contra en la divisa de la cuenta. LotForRisk(riskMoney, distance) es lo contrario y lo que realmente importa: realiza la conversión a través de SYMBOL_TRADE_TICK_VALUE_LOSS, por lo que el resultado es correcto tanto para un contrato de 10 onzas como para una cuenta denominada en euros, y luego redondea el resultado a la baja al paso de volumen del bróker y dentro de sus límites mínimo y máximo. Devuelve cero en lugar de un lote mínimo implícito cuando incluso el volumen más pequeño supondría un riesgo superior al permitido, un caso en el que la mayoría de los códigos de cálculo de tamaño se equivocan al redondear al alza.

Diagnósticos. Attach() recoge advertencias en caso de que el tamaño del contrato no sea 100, haya un número inusual de dígitos, el terminal informe de un valor de tick igual a cero o el nivel de stop sea distinto de cero. PrintReport() muestra toda la especificación con un ejemplo práctico, lo que suele ser la forma más rápida de averiguar por qué una estrategia se comporta de forma diferente en dos brókers.

En una cuenta real con un contrato de 100 onzas, un saldo en euros y un stop de 1.500 puntos, el 1 % de 10.000 EUR equivale a 0,07 lotes, lo que supone un riesgo de 90,42 EUR. La misma operación de compra en un contrato de 10 onzas da como resultado 0,70 lotes, y en un contrato de una onza, 7,00 lotes. Mismo riesgo, mismo stop, una diferencia de cien veces en el volumen: eso es precisamente lo que falla con una constante codificada de forma rígida.

El paquete incluye GoldSymbolDemo.mq5, un script que detecta el símbolo del oro, genera el informe y convierte un porcentaje del saldo en un tamaño de lote para varias distancias de stop. Ejecútalo en cualquier gráfico para ver cuál es realmente el oro de tu propio bróker.

La clase no abre operaciones ni modifica posiciones. Solo responde a preguntas.