风险警告： 差价合约（CFD）产品交易带有高风险，可能不适合所有投资者。

XBTFX Trading API

兼容 XBTFX MetaTrader 5® 账户

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

Edge 与 ECN 账户
完整的可编程访问
Hedging 与 Netting 模式
支持 AI 智能体 (MCP)
创建账户 API Console 文档
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 { "ticket": 184729, "status": "filled", "price": 1.08650, "retcode": 10009 }
协议 icon
REST
协议
流式传输 icon
WebSocket
流式传输
Weight / 分钟 icon
600
Weight / 分钟
响应格式 icon
JSON
响应格式

用 XBTFX API 自动化您的交易

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

自动化策略
构建交易机器人和算法策略,自动向账户发送交易。运行信号驱动的执行、组合再平衡或自定义风险管理逻辑。
AI 智能体集成
通过 XBTFX Skills Hub 或 MCP 服务器将 AI 助手连接到账户。借助 Claude Code、Cursor、Windsurf 或其他兼容客户端,以自然语言下达交易指令。
定制集成
构建仪表板、对接外部数据源、引入其他平台的交易信号,或将账户数据集成到您自己的报表与分析系统。

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

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

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
WS WebSocket 流
实时流式行情,带 5 档市场深度。可订阅账户上的任意可用品种。
wss://ws.xbtfx.com/v1/ws

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

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

XBTFX Trading API · examples
# 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"
import requests API_KEY = "xbtfx_live_your_key_here" BASE = "https://interface.xbtfx.com" HEADERS = {"Authorization": f"Bearer {API_KEY}"} # Send a trade to your account r = requests.post(f"{BASE}/v1/trade", json={ "symbol": "EURUSD", "side": "buy", "volume": 0.10 }, headers=HEADERS) print(r.json()) # {"status": "filled", "retcode": 10009}
const ws = new WebSocket("wss://ws.xbtfx.com/v1/ws"); ws.onopen = () => { ws.send(JSON.stringify({ type: "auth", api_key: "xbtfx_live_..." })); ws.send(JSON.stringify({ type: "subscribe", symbols: ["EURUSD", "BTCUSD"] })); }; ws.onmessage = (e) => { const q = JSON.parse(e.data); console.log(q.symbol, q.bid, q.ask); };
main 0 errors Shell UTF-8 LF interface.xbtfx.com
AI-Ready

用自然语言执行交易

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

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

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

对话示例 →
XBTFX Trading Agent
online · 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 Edge 或 ECN 账户、现有的基础币种与现有的保证金模式。API 接入您已经在交易的同一个账户。

技术规格

可用于生产的端点

Hedging 与 Netting 模式

MT5 两种保证金模式均支持。模式与您的 API 密钥绑定。

Idempotency 密钥

在 120 秒内发送相同密钥,我们会返回已缓存的响应。安全重试,避免重复成交。

基于权重的速率限制

每个密钥每分钟 600 weight。读取与下单各 1,批量操作 10。每个响应的头部都会显示剩余预算。

FIX 4.4 机构通道

通过 xPro 基础设施提供 FIX 4.4 接入,服务于一级券商、对冲基金与高频交易公司。联系销售。
账户兼容性

Edge 或 ECN——同一个账户

Edge 与 ECN 账户

更窄的点差并按手收取佣金。API 对每个 Edge / ECN 账户一视同仁——同样的端点、同样的 JSON、同样的认证流程。

PAMM、MAM 与 Copy Master 账户

管理人账户可通过 API 实现编程化操作,用于分配、再平衡与执行。请联系开户团队完成凭证配置。

多币种结算

XBTFX MT5 在 Edge 与 ECN 上支持的所有基础币种:USD、EUR、USDT、BTC、ETH、XRP、SOL、LTC、ZEC、XAU。余额、净值、保证金与盈亏均以账户原生币种返回——您无需在客户端做转换逻辑。

Hedging 或 Netting

无论您在 MT5 账户上设置的是哪种保证金模式,API 就用哪种。无需额外配置。

开发者资源

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

API 文档

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

API 示例

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

AI Skills Hub

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

MCP Server

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

三步开始

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

1
生成 API 密钥
用 XBTFX 账户凭据登录 console.xbtfx.com,选择交易账户并生成密钥。
打开 Console
2
安装 Skill 或 MCP
从 Skills Hub 安装 skill,或将 MCP 服务器连接到 Claude Code、Cursor、Windsurf 或其他兼容客户端。密钥保留在本地。
MCP 文档
3
开始交易
通过 GET /v1/auth/status 验证,然后用自然语言下达指令,或直接调用 REST/WebSocket 端点。
阅读文档

