MT5 REST API 快速入门
选择一种编程语言并运行完整示例:创建新的模拟账户、连接、读取账户数据、开立 0.01 手 EURUSD 模拟仓位、查看仓位、平仓、确认平仓并断开连接。仅使用模拟资金交易。使用自己的 API 密钥会消耗服务余额。
完整的演示流程
/DemoAccount/Open创建 MetaQuotes 模拟账户。请妥善保管返回的登录信息。这一步不会向真实交易账户入金。
/ConnectEx连接模拟账户并保存终端 ID。API 密钥用于识别您的 MRPC 账户,终端 ID 用于识别本次连接。
/AccountSummary读取已连接账户的数据。成功响应说明接口能够获取数据;此请求不会下单。
/OrderSend买入 0.01 手 EURUSD。请检查经纪商返回码;仅收到 HTTP 200 并不能确认交易已执行。
/OpenedOrderspositionInfos 包含当前持仓,openedOrders 包含挂单。平仓时请使用此响应中的持仓 ticket。
/OrderClose → /OpenedOrders根据持仓 ticket 和交易量平仓,然后再次调用 OpenedOrders,确认该持仓已消失。
/Disconnect即使前面的请求失败,也应断开连接。可下载的示例包含清理逻辑,并请求将终端有效期设为五分钟,作为备用保护。
身份验证并读取账户
在 APIKey 请求头中发送您的 API 密钥。ConnectEx 返回 terminalInstanceGuid:在调用 AccountSummary 和 Disconnect 时,将该值放入 id 请求头。这是两个不同的标识符。下方请求读取一个已连接的账户。
curl --request GET "https://mt5.mrpc.pro/AccountSummary" \
--header "APIKey: YOUR_API_KEY" \
--header "id: YOUR_TERMINAL_ID"
请求结束后断开连接
请在 finally 块中调用 Disconnect,读取失败时也不例外。演示会为终端设置 5 分钟后自动过期,作为兜底清理措施。请下载上方对应编程语言的完整示例。
排查连接失败
检查 API 密钥、经纪商服务器名称、登录号和密码。如果 ConnectEx 失败且未返回终端 ID,请不要继续调用 AccountSummary。检查您的服务余额和试用限制;不要在日志中暴露凭据。
运行在线演示 →