CGoldSymbol - find the broker's gold and size the position correctly on it - MetaTrader 5程序库

黄金是经纪商之间几乎没有任何共识的交易品种。其交易代码可能是XAUUSD、GOLD、XAUUSD.m、XAUUSDpro或GOLD#。一份合约的规模可能是100盎司、10盎司，也可能是1盎司。价格可能显示两位数，也可能显示三位数。 一个根据硬编码的“100盎司、两位数”来计算手数的EA，在另一家经纪商处运行时，并非只是略有偏差——而是会出现十倍的误差，且这种误差会导致账户资金被清空。

本类通过查询交易终端而非直接假设来确定合约规格。

检测机制。 Detect() 方法会遍历账户提供的所有交易符号并对名称进行评分，因此 XAUUSD 的优先级高于 XAUUSD.m，而 XAUUSD.m 又高于不完全匹配的名称；同时，白银、铂金和钯金会被直接排除——在搜索黄金时，XAGUSD 绝不能被选中。已存在于“市场观察”窗口中的交易符号会获得少量加分。 如果您的经纪商使用了一些非标准名称，Attach("YOURNAME") 会跳过搜索。

规格说明。 ContractSize()、Digits()、Point()、TickSize()、TickValueLoss()、MinLot()、MaxLot()、LotStep()、StopsLevel() 和 FreezeLevel() 直接取自该交易符号在交易终端中的数据。

资金。 LossForDistance(lots, distance) 表示价格不利变动所造成的损失（以账户货币计）。LotForRisk(riskMoney, distance) 则是其反向计算，也是真正重要的函数： 该函数通过 SYMBOL_TRADE_TICK_VALUE_LOSS 进行转换，因此无论面对 10 盎司合约还是以欧元计价的账户，计算结果均保持准确；随后将结果向下取整至经纪商的交易量步长，并限制在该经纪商的最小和最大交易量范围内。 当即使是最小的交易量所承担的风险也超过了允许范围时，该函数会返回零，而非默认返回最小手数——这是大多数仓位计算代码因向上取整而处理错误的情况。

诊断功能。 Attach() 会收集以下警告：合约规模非 100、位数异常、终端报告的点值为零，以及止损位非零。PrintReport() 会打印包含示例计算的完整规范，这通常是查明策略在两家经纪商上表现不同的原因最快捷的方式。

在一个使用100盎司合约、欧元账户且止损点位为1500点的实盘账户中，10 000欧元的1%计算结果为0.07手，对应风险为90.42欧元。 同样的计算，若采用10盎司合约，结果为0.70手；若采用1盎司合约，则为7.00手。风险相同，止损位相同，但交易量却相差百倍——这正是硬编码常量所导致的错误。

该软件包包含 GoldSymbolDemo.mq5 脚本，该脚本可检测黄金符号、打印报告，并将账户余额的百分比转换为不同止损距离下的手数。在任何图表上运行该脚本，即可了解您所用经纪商的黄金合约究竟是什么。

该类不会开立任何交易，也不会修改任何持仓。它仅用于解答疑问。