1. 首页
  2. MT5 API 与订单执行
  3. MT5 Web API
MT5 Web API · 2026 年 10 月更新

MetaTrader 5 Web API:是什么,能做什么,不能做什么

MT5 Web API 是大多数经纪商集成实际使用的接口:CRM、客户中心和定制交易前端都靠它。我们自己有一个基于它的生产环境 WebTrader,所以这份指南是从内部视角写的,也包括宣传资料里不会提到的部分。

更新于 2026年10月25日12 分钟阅读FXUP 编辑团队
交易者WebTrader 及 iOS、Android 应用
MetaTrader 5 服务器客户组、交易品种、风控设置
网关或桥接A-book、B-book 或混合路由
流动性提供商报价与成交
登录身份
MT5 Manager 账户
传输方式
HTTPS 请求、JSON 响应,另有二进制协议
向客户端推送
不内置,需由集成方自行实现
FXUP 的用法
作为我们 WebTrader 和应用背后的 Go 后端
要点速览

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 资源及公司其他服务的集成。”
— MetaQuotes — MetaTrader 5 trading platform for brokers and banks

Web API 与其他 MetaTrader 5 API 有什么不同?

MetaQuotes 为 MT5 公布了五种 API,各有分工。Web API 是从外部通过网络与服务器通信的那一个;其他几种要么在服务器内部运行,要么把服务器连接到市场,要么扩展服务器报表。第二列的定义引自 MetaQuotes 的经纪商页面。

MetaTrader 5 的五种 API
APIMetaQuotes 的定义您的代码在哪里运行经纪商的典型用途
Web API“用于平台与 Web 资源及公司其他服务的集成”您自己的服务器,通过网络连接CRM、客户中心、支付、定制 WebTrader
Manager API“可用于开发定制的管理和运营工具,甚至您自己的 Manager 终端”连接到服务器的 Manager 应用程序后台工具、交易部和风控工具
Server API“可帮助您为 MetaTrader 5 交易服务器和 MetaTrader 5 历史服务器增加更多功能”以插件形式运行在 MT5 服务器内部针对每笔交易的定制规则、赠金、跟单逻辑
Gateway API“用于将 MetaTrader 5 与其他交易系统集成,以及创建定制数据源”挂接在平台上的网关流动性提供商、交易所、数据源
Report API“扩展 MetaTrader 5 交易服务器生成的报表”在报表组件内部定制的监管报表和管理报表
定义引自 https://www.metatrader5.com/en/brokers,访问日期 2026 年 10 月 12 日。

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 方式下,需要两次调用:

  1. 发起应用以其 Manager 登录名调用验证发起命令,声明自己是 Web API 客户端。服务器返回一个随机挑战值。
  2. 应答应用把密码哈希与该挑战值组合后发送结果,同时附上自己生成的随机挑战值。
  3. 验证服务器服务器对客户端的挑战值作出应答,应用检查该应答,这样双方都证明了自己知道密码。
  4. 保持会话验证通过的会话与底层连接绑定。连接断开后需要重新验证。

用 MetaTrader 5 Web API 可以构建什么?

经纪商需要的几乎所有面向客户的系统都可以基于 Web API 构建,因为它能访问这些系统关心的对象:用户、账户、客户组、交易品种、订单、持仓、成交和历史价格。下表列出了我们使用的命令类别及其用途。

Web API 命令类别及经纪商的用途
类别涵盖内容典型用途
用户与账户创建、更新、删除和读取账户;校验或修改密码;读取余额、净值和保证金CRM 中完成 KYC 后开户、重置密码、客户中心仪表盘
余额操作账户的入金、出金、信用额度和调整银行卡或银行入金自动入账
客户组与交易品种读取和维护客户组及交易品种设置在前端正确显示合约规格、保证金和交易时段
订单、持仓、成交、历史当前和历史交易数据,包括针对多个账户的批量查询交易历史、对账单、IB 佣金计算
价格与图表最新报价、报价统计、报价历史和图表 K 线WebTrader 或移动应用中的报价和图表
交易请求代表账户在服务器上执行的请求,附带结果代码在定制前端下单、改单和平仓
邮件与新闻发送到终端的内部邮件和新闻向客户发送服务消息
基于 FXUP 生产环境集成中使用的 Web API 命令集。请对照与您服务器版本对应的 MetaQuotes 参考文档。

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 的职责。
如果供应商承诺在基于 Web API 的 WebTrader 中显示来自您 LP 的市场深度,请问清楚深度数据到底来自哪个接口。

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 配置能给您所需的访问权限,并在同一页面看到当前的价格和条件,可以在方案查询工具中比较各个选项。

不同经纪业务模式下的 Web API 访问权限
模式谁控制服务器通常能获得什么
自有 MT5 牌照您的公司完整访问权限;由您自己创建 Manager 并设置权限
MT5 白标牌照持有方如协议允许,可获得仅限您客户组的 Manager
MT5 灰标服务商因服务商而异;在 FXUP,您会获得一个只能看到您自己用户的专属 Manager 账户,付款后还可获得 Manager API 和 SDK 权限
这是 FXUP 项目中的一般情况;具体条款以各自协议为准。