Frequently
Asked Questions

  • 什么是 XBTFX Trading API?

    XBTFX Trading API 通过 REST 与 WebSocket 提供编程化交易、账户监控、行情数据获取与流式服务,适用于兼容的 XBTFX MetaTrader 5® 账户。由 XBTFX 自行打造——您通过简洁的 HTTP 端点与 JSON 响应来发送交易并获取账户数据。

  • 可以用哪些编程语言?

    任何能发起 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 包含在每个交易账户中,无额外费用。除了正常的交易佣金与点差外,没有 API 费用、订阅或按调用计费。

  • 如何获取 API 密钥?

    若您还没有 XBTFX 交易账户,请先在 my.xbtfx.com 创建。然后用 XBTFX 凭据登录 console.xbtfx.com 上的 API Console,选择交易账户并生成密钥。下单前请发送 GET /v1/auth/status 验证密钥可用。

  • API 可以用模拟账户吗?

    可以。API 密钥同时适用于真实账户和模拟账户。这样您可以在上真实账户前先测试集成、验证代码——使用同一套 API 与同样的端点。

  • 下单前我应该做什么?

    请先发送 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 立即吊销密钥。建议先用模拟账户测试设置后再切换到真实账户。

今天就开始构建,使用

Chat

24/7 Chat Support

Need help with the API? Our team is available around the clock.

Chat Now →
FAQ

API Documentation

Full endpoint reference, authentication guide, and examples.

View Docs →
Blog

GitHub Repos

API examples, AI skills, and sample code ready to use.

View on GitHub →

本页面由XBTFX旗下公司拥有和运营，包括：

XBTFX LLC，注册于安提瓜和巴布达，注册编号 ILLC001，注册地址 Hodges Bay, P.O. Box 1348, St. John's, Antigua。

XBTFX (SC) Ltd. 注册于塞舌尔，注册号 8434947-1，营业地址 Office 1, Block 2, 1st Floor, Sai-fu Building, Zone 20, Providence, Mahe, Seychelles，许可证号 SD169。
支付处理由 CLEARAY LTD 执行，该公司是根据塞浦路斯共和国《公司法》第 113 章正式注册成立的有限责任公司，公司注册号 HE 462275，注册办公地址 Archiepiskopou Makariou ΙΙΙ, 160, 1st Floor, 3026, Limassol, Cyprus。 XBTFX 是覆盖多种资产的差价合约（CFD）服务提供商，以杠杆方式提供服务。请注意，您的投资估值受市场波动影响，可能上涨或下跌。因此，您投入的资金面临风险。加密货币资产，尤其是不受监管且高度波动的资产，不享有消费者保护。此外，您的投资所获收益可能需缴纳税款。 XBTFX 不向居住在某些司法管辖区的个人提供服务，包括但不限于美国、魁北克（加拿大）、比利时、白俄罗斯、俄罗斯、伊朗、朝鲜、苏丹、也门，或任何其他在 XBTFX 提供服务会违反当地现行法律法规的地区。此列表并非详尽无遗，并将根据需要更新。XBTFX 不主动针对欧盟/欧洲经济区客户。我们强烈建议潜在客户在使用 XBTFX 服务前充分了解其所在国适用的外汇监管规定。 高风险投资警示： 差价合约（CFD）是复杂的金融工具，由于其杠杆性质而存在重大风险。快速的资金损失是使用这些工具的可能后果。您必须仔细评估您对 CFD 运作方式的理解，并判断 CFD 交易是否适合您的具体情况。强烈建议您不要投资您无法承受损失的资金。杠杆产品可能不适合所有人，并可能导致您的资金完全耗尽。请阅读我们的 ‘风险披露通知’. 通过跟随和/或复制其他交易者的交易在 XBTFX 进行交易涉及高度风险，即使跟随、复制或重复表现最佳的交易者也是如此。这些风险包括可能跟随/复制经验不足/非专业交易者的交易决策，或目的、意图或财务状况可能与您不同的交易者的交易决策。过往业绩不代表未来表现。XBTFX 社交交易平台上的内容由其社区成员生成，不含 XBTFX 或代表 XBTFX 的建议或推荐。 防欺诈提示： XBTFX 仅向客户提供经纪服务。此外，XBTFX 仅通过 URL xbtfx.com 运营，客户应确保仅通过该 URL 访问我们的服务。XBTFX 永远不会向您索要密码，也不会通过短信/电话联系您索取密码。 此处所含内容仅用于信息和营销目的。它不构成、也不应被解释为财务、投资或其他专业建议或推荐。此外，它不代表买卖或参与任何金融工具或交易的要约或邀约。客户在交易前应寻求持牌财务顾问的意见，以确保自己具有相关的风险偏好、经验和知识。 本页面为方便您而翻译。如有任何不一致，所有条款、协议、法律文件及交易条件以英文版本为准。
2026 XBTFX LLC. All Rights Reserved.