兼容 XBTFX MetaTrader 5® 账户

XBTFX Trading API

通过 REST 和 WebSocket 在兼容的 XBTFX MetaTrader 5® 账户上以编程方式进行交易、管理仓位、监控账户状态并实时流式接收行情。构建自动化策略、连接 AI 智能体、将账户嵌入定制工作流。从文档、可用示例、AI skills 或 XBTFX MCP 服务器开始入手。面向具备编程经验或熟悉 AI 编码助手的开发者与用户。

  • Pro 账户
  • 完整的可编程访问
  • Hedging 与 Netting 模式
  • 支持 AI 智能体 (MCP)
terminal
# Send a trade to your XBTFX account
curl -X POST https://interface.xbtfx.com/v1/trade \
  -H "Authorization: Bearer xbtfx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "EURUSD",
    "side":   "buy",
    "volume": 0.10,
    "sl":     1.08200,
    "tp":     1.09000
  }'

# Response
{
  "status":  "filled",
  "retcode": 10009,
  "deal":    184729,
  "price":   1.08650,
  "volume":  0.10
}
协议
REST
流式传输
WebSocket
Weight / 分钟
600
响应格式
JSON

用 XBTFX API 自动化您的交易

XBTFX Trading API 让您可以向您的 XBTFX MetaTrader 5® 兼容账户发送指令。通过标准 REST 与 WebSocket 调用开仓、修改止损、查询余额、流式获取实时报价。

自动化策略

构建交易机器人和算法策略,自动向账户发送交易。运行信号驱动的执行、组合再平衡或自定义风险管理逻辑。

AI 智能体集成

通过 XBTFX Skills Hub 或 MCP 服务器将 AI 助手连接到账户。借助 Claude Code、Cursor、Windsurf 或其他兼容客户端,以自然语言下达交易指令。

定制集成

构建仪表板、对接外部数据源、引入其他平台的交易信号,或将账户数据集成到您自己的报表与分析系统。

用于交易、持仓与行情数据的 API 端点

开仓、平仓、设止损止盈、查询账户余额、获取交易历史,并通过 WebSocket 流式获取实时外汇与加密报价。

API 文档

POST下单

向账户发送带止损止盈的市价单。同时支持 Hedging 与 Netting 保证金模式。

/v1/trade

POST平仓与修改

全部或部分平仓。修改未平仓位的 SL/TP。一键平仓、按品种平仓或对冲互抵。

/v1/close · /v1/modify · /v1/close-all

GET持仓与挂单

实时获取所有持仓与挂单。可按品种过滤。响应来自缓存,并配合实时推送更新。

/v1/positions · /v1/orders

GET账户与余额

实时余额、净值、保证金、可用保证金、浮动盈亏与杠杆。一次调用即可获得完整快照。

/v1/account

GET品种与规格

完整品种列表,含实时 bid/ask、点差、合约规模、最小/最大/步进手数、小数位与保证金要求。

/v1/symbols · /v1/symbols/:symbol

WSWebSocket 流

实时流式行情,带 5 档市场深度。可订阅账户上的任意可用品种。

wss://ws.xbtfx.com/v1/ws

几分钟发送您的第一笔 API 交易

用您选择的语言写几行代码即可。标准 HTTP——任何能发起 POST 请求的语言都能用。

# Send a buy order to your XBTFX account
curl -X POST https://interface.xbtfx.com/v1/trade \
  -H "Authorization: Bearer $XBTFX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"EURUSD","side":"buy","volume":0.10,"sl":1.082,"tp":1.09}'

# Retrieve open positions
curl https://interface.xbtfx.com/v1/positions \
  -H "Authorization: Bearer $XBTFX_API_KEY"

interface.xbtfx.comShell

AI-Ready

用自然语言执行交易

XBTFX Trading API 的设计目标就是让 AI 智能体与大型语言模型来消费——干净的 JSON、可读的错误、可预测的端点。通过 XBTFX Skills Hub 或 MCP 服务器接入,您的 AI 客户端便可通过对话式指令发送交易。

  • 对话式下单——买入、卖出、平仓、按数据条件触发。
  • 基于工具的推理——每次动作都返回结构化响应。
  • 跨客户端可移植——Claude、Cursor、Windsurf、Codex。