MT5 Web API 集成清单应包括哪些内容?

在写代码之前,先把日后改动成本高的事项确定下来。以下是我们与接入经纪商 CRM、客户中心或前端的客户逐项核对的清单;我们开发的其他定制集成也适用同一份清单:

  • 使用哪个服务器版本,以及哪种 Web API 方式(HTTPS、二进制或两者都用)。
  • 专用的 Manager 账户、其权限以及可查看的客户组。
  • 哪些事件会触发开户、余额变动和客户组调整,以及由谁审批。
  • 每类数据的轮询频率,以及可覆盖这些数据的批量命令。
  • 时区处理方式,以及唯一的转换点。
  • 每类操作超时后如何处理,尤其是交易和余额变动。
  • 监控:MT5 连接断开时发出告警,而不是等客户来投诉。

常见问题

MetaTrader 5 Web API 是什么?
它是 MetaQuotes 提供的服务器端接口,用于把 MT5 交易服务器与网站、CRM 及公司其他系统连接。应用以 Manager 身份登录,可以管理用户、余额、交易品种、交易和历史。它面向经纪商及其开发人员,而不是个人交易者。
MT5 Web API 是 REST 吗?
基本上是。当前版本接受 HTTPS 请求并返回 JSON,另外还有一种二进制 socket 协议。它是“请求—响应”模式,没有内置的 WebSocket 推送,实时数据需要轮询获取。
我能基于 MT5 Web API 开发自己的 WebTrader 吗?
可以。我们的 WebTrader 就是这样运作的:Go 后端通过 Web API 与 MT5 通信,再通过 WebSocket 向浏览器和应用推送数据。轮询、缓存、时区和交易超时都需要谨慎处理。
Web API 能提供市场深度吗?
不能,至少无法提供来自您流动性提供商的聚合订单簿。它提供每个交易品种的最新报价和统计数据。市场深度和 LP 连接由网关、桥接和 Ultency 负责。
Web API 和 Manager API 有什么区别?
两者都以 Manager 身份在服务器上操作。Manager API 是一个用于开发管理工具和 Manager 终端的库;Web API 则是为与 CRM、客户中心等 Web 服务进行网络集成而设计的。我们的 MT5 Manager API 指南对两者做了详细对比。
灰标经纪商能获得 API 访问权限吗?
取决于服务商。在灰标模式下,服务器由服务商控制,有些服务商只允许您通过他们自己的 CRM 和前端操作。在 FXUP 灰标上,您会获得一个只能看到您自己用户的专属 Manager 账户,付款后还可获得 Manager API 和 SDK 权限,这正是接入 CRM 或自营交易后台所需要的。
MT5 Web API 有请求频率限制吗?
MetaQuotes 没有在公开页面上公布具体数字。实际上,限制取决于您服务器的承载能力,因此应使用批量命令、缓存和固定的会话池,而不是每个用户一个会话。
MT5 Web API 安全吗?
安全,前提是 Manager 账户管理得当。验证采用“挑战—应答”机制,会话可以加密。主要风险在于 Manager 权限过大、凭据写在代码里,以及把 API 直接暴露给客户端。
MT5 Web API 集成需要多长时间?
取决于范围。为客户中心读取账户和历史是一项小工作;一个带实时数据、图表和订单处理的完整交易前端则是一个独立的项目。我们会在了解需求后逐案评估。
使用 Web API 需要 MetaQuotes 的许可吗?
您需要 MT5 服务器上的一个 Manager 账户,该账户由牌照持有方提供。FXUP 与 MetaQuotes 无任何关联;关于 API 组件的授权问题,请直接咨询 MetaQuotes 或您的服务器提供方。

没有找到您的问题? 打开方案查询工具 并查看适合您情况的方案、价格和条件。

资料来源

  1. MetaQuotes — MetaTrader 5 trading platform for brokers and banks (2026 年 10 月访问)
  2. MetaQuotes — MetaTrader 5 for brokers(metaquotes.net) (2026 年 10 月访问)
  3. MetaQuotes — Liquidity providers for MetaTrader 5 (2026 年 10 月访问)
  4. MQL5 Reference — Python integration for the MetaTrader 5 terminal (2026 年 10 月访问)

FXUP 是一家独立的咨询与技术公司,与 MetaQuotes Ltd. 无任何关联。MetaTrader 4 和 MetaTrader 5 是 MetaQuotes Ltd. 的商标。本页内容仅供一般参考,不构成法律、税务或投资建议;监管要求因司法管辖区而异,并会随时间变化。FXUP 当前的价格和条件可在方案查询工具中查看。

方案查询

看看哪种 MT5 配置能提供您所需的 API 权限

告诉方案查询工具您是自己运营服务器还是需要一台服务器,以及计划连接什么。它会显示对应的 FXUP 产品,以及当前的价格和条件。

  1. 01
    回答几个问题

    您要搭建什么、使用哪个平台、真实还是模拟。

  2. 02
    查看价格和条件

    就在您做选择的同一页面,在您提供任何信息之前。

  3. 03
    凭参考编号继续

    您的选择会发送给团队,您可在 WhatsApp、Telegram 或电子邮件中继续沟通。

方案与价格