MetaTrader 5 Web API 是 MetaQuotes 提供的服务器端接口,用于将 MT5 交易服务器与网站、CRM 及公司其他系统连接。应用程序以 Manager 账户登录,可管理用户、余额、客户组、交易品种、订单、持仓、成交、报价和图表。它不负责连接流动性提供商,也不推送 LP 订单簿,这些属于其他 MT5 API 的职责。
MetaTrader 5 Web API 是什么?
MetaTrader 5 Web API 是 MetaQuotes 提供的接口,用于把 MT5 交易服务器与经纪商自己的 Web 服务连接起来:客户中心、CRM、支付处理、报表和定制交易前端。它对接的是服务器,而不是交易者的终端;身份验证时使用的是 Manager 账户,也就是您的后台员工在 MT5 Manager 终端里使用的那类账户。
MetaQuotes 自己给出的定义只有一句话,但很准确:Web API 用于与 Web 资源和公司其他服务集成。本页其余内容讲的都是这句话在实际中意味着什么。完整的技术参考文档放在 MetaQuotes 的支持网站上,牌照持有方登录后可以查看;如果您持有 MT5 服务器牌照,或在持牌公司工作,请以该文档为准,而非本页内容。
“Web API 用于平台与 Web 资源及公司其他服务的集成。”
Web API 与其他 MetaTrader 5 API 有什么不同?
MetaQuotes 为 MT5 公布了五种 API,各有分工。Web API 是从外部通过网络与服务器通信的那一个;其他几种要么在服务器内部运行,要么把服务器连接到市场,要么扩展服务器报表。第二列的定义引自 MetaQuotes 的经纪商页面。
| API | MetaQuotes 的定义 | 您的代码在哪里运行 | 经纪商的典型用途 |
|---|---|---|---|
| Web API | “用于平台与 Web 资源及公司其他服务的集成” | 您自己的服务器,通过网络连接 | CRM、客户中心、支付、定制 WebTrader |
| Manager API | “可用于开发定制的管理和运营工具,甚至您自己的 Manager 终端” | 连接到服务器的 Manager 应用程序 | 后台工具、交易部和风控工具 |
| Server API | “可帮助您为 MetaTrader 5 交易服务器和 MetaTrader 5 历史服务器增加更多功能” | 以插件形式运行在 MT5 服务器内部 | 针对每笔交易的定制规则、赠金、跟单逻辑 |
| Gateway API | “用于将 MetaTrader 5 与其他交易系统集成,以及创建定制数据源” | 挂接在平台上的网关 | 流动性提供商、交易所、数据源 |
| Report API | “扩展 MetaTrader 5 交易服务器生成的报表” | 在报表组件内部 | 定制的监管报表和管理报表 |
MT5 Web API 是 REST 还是 WebSocket?
MT5 Web API 是“请求—响应”模式:您的应用发送命令,然后等待答复。在当前版本中,这意味着向 /api/user/get 或 /api/tick/last 这类路径发送 HTTPS 请求并获得 JSON 响应;此外还有一种较早的二进制协议,通过持久连接的 socket 通信,MetaQuotes 自己的示例代码用的就是它。这两种我们都在用,分别承担不同的工作。
它不是 WebSocket API。Web API 不会主动把价格或持仓变化推送给您;如果需要实时更新,就得按您选定的频率去请求。如果您看到某家服务商说“MT5 Web API 基于 WebSocket”,通常意思是他们在上面另外搭了一层 WebSocket,这正是我们为品牌 WebTrader 所做的。
还有一个容易混淆的地方,最好尽早厘清。有些服务出售所谓的“MT5 API”,通过运行在其云端的终端,或通过 MetaQuotes 为桌面终端提供的 Python 包,连接到交易者的账户。这些是面向交易者和信号服务的账户级工具。Web API 则是经纪商级的:Manager 有权查看的服务器上所有账户,它都能看到。
MT5 Web API 的身份验证如何运作?
您的应用以 MT5 Manager 身份通过“挑战—应答”机制完成验证,因此 Manager 密码永远不会以明文传输。在我们使用的 HTTPS 方式下,需要两次调用:
- 发起应用以其 Manager 登录名调用验证发起命令,声明自己是 Web API 客户端。服务器返回一个随机挑战值。
- 应答应用把密码哈希与该挑战值组合后发送结果,同时附上自己生成的随机挑战值。
- 验证服务器服务器对客户端的挑战值作出应答,应用检查该应答,这样双方都证明了自己知道密码。
- 保持会话验证通过的会话与底层连接绑定。连接断开后需要重新验证。
用 MetaTrader 5 Web API 可以构建什么?
经纪商需要的几乎所有面向客户的系统都可以基于 Web API 构建,因为它能访问这些系统关心的对象:用户、账户、客户组、交易品种、订单、持仓、成交和历史价格。下表列出了我们使用的命令类别及其用途。
| 类别 | 涵盖内容 | 典型用途 |
|---|---|---|
| 用户与账户 | 创建、更新、删除和读取账户;校验或修改密码;读取余额、净值和保证金 | CRM 中完成 KYC 后开户、重置密码、客户中心仪表盘 |
| 余额操作 | 账户的入金、出金、信用额度和调整 | 银行卡或银行入金自动入账 |
| 客户组与交易品种 | 读取和维护客户组及交易品种设置 | 在前端正确显示合约规格、保证金和交易时段 |
| 订单、持仓、成交、历史 | 当前和历史交易数据,包括针对多个账户的批量查询 | 交易历史、对账单、IB 佣金计算 |
| 价格与图表 | 最新报价、报价统计、报价历史和图表 K 线 | WebTrader 或移动应用中的报价和图表 |
| 交易请求 | 代表账户在服务器上执行的请求,附带结果代码 | 在定制前端下单、改单和平仓 |
| 邮件与新闻 | 发送到终端的内部邮件和新闻 | 向客户发送服务消息 |
MT5 Web API 不能做什么?
Web API 无法把您的服务器连接到流动性,无法在服务器内部运行代码,也无法向您推送数据。这些限制是有意为之:每项工作都有对应的其他 MetaTrader 5 API。
- 不提供流动性连接。来自银行或 prime-of-prime 服务商的报价通过网关、流动性桥接或 Ultency 接入,详见 MT5 Gateway API 和流动性集成页面。
- 不提供 LP 订单簿或市场深度。Web API 提供每个交易品种的最新报价和统计数据,但不会推送来自您流动性提供商的聚合订单簿,因此基于 Web API 的前端只显示买价和卖价,没有市场深度阶梯。
- 不能在服务器内部运行逻辑。必须在每笔交易执行前生效的规则,需要 Server API 插件。Web API 应用只能看到已经发生的事情。
- 不支持推送。每次更新都是一次请求;实时报价和持仓意味着要按您选定、且服务器能承受的频率轮询。
- 不能定制服务器报表。扩展交易服务器自身生成的报表是 Report API 的职责。
FXUP 如何用 MT5 Web API 支撑 WebTrader?
我们的 WebTrader 和移动应用从不直接与 MT5 通信。它们通过安全的 WebSocket 连接到一个用 Go 编写的后端,再由后端通过 Web API(同时使用二进制协议和 HTTPS 请求)与 MT5 服务器通信。客户端看到的是推送式更新;MT5 服务器面对的则是数量少、可预测的 Manager 会话。
您可以在 WebTrader 演示和移动应用演示中体验效果,两者都连接到真实的 MT5 模拟环境。FXUP 是独立开发商,与 MetaQuotes 无任何关联;我们和其他集成方一样,基于公开发布的接口进行开发。我们自己的 CRM 使用同一个后端,我们也与合作方 CRM 合作,会根据经纪商的配置推荐更合适的方案。
批量轮询
一个循环每 100 毫秒通过批量查询向 MT5 获取报价、持仓、订单和账户数据,因此服务器负载不会随在线用户数增加而上升。
按客户端推送
每个已连接的客户端只接收自己订阅的交易品种和账户,未变化的部分不会重复发送。较大的数据帧会被压缩。
历史缓存
图表历史缓存在磁盘上并按需加载,交易者往回翻看多年 H1 K 线时,不必每次都请求 MT5 服务器。
交易安全
对仍在执行中的相同订单会去重;服务器和应用都不会在超时后自动重发交易。重复成交比由交易者自己决定的重试更糟糕。
如何通过 Web API 下单?
通过 Web API 下单,是代表客户账户在服务器上执行一个请求,然后获取结果。您的应用提交请求,收到一个标识符,再读取结果:返回代码如 10009(已完成)或 10008(订单已提交),或者拒绝原因,如止损无效、市场休市或资金不足。
由此带来两个实际影响。第一,客户自身的权限仍然有效:客户组设置、交易品种的交易模式、止损水平和保证金都由服务器强制执行,而不是由您的前端执行,最终以服务器为准。第二,超时并不等于订单失败。如果没有收到答复,正确的做法是先检查持仓和历史,再做其他操作。我们的前端会告诉交易者结果尚不确定,而不是再次发送同一笔订单。
时间戳是另一个常让团队踩坑的细节。MT5 按交易服务器配置的时区记录时间;凡是展示给客户或存入 CRM 的时间,都应在一个地方统一转换一次,转成真正的 UTC。
MT5 Web API 集成的安全性如何?
Web API 本身采用“挑战—应答”验证并支持加密会话;剩下的风险大多在于集成方如何管理 Manager 账户。Web API 使用的 Manager 往往可以转移资金、修改账户,因此要像对待银行账户钥匙一样对待它的凭据。MetaQuotes 在其经纪商页面上说明,系统各组件之间的数据交换通过加密连接进行;您自己的系统也需要同样严格。
- 为集成单独设置一个 Manager 账户,只授予它所需的权限和客户组;绝不要复用交易员的登录账户。
- 限制该 Manager 可连接的来源地址,并把凭据保存在密钥管理系统中,而不是写在源代码里。
- 绝不要把 Web API 直接暴露给浏览器或应用。客户端连接您的后端,由后端根据客户自己的账户校验每个请求。
- 在您这一侧,按 IP 地址对反复失败的登录进行限流和锁定。
- 记录每一笔余额操作是谁触发、为何触发,并每天与 CRM 对账。
MT5 Web API 有请求频率限制吗?
MetaQuotes 没有在公开页面上公布请求限制,我们也不会引用拿不出出处的数字。实际上,限制取决于您服务器的承载能力和集成的行为方式;一个写得粗糙的集成可能会拖慢整台交易服务器,影响所有人。
我们的做法是:维护一个已验证会话池,把交易请求与一般查询分开,尽可能使用批量命令,并缓存所有不会每秒变化的数据,比如交易品种设置和已平仓历史。在客户端一侧,我们对每个连接设置通用的消息防护,但不限制交易次数:客户可以连续下单,因为交易本来就是这样。
如果您正在设计自己的集成,请在上线前把负载情况写下来:每类数据的轮询频率、涉及多少个账户、使用多少个会话。这一页纸就能回答服务器管理员会问的大部分问题。
谁能获得 MT5 Web API 访问权限?
Web API 访问权限来自控制 MT5 服务器的一方,因为它需要该服务器上的 Manager 账户。具体意味着什么,取决于您的业务模式。想知道哪种 FXUP 配置能给您所需的访问权限,并在同一页面看到当前的价格和条件,可以在方案查询工具中比较各个选项。
MT5 Web API 集成清单应包括哪些内容?
在写代码之前,先把日后改动成本高的事项确定下来。以下是我们与接入经纪商 CRM、客户中心或前端的客户逐项核对的清单;我们开发的其他定制集成也适用同一份清单:
- 使用哪个服务器版本,以及哪种 Web API 方式(HTTPS、二进制或两者都用)。
- 专用的 Manager 账户、其权限以及可查看的客户组。
- 哪些事件会触发开户、余额变动和客户组调整,以及由谁审批。
- 每类数据的轮询频率,以及可覆盖这些数据的批量命令。
- 时区处理方式,以及唯一的转换点。
- 每类操作超时后如何处理,尤其是交易和余额变动。
- 监控:MT5 连接断开时发出告警,而不是等客户来投诉。
常见问题
MetaTrader 5 Web API 是什么?
MT5 Web API 是 REST 吗?
我能基于 MT5 Web API 开发自己的 WebTrader 吗?
Web API 能提供市场深度吗?
Web API 和 Manager API 有什么区别?
灰标经纪商能获得 API 访问权限吗?
MT5 Web API 有请求频率限制吗?
MT5 Web API 安全吗?
MT5 Web API 集成需要多长时间?
使用 Web API 需要 MetaQuotes 的许可吗?
没有找到您的问题? 打开方案查询工具 并查看适合您情况的方案、价格和条件。
资料来源
- MetaQuotes — MetaTrader 5 trading platform for brokers and banks (2026 年 10 月访问)
- MetaQuotes — MetaTrader 5 for brokers(metaquotes.net) (2026 年 10 月访问)
- MetaQuotes — Liquidity providers for MetaTrader 5 (2026 年 10 月访问)
- MQL5 Reference — Python integration for the MetaTrader 5 terminal (2026 年 10 月访问)
FXUP 是一家独立的咨询与技术公司,与 MetaQuotes Ltd. 无任何关联。MetaTrader 4 和 MetaTrader 5 是 MetaQuotes Ltd. 的商标。本页内容仅供一般参考,不构成法律、税务或投资建议;监管要求因司法管辖区而异,并会随时间变化。FXUP 当前的价格和条件可在方案查询工具中查看。