想要不那么技术的版本?请看 AI Agent Trading 页面。

对话示例

XBTFX Trading Agentonline · executing trades

Today · 13:25 GMT

If today's NFP prints above 200k, close all my open EURUSD and GBPUSD trades.

13:25 ✓✓

Got it. Watching the BLS release at 13:30 GMT. I'll close 4 positions if NFP > 200k.

13:25

tool · xbtfx_get_positions4 open · EURUSD ×2, GBPUSD ×2 · floating +$184.20

13:26

13:30 · NFP released: 247k (forecast 195k)

tool · xbtfx_close_all (filter: EURUSD, GBPUSD)Closed 4 positions in 38 ms · realized +$212.80

13:30

示意演示。条件流程取决于配置的智能体与行情数据源。

应用场景

AI 智能体用 API 做什么

我们在 XBTFX 账户的自动化与 AI 驱动工作流中常见的四种模式。

事件驱动交易

AI 实时监控新闻与经济数据,在检测到能撼动市场的事件时向账户发送交易。

智能风险管理

AI 跟踪保证金、浮动盈亏与敞口,通过调整止损、缩减仓位或平仓来保护资金。

组合再平衡

设定目标配置,让 AI 维持其权重,在偏离超过阈值时发送调整交易。

自主分析

请 AI 分析交易历史,按品种计算胜率,识别表现最佳的交易模式。

为您现有的 XBTFX 账户而生

使用您当前的 MetaTrader 5 Pro 账户、现有的基础币种与现有的保证金模式。API 接入您已经在交易的同一个账户。

技术规格

可用于生产的端点

Hedging 与 Netting 模式
MT5 两种保证金模式均支持。模式与您的 API 密钥绑定。
Idempotency 密钥
在 120 秒内发送相同密钥,我们会返回已缓存的响应。安全重试,避免重复成交。
基于权重的速率限制
每个密钥每分钟 600 weight。读取与下单各 1,批量操作 10。每个响应的头部都会显示剩余预算。
流式传输限制
每个 WebSocket 连接最多订阅 1,000 个品种,每个 API 密钥最多 10 个连接。价格一有变动,报价即刻推送。

账户兼容性

适用于您的 Pro 账户

Pro 账户
原始点差另加佣金。API 对每个 Pro 账户一视同仁:同样的端点、同样的 JSON、同样的认证流程。
PAMM、MAM 与 Copy Master 账户
管理人账户可通过 API 实现编程化操作,用于分配、再平衡与执行。请联系开户团队完成凭证配置。
多币种结算
XBTFX MT5 为 Pro 账户支持的所有基础币种:USD、EUR、USDT、BTC、ETH、XRP、SOL、LTC、ZEC、XAU。余额、净值、保证金与盈亏均以账户本身的币种返回,您无需编写转换逻辑。
Hedging 或 Netting
无论您在 MT5 账户上设置的是哪种保证金模式,API 就用哪种。无需额外配置。

开发者资源

示例代码、AI skill 文件与完整 API 文档——您构建所需的一切。

API 文档

完整端点参考,含请求/响应示例、认证指南与 WebSocket 集成说明。

API 示例

Python、JavaScript、curl 等语言的示例代码。复制即可运行。

AI Skills Hub

面向兼容智能体框架的交易、账户、行情与 WebSocket 工作流 skill 文件。

MCP Server

适用于 Claude Code、Claude Desktop、OpenAI Codex、Cursor、Windsurf 与其他 MCP 兼容客户端。

三步开始

同一套流程,两个起点——选择与您账户状态匹配的那个。

  1. 生成 API 密钥

    用 XBTFX 账户凭据登录 portal.xbtfx.com,选择交易账户并生成密钥。

    打开 Console
  2. 安装 Skill 或 MCP

    从 Skills Hub 安装 skill,或将 MCP 服务器连接到 Claude Code、Cursor、Windsurf 或其他兼容客户端。密钥保留在本地。

    MCP 文档
  3. 开始交易

    通过 GET /v1/auth/status 验证,然后用自然语言下达指令,或直接调用 REST/WebSocket 端点。

    阅读文档

常见问题

什么是 XBTFX Trading API?
XBTFX Trading API 通过 REST 与 WebSocket 提供编程化交易、账户监控、行情数据获取与流式服务,适用于兼容的 XBTFX MetaTrader 5® 账户。由 XBTFX 自行打造——您通过简洁的 HTTP 端点与 JSON 响应来发送交易并获取账户数据。
Standard 账户可以使用 API 吗?
不可以。XBTFX Trading API 仅适用于 MetaTrader 5 上的 Pro 账户。如果您使用 Standard 账户,请使用 Mega1 的开放 API:它适用于 Mega1 上的 Standard 账户,密钥在 Mega1 终端中创建。
可以用哪些编程语言?
任何能发起 HTTP 请求的语言。Python、JavaScript、Go、Rust、C#、Java、Ruby、PHP——只要能用 JSON 主体发送 POST 请求,就能通过 API 在 XBTFX 账户上下单。
可以构建自动化交易策略吗?
可以。XBTFX Trading API 专为算法与自动化交易而设计。您可以构建信号驱动机器人、组合再平衡器、风险管理系统或任何向账户发送交易的自定义逻辑。
有实时价格的 WebSocket 流吗?
有。XBTFX Trading API 提供 WebSocket 端点,可流式获取账户上可用品种的实时报价。报价在可用时包含 5 档市场深度。每个连接最多订阅 1,000 个品种,最多 10 个并发连接。
Hedging 和 Netting 模式有什么区别?
它们是决定持仓行为的保证金模式。Hedging 允许同一品种存在多个独立仓位,包括相反方向的买卖。Netting 则将同一品种的所有仓位合并为一个仓位。您的 API 密钥继承账户的模式。
速率限制是多少?
每个 API 密钥每分钟 600 weight。大多数请求消耗 1 weight——每分钟最多 600 次调用。close-all 等批量操作消耗 10 weight。每个响应都包含展示剩余预算的 header。
可以通过 API 交易加密 CFD 吗?
可以。账户上每个可用品种都可通过 API 访问——包括加密 CFD。您也可以将 API 用于以 BTC、ETH、USDT 或 XRP 计价的账户。
API 是否免费使用?
是的。XBTFX Trading API 包含在每个 Pro 账户中,无额外费用。除了正常的交易佣金与点差外,没有 API 费用、订阅或按调用计费。
如何获取 API 密钥?
若您还没有 XBTFX Pro 账户,请先在 portal.xbtfx.com 开立。然后用 XBTFX 凭据登录 portal.xbtfx.com 上的 API Console,选择 Pro 账户并生成密钥。下单前请发送 GET /v1/auth/status 验证密钥可用。
下单前我应该做什么?
请先发送 GET /v1/auth/status 验证 API 密钥与账户状态。这能确认密钥有效、显示您的权限与保证金模式,并确保账户已就绪,然后再发送任何交易请求。
需要编程经验吗?
直接使用 REST API 需要基础编程能力。但通过 AI 集成路径,您无需亲自写代码——将 XBTFX MCP 服务器连接到 Claude Code 或 Cursor,或从 Skills Hub 安装 skill 文件,然后用自然语言下指令即可。建议熟悉 AI 编码助手。
可以让 AI 来交易我的账户吗?
可以。对于支持 skill 文件的智能体框架,使用 XBTFX Skills Hub;或将 XBTFX MCP 服务器连接到 Claude Code、Claude Desktop、OpenAI Codex、Cursor 或 Windsurf 等 MCP 兼容客户端。两种方式都能通过 XBTFX Trading API 用自然语言下交易指令。
让 AI 智能体接入我的账户安全吗?
API 密钥通常由智能体保存在本地机器,不会上传到第三方服务器。智能体使用您的密钥直接向 XBTFX 服务器发起 API 调用。您可以随时从 Console 立即吊销密钥。

今天就开始构建。
API 免费使用。

开设 XBTFX 账户,在客户门户生成 API 密钥,然后发送您的第一笔交易。

在线客服

与我们的客服团队在线沟通,周末也不例外。

帮助中心

有关账户、出入金和交易平台的指南与解答。

访问帮助中心

博客

公司新闻、市场动态与交易洞察。

阅读博客

风险警告: 差价合约(CFD)产品交易带有高风险,可能不适合所有投资者。