简介：面向MT4开发者的完整API技术文档包，系统覆盖DataFeedAPI、ManagerAPI与ReportAPI三大接口体系，适合需要开发EA、自定义插件、数据集成或后台管理工具的中高级交易平台开发者。资源共463个文件、约15.02MB，以C/C++头文件与源文件（h/cpp）、Visual Studio工程（vcproj/sln）、PDF说明文档及PHP调用示例为主，同时附带mtmanapi.dll与mtmanapi64.dll动态库，便于直接查阅和二次开发。已有6869人浏览学习。通过示例工程可快速掌握账户管理、订单操作、报表生成、数据订阅及风险统计等关键接口的调用方法，并了解不同版本库的兼容使用方式，是一份贴近实战的MT4二次开发参考资料。
1. MT4 API 完整开发文档：先搞清楚这份文档到底值不值得啃
MT4 的 API 开发文档，说白了就是 MQL4 语言参考手册加交易服务器接口说明。刚接触的人以为拿到文档就能写 EA，真正翻完才发现订单函数、价格引用、指标句柄这些细节全藏在注释和示例里，没人带着走一遍很容易卡壳。这份文档覆盖了从 OrderSend 到指标调用、文件读写、DLL 扩展的完整链路，适合两类人：一是刚从 MQL4 语法入门、准备写第一个自动交易程序的开发者，二是接手别人源码但排查不出逻辑问题、需要按 API 规范重审每一处函数调用的老手。我按实际开发顺序把它拆成六块，每一块都会给出能直接抄进编辑器的代码和容易翻车的边界。
2. 从 OrderSend 到订单生命周期：交易函数与参数边界
2.1 OrderSend 的参数玄学
OrderSend 是 MT4 里最核心的交易函数，文档里写得很简略，但实际调用时参数的顺序、类型和服务器规则一个都不能错。典型签名是：
int OrderSend( string symbol, // 交易品种 int cmd, // 订单类型：OP_BUY=0, OP_SELL=1, OP_BUYLIMIT=2, OP_SELLLIMIT=3, OP_BUYSTOP=4, OP_SELLSTOP=5 double volume, // 手数 double price, // 开仓价格 int slippage, // 最大滑点（单位：点） double stoploss, // 止损价 double takeprofit, // 止盈价 string comment, // 订单注释 int magic, // 魔法码，用来区分策略 datetime expiration, // 挂单过期时间，市价单填0 color arrow_color // 图表箭头颜色 );常见做法是先定义交易参数再调用，而不是把一堆数字堆在括号里：
double ask = MarketInfo("EURUSD", MODE_ASK); double bid = MarketInfo("EURUSD", MODE_BID); int ticket = OrderSend( "EURUSD", OP_BUY, 0.01, ask, 10, ask - 20 * _Point, ask + 40 * _Point, "demo buy", 20250101, 0, clrGreen );参数的坑集中在几个地方。price 必须用服务器认识的报价，EURUSD 买盘就是 ask，卖盘就是 bid，如果反了会被拒。slippage 的单位是点，不是货币单位，10 表示最多滑 10 个点。stoploss 和 takeprofit 对市价单是绝对价，对挂单是相对于挂单价的距离，文档里这点写得容易误解。magic 建议用当前日期的整型值，比如 20250101，这样回测和实盘统计时能按 magic 过滤订单。
还有一点：OrderSend 是异步的，它返回的 ticket 是服务器受理后的订单编号。如果返回 -1，必须马上用GetLastError()查错误码，常见的是 130（错误止损/止盈）、131（错误价格）、138（需重新报价）。我一般会封装一个带错误日志的下单函数，否则翻车时连哪儿错都不知道。
2.2 订单状态机与 OrderSelect 的坑
MT4 的订单不是即时更新的，必须显式调用 OrderSelect 才能把订单池里的记录索引到内存。订单池分“已平仓”和“未平仓/挂单”两种，OrderSelect(ticket, SELECT_BY_TICKET, MODE_TRADES)查当前持仓，MODE_HISTORY查历史。很多人一开始没搞明白：OrderSelect 返回 true 不代表选到的就是你想操作的那单，因为SELECT_BY_POS模式下传入的是池内序号，而池内顺序会随订单开平不断变化。
常见写法是遍历所有持仓：
for (int i = OrdersTotal() - 1; i >= 0; i--) { if (OrderSelect(i, SELECT_BY_POS, MODE_TRADES)) { if (OrderMagicNumber() == magic) { // 处理当前策略的订单 double openPrice = OrderOpenPrice(); double sl = OrderStopLoss(); } } }从后往前遍历是避免平仓后订单数量变化导致索引跳过的标准姿势。这里容易踩的坑是：OrderSelect(i, SELECT_BY_POS)成功后，如果紧接着调用另一个 OrderSelect 选区间的订单，之前的选中状态会被覆盖。所以需要同时操作多个订单时，先复制关键字段到本地变量，再切换订单池，别一直依赖 Order 系列函数读取。
2.3 用 Magic Number 管理多策略订单
Magic Number 是订单归属的身份证，回调测试和实盘统计都靠它。同一个 EA 里多个策略模板同时跑，如果 magic 混用，平仓逻辑会误伤别的策略的单子。我习惯在 EA 的 input 里直接暴露 magic：
input int MagicNumber = 20250101; input int MaxOrders = 5; input double LotSize = 0.01;然后在开仓和遍历平仓时统一用这个变量。还有一点，MT4 的策略测试器默认不按 magic 隔离，而是忽略 magic。所以回测时如果同一图表挂了多个 EA，结果会互相干扰。我一般会每次回测只挂一个 EA，或者在一个 EA 里按 magic 分成多个子策略，回测结果才可信。
文档里还提到 OrderTicket、OrderType、OrderLots 这些只读字段。实际开发中，修改订单用 OrderModify，只能改止损、止盈、挂单价，不能改手数和品种，这是交易服务器规则，API 层面也无法绕过。
3. 行情数据与指标调用：OnTick 之外的取数姿势
3.1 引用内置指标：iMA/iRSI 的句柄与复制
MQL4 调用内置指标有两种方式：一种是直接用iMA(symbol, timeframe, period, shift, method, price, bar)这种带输出值的写法，每调用一次就内部计算一次；另一种是用iMAHandle创建句柄，配合CopyBuffer批量取值。前者代码短但效率低，尤其在高频 tick 里反复调用会导致性能瓶颈。后者是文档推荐的高效姿势：
int maHandle = iMA("EURUSD", PERIOD_M15, 20, 0, MODE_SMA, PRICE_CLOSE); double maBuffer[]; ArraySetAsSeries(maBuffer, true); int copied = CopyBuffer(maHandle, 0, 0, 100, maBuffer); if (copied > 0) { double currentMA = maBuffer[0]; // 当前K线对应的值 }这里的坑是：CopyBuffer 的返回值和数组对齐方向。MT4 默认数组索引 0 是最近时间还是最远时间，取决于 ArraySetAsSeries。如果不设置，buffer[0] 是最早的数据，很多新手误以为 [0] 是当前值，导致信号错位。设置成ArraySetAsSeries(maBuffer, true)后，buffer[0] 才是当前 K 线。
指标句柄创建后不会自动更新，需要在 OnTick 里重新 CopyBuffer。另外 iMAHandle 本身不区分货币对大小写，但 symbol 字符串必须精确匹配图表品种，比如 "EURUSD" 和 "eurusd" 会被识别为不同品种而返回无效句柄。
3.2 跨周期取数据的典型写法
EA 在 M5 图表上运行，但要依赖 H1 的均线信号，这个需求在文档里没有直接范例，需要组合 iCustom 或 iMA 指定时间段。最直接的方式：
double h1MA = iMA(NULL, PERIOD_H1, 20, 0, MODE_SMA, PRICE_CLOSE, 1);注意最后一个参数 bar，1 表示往前数一根已完成 K 线。这里容易翻车：如果不指明 bar，默认当前这根 K 线是未收盘的，它的值会随行情跳动而改变，回测和实盘不一致。所有跨周期信号引用，我都建议强制使用shift >= 1甚至shift >= 2，避开正在形成的K线。
另一个跨周期取历史数据的方式是iBarShift，把时间戳转换成指定周期的K线序号：
datetime targetTime = iTime(NULL, PERIOD_H1, 1); int shiftOnM5 = iBarShift(NULL, PERIOD_M5, targetTime, false);iBarShift 是同步 K 线的桥梁。它的第四个参数 exact 设为 false 表示找不到精确时间时返回离目标最近的一根，设为 true 则严格要求存在对应 K 线。不同经纪商的 K 线开盘时间戳可能有几秒偏差，我一般用 false 并接受轻微偏差，避免返回 -1 导致程序越界。
3.3 自定义指标脚本的接入与性能
文档里自定义指标文件放在MQL4/Indicators，EA 里用iCustom调用：
double myValue = iCustom(NULL, 0, "MyIndicator", param1, param2, 0, 1);参数顺序必须和指标源码的 input 变量顺序一致，多得一个不少，少一个也不行。很多指标打包过来没有源码，只有 ex4，这时没法确认内部 input 顺序，只能靠文档或黑盒测试。我遇到这种事，会在小号测试账户上挂一个 EA 轮询 iCustom，把不同参数组合的输出打印到日志，找出能输出非零值的那组参数，再固化下来。
iCustom 的性能瓶颈在于每次调用都会重新计算整个指标缓冲区。如果指标计算复杂，tick 密集时回测会慢好几倍。替代方案是把指标逻辑用原生 MQL4 写到 EA 里，或者只在开盘第一根 tick 计算一次，用Volume[0] == 1这类条件做开关。我自己常用的是后者，比如只在新的 M15 K线生成时更新指标缓存，避免每个 tick 都重复算。
4. 把文档变成可运行 EA：完整代码骨架与编译验证
4.1 EA 骨架：init/deinit/tick 三段式
MQL4 EA 最少要有 init、deinit、start（老版本）或 OnTick（新版本）三个函数。文档里推荐用 OnTick，因为 start 已经被逐步淘汰。标准骨架：
#property strict extern double Lots = 0.01; extern int StopLoss = 30; extern int TakeProfit = 60; int init() { Print("EA 初始化"); return 0; } int deinit() { Print("EA 卸载"); return 0; } void OnTick() { if (IsNewBar()) { CheckForTrade(); } } bool IsNewBar() { static datetime lastBarTime = 0; datetime curTime = iTime(NULL, 0, 0); if (lastBarTime != curTime) { lastBarTime = curTime; return true; } return false; }这里的逻辑是：init 里做一次性资源初始化，比如创建指标句柄、读取设置文件；deinit 里释放句柄；OnTick 里用 IsNewBar 控制每个 K 线只运行一次主逻辑，避免在同一个 K 线内重复开平仓。IsNewBar 的 static 变量跨 tick 保持，是控制频率最便宜的方法。
init/deinit 的返回值类型必须匹配，否则编译器警告。早期版本 init 返回 int，deinit 返回 int，新版本可以写void OnTick但 init/deinit 保持原样。文档里没有明确说 init 失败时如何阻止 EA 启动，我的做法是在 init 里判断合约数字格式等条件，不满足就return(FAIL)，让 EA 无法加载，比在 OnTick 里反复打印错误更干净。
4.2 参数优化与输入变量列表
EA 的输入参数用 extern 或 input 定义。extern 和 input 的差异在于是否支持策略测试器的优化功能。input 是 MQL4 新标准：
input group "交易设置" input double InitLots = 0.01; input int MaxTrades = 3; input group "移动止损" input bool UseTrailing = true; input int TrailStart = 20; input int TrailStep = 5;group 是 MQL4 后来加的注释性分组，不是所有编译器版本都支持，旧编译器遇到会报错。参数命名建议带类型前缀，InitLots、MaxTrades 这样回测时看报告一目了然。参数能被优化的前提是它属于 int、double、bool 或 datetime，string 不能参与优化。
在策略测试器里，勾选“优化”后，MT4 会按步长遍历参数组合。这里关键的坑是：优化结果里浮点数的步长不能太小，否则组合数量爆炸，一个 5 年的 M15 回测要跑几十个小时。我一般先把参数步长设成较大的倍数跑一轮粗糙优化，确定热区后再缩小步长二次优化。还有，每次优化时点“全部”而不是“最好”，否则测试器只给你最优参数，看不到参数的稳定性分布。
4.3 编译、历史回测与实盘前置检查
在 MetaEditor 里按 F7 编译，零警告零错误也不代表策略可上实盘。文档强调要在策略测试器里先跑一遍“控制点”测试：用固定点差模式、开仓手续费设置为零、滑点为 0，这样能把交易逻辑和成交成本剥离开。回测结果里必须看几个关键列：总净利润、最大回撤、获利因子、平均盈利/亏损比、最大连续亏损次数。
一个容易忽略的检查项是“每笔最大亏损”是否远小于账户余额的 5%~10%。如果某次回测里出现单笔亏损超过总权益 20%，说明仓位管理或硬止损缺失，这种 EA 实盘前必须改。另一个检查是回测与实盘数据偏差：回测用的是历史固定点差，实盘点差会波动，滑点也会吃掉利润。我会用实际账户过去三个月的平均点差加上 20% 缓冲，重新估算盈亏比。
实盘前置检查我习惯列一个清单：品种的最小手数和步进手数是否匹配参数；止损距离是否满足经纪商最小距离；服务器时区与 K 线时间戳是否一致；VPS 环境是否允许 DLL 调用。这些都过了，再拿最小手数跑三天模拟盘，观察 EA 是否有网络重连、订单拒单等只在实盘出现的意外。
5. 避坑指南：MQL4 开发中我踩过的五个坑
5.1 浮点比较与 Price Level 校验
现象：EA 判断 1.20000 和 1.19999 是否相等，用==直接比较，结果逻辑时对时错。
原因：MT4 报价是浮点数，1.2 在二进制里是无限循环小数，浮点运算会产生微小误差，直接相等比较不稳定。
解决：用NormalizeDouble处理价格和手数，保持与 broker 小数点一致后再比较：
double ask = MarketInfo("EURUSD", MODE_ASK); double stopLoss = NormalizeDouble(ask - 20 * _Point, _Digits); if (stopLoss > 0 && stopLoss != ask) { // 这里仍不适合直接比较更可靠的是比较最小价差：
if (MathAbs(price1 - price2) < _Point / 2) { // 视为相等 }从那以后我所有价格比较都加上了基于_Point的容差，再也没出现过因为精度问题导致的重复开仓。
5.2 止损/止盈价格被服务端拒收
现象：OrderSend 返回 -1，GetLastError 返回 130。单子没开出去，但程序里价格算得正正好好。
原因：止损距离小于经纪商要求的最小止损距离，或者止损价超出了当前报价的合理范围。很多斩仓商要求止损距离至少 20 点，你设 5 点就会被拒。
解决：开仓前先查询经纪商的最小止损距离，没有直接 API 时用 MarketInfo 的 MODE_STOPLEVEL：
int stopLevel = MarketInfo("EURUSD", MODE_STOPLEVEL); double minDist = stopLevel * _Point; if (mathAbs(ask - stopLoss) < minDist) { stopLoss = ask - minDist - 1 * _Point; }还要注意预付款货币与账户货币不一致时，止损距离换算可能出错，优先用经纪商给的 STOPLEVEL，别自己拍脑袋写死 20 点。
5.3 循环中 OrderModify 与无限递归
现象：EA 卡死或出现大量重复订单，日志显示 OrderModify 被连续执行成百上千次。
原因：OrderModify 成功后，订单池数据变化，触发 OnTick 再次进入，如果修改条件仍然满足，就形成了自我触发循环。常见于移动止损逻辑：价格每次跳动都回调一次止损，回调判断没加上次修改值做门槛。
解决：每次修改前记录当前止损，只有新止损与旧止损差大于一个阈值才修改：
double currentSL = OrderStopLoss(); double newSL = NormalizeDouble(ask - 20 * _Point, _Digits); if (MathAbs(newSL - currentSL) > _Point) { OrderModify(ticket, OrderOpenPrice(), newSL, OrderTakeProfit(), 0, clrRed); }加上这个判断后，循环逻辑从“每次满足都执行”变成“变化达到阈值才执行”，递归问题就消失了。
5.4 历史数据缺失导致回测结果偏乐观
现象：回测报告显示 10 年盈利 500%，但实盘一周就亏损。
原因：测试器下载的历史数据可能缺少大波动的分钟级行情，或者经纪商历史点差极低。回测里止损没有被触发，实际行情跳空直接打穿止损。
解决：在回测前强制更新全部历史数据，查看数据覆盖度。回测后做一次“最差情况压力测试”，把点差人为调高到平时的 3 倍，滑点调大到 50 点，再看止损表现。你能同时加载多周期数据就用多周期，不然只跑 M1 通常不够。
5.5 DLL 调用权限与 32 位指针
现象：调用外部 DLL 时 EA 直接崩溃，或者返回一堆乱码字符串。
原因：MT4 是 32 位程序，DLL 必须编译成 32 位。如果 DLL 是 64 位，直接无法加载。另一个坑是传入字符串时，需要按 MT4 的string结构，不能直接传 C 风格 char*，否则内存越界。
解决：DLL 接口用匹配 32 位的调用约定，并在 MT4 设置里勾选“允许导入 DLL”，字符串传递用StringToCharArray转成数组再传：
int dllResult = MyDll_Process(dataBuffer, ArraySize(dataBuffer));DLL 出错没有日志很难排查，我会先在 DLL 里写一个简单的版本号函数确认能调用，再加业务逻辑。能从文档里读到的规矩是：DLL 路径要放在MQL4/Libraries，否则每次都要填绝对路径，换电脑就崩。
6. 进阶：日志、文件输出与外部系统对接
6.1 日志分级与 Print/PrintFormat
调试阶段最怕 Print 刷屏。我一般分三个级别：基础信息用 Print，关键交易动作用 PrintFormat 带结构化字段，严重错误用Alert配合GetLastError。例如：
PrintFormat("Order %d op=%d lots=%.2f price=%.5f", ticket, orderType, lots, price);日志时间戳默认为服务器时间，回测时如果你想对齐本地时间，要自己转换。日志只能写入测试器报告里，实盘日志在MQL4/Logs，按日期滚动。文件会越来越大，定期清理是习惯，不是可选项。
6.2 文件写入与读取的路径规范
文档规定文件操作只能访问MQL4/Files目录下的子目录，越界会返回 false。用FileOpen时注意指定文件模式和编码：
int handle = FileOpen("signals.csv", FILE_WRITE|FILE_CSV|FILE_ANSI, ';'); if (handle != INVALID_HANDLE) { FileWrite(handle, TimeToString(TimeCurrent(), TIME_DATE|TIME_SECONDS), symbol, price); FileClose(handle); }CSV 的分隔符在终端里和编辑器里可能不一致，建议固定用分号，避免 Excel 打开串列。读完文件要 FileSeek 复位，或直接 FileClose 重新打开。文件句柄不关闭，EA 卸载后文件还是被锁着，后续 EA 再次打开会失败。
6.3 把 EA 信号转发到外部程序
外部对接有几种方式：写文件、数据库、网络 socket。文档本身不覆盖网络库，但常见做法是用 WinAPI 或 C++ DLL 做 socket 转发。最简单可靠的是文件监控：EA 每次开平仓把信号写成 JSON 或 CSV 文件，外部 Python 程序定时读取。注意 EA 写文件频率不要过高，一个 tick 写一次会把硬盘搞崩。我会用一个 static datetime 记录最后写入时间，同一秒内只写一次，减少 IO。
也可以用 MT4 自带的TimeCurrent和OrderSelect组合，在每次 K 线收盘后把那一秒的持仓状态输出成一行，这样外部程序同步处理时数据不会重复。
6.4 策略测试器里调试的额外技巧
最后提一个测试器里最容易忽视的技巧：把可视化模式打开，勾选“买入/卖出箭头”。很多逻辑错误在图表上一眼就能看出，比如信号开仓的位置比实际 K 线晚了一根。这时用TextSet或者开仓时OrderSend的注释带上当前时间，能快速定位。我知道不少开发者从不用可视化，只盯着报告里的曲线，那是拿黑匣子猜行为，效率太低。从那以后我每次写完新策略，强制自己先跑一遍可视化回测，再跑优化参数，最后才上实盘小仓位验证。希望这些过程对你填平文档之外的沟壑有帮助。
本文还有配套的精品资源，点击获取
