折腾了快两年量化，从最开始拿Python裸调MT5的API，到后来各种SDK换来换去，现在回头看，很多弯路其实都是因为没把文档吃透。尤其是做EA回测和实盘对接的时候，API的坑比策略逻辑本身还多。今天不聊行情，就纯从工具角度，把我自己用过的几套API文档和SDK资源捋一遍，给还在踩坑的汇友一个参考。
先说最基础的，MetaTrader自带的Python包，MetaTrader5这个库。官方文档其实写得挺全，但有个问题——它只覆盖了Python，而且函数命名跟MQL5的习惯差挺多。比如copy_rates_from_pos，参数顺序跟MQL5的CopyRates完全反过来，我一开始老搞混。而且它没有异步支持，回测数据量大了以后，拉日线数据能卡到怀疑人生。不过胜在零依赖，装个pip就能用，适合快速验证想法。我一般拿它做盘中数据快照，但跑全量历史回测基本不用它。
后来换到一个第三方封装的SDK，叫MT5LinuxBridge，这个是真救了命。它把MQL5的复杂逻辑封装成RESTful API，直接跑在VPS上，Python这边用requests就能调。最大的好处是支持多账户并行，我同时跑三个策略账户，每个账户独立拉数据下订单，延迟比官方Python包低不少。但缺点也明显——文档写得稀碎，很多参数得自己试，社区讨论也不多，出了问题只能翻源码。我印象最深的是它有个坑，订单类型映射跟MT5原生对不上，限价单传错数字会变成市价单，我实盘吃过一次亏，后来干脆在代码里加了层校验。
再说说专门的指标计算库，TA-Lib配MT5数据源这个组合。TA-Lib本身不是MT5专用的，但配合前面说的数据接口，能直接算RSI、MACD这些，速度比MT5内置指标快一个量级。不过它的文档偏学术，没有针对外汇市场的场景化示例，你得自己把数据格式对齐。比如它默认输入的是OHLCV数组，但MT5返回的是带时间戳的元组，得自己拆。适合做复杂策略的因子挖掘，但如果你只是写个简单均线交叉，真没必要上这个。
最后提一下官方MQL5的Market Watch API文档，这个很多人忽略。其实它不只是给MQL5用的，里面关于订单状态机、市场深度更新的描述，对做任何语言对接都有参考价值。我后来调试Python下单逻辑，很多边界情况都是翻这个文档才想明白的。缺点是纯英文，而且术语偏底层，新手看着头大。
适用场景我总结下：
注意事项方面，我踩过的坑是——任何第三方SDK，先小仓位跑一周实盘模拟，别直接上真钱。另外API文档一定要保存版本快照，因为MT5更新频繁，我遇到过库更新后函数签名变了，老代码直接跑崩的情况。还有就是VPS的时区设置，MT5的服务器时间跟本地时间差好几个小时，如果API调用带时间参数，务必统一用UTC，不然历史数据会错位。
不知道你们现在用的是哪套方案？有没有碰到过订单类型映射出错或者数据对齐的问题？可以交流下，我最近在琢磨怎么把回测和实盘的数据流彻底分开，避免策略漂移。
先说最基础的，MetaTrader自带的Python包，MetaTrader5这个库。官方文档其实写得挺全，但有个问题——它只覆盖了Python，而且函数命名跟MQL5的习惯差挺多。比如copy_rates_from_pos，参数顺序跟MQL5的CopyRates完全反过来，我一开始老搞混。而且它没有异步支持，回测数据量大了以后，拉日线数据能卡到怀疑人生。不过胜在零依赖，装个pip就能用，适合快速验证想法。我一般拿它做盘中数据快照，但跑全量历史回测基本不用它。
后来换到一个第三方封装的SDK，叫MT5LinuxBridge，这个是真救了命。它把MQL5的复杂逻辑封装成RESTful API，直接跑在VPS上，Python这边用requests就能调。最大的好处是支持多账户并行，我同时跑三个策略账户，每个账户独立拉数据下订单，延迟比官方Python包低不少。但缺点也明显——文档写得稀碎，很多参数得自己试，社区讨论也不多，出了问题只能翻源码。我印象最深的是它有个坑，订单类型映射跟MT5原生对不上，限价单传错数字会变成市价单，我实盘吃过一次亏，后来干脆在代码里加了层校验。
再说说专门的指标计算库，TA-Lib配MT5数据源这个组合。TA-Lib本身不是MT5专用的，但配合前面说的数据接口，能直接算RSI、MACD这些，速度比MT5内置指标快一个量级。不过它的文档偏学术，没有针对外汇市场的场景化示例，你得自己把数据格式对齐。比如它默认输入的是OHLCV数组，但MT5返回的是带时间戳的元组，得自己拆。适合做复杂策略的因子挖掘，但如果你只是写个简单均线交叉，真没必要上这个。
最后提一下官方MQL5的Market Watch API文档，这个很多人忽略。其实它不只是给MQL5用的，里面关于订单状态机、市场深度更新的描述，对做任何语言对接都有参考价值。我后来调试Python下单逻辑，很多边界情况都是翻这个文档才想明白的。缺点是纯英文，而且术语偏底层，新手看着头大。
适用场景我总结下：
- 官方MetaTrader5包：轻量级数据抓取、策略原型验证，别指望它扛高并发
- MT5LinuxBridge：多账户部署、VPS常驻运行、需要低延迟下单的场景
- TA-Lib组合：高频因子计算、自定义指标研发，但别用于实盘信号生成，容易有数据对齐bug
注意事项方面，我踩过的坑是——任何第三方SDK，先小仓位跑一周实盘模拟，别直接上真钱。另外API文档一定要保存版本快照，因为MT5更新频繁，我遇到过库更新后函数签名变了，老代码直接跑崩的情况。还有就是VPS的时区设置，MT5的服务器时间跟本地时间差好几个小时，如果API调用带时间参数，务必统一用UTC，不然历史数据会错位。
不知道你们现在用的是哪套方案？有没有碰到过订单类型映射出错或者数据对齐的问题？可以交流下，我最近在琢磨怎么把回测和实盘的数据流彻底分开，避免策略漂移。