阅读时间 … 分钟

针对 FOREX.com 交易策略的 AI 原生运行环境

在 Cursor、Claude Code 或任何 AI IDE 中编写 FOREX.com REST 和 StoneX GAIN Capital REST 策略。从 GitHub 部署到托管云运行环境，支持原生 MCP 控制、日志和区域选择。

由 TradingHost 工程团队撰写

第 01 节 · 一览

一览

经纪商
FOREX.com（GAIN Capital，StoneX Group 旗下子公司）
经纪商类型
外汇与 CFD 经纪商（支持美国用户）
资产类别
外汇、股指 CFD、商品 CFD、金属、股票 CFD（取决于具体监管实体）
支持的产品
80 多种现货外汇货币对、主要和次要股指 CFD、金属（XAU/USD、XAG/USD）、能源、软商品，以及非美国实体提供的股票 CFD。美国客户可交易现货外汇以及 CFTC 零售规则允许的期货型股指和金属产品。
运行环境模型
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
FOREX.com REST API（ciapi.cityindex.com 共享 StoneX 基础设施）、NautilusTrader、原生 REST 客户端、自定义连接器
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制接口
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
FOREX.com 角色
经纪商账户、API 接入、市场准入、执行场所
监管机构
GAIN Capital Group LLC（CFTC RFED，NFA 注册，美国）；GAIN Capital UK Limited（FCA 机构编号 113942）；StoneX Financial Pty Ltd（ASIC AFSL 345646，澳大利亚，FOREX.com）；GAIN Global Markets Inc（CIMA，开曼群岛）。
零售杠杆上限
美国（GAIN Capital Group LLC，NFA Rule 2-43b）：主要外汇 50:1，非主要外汇 20:1。英国（FCA，符合 ESMA 标准）、欧盟及澳大利亚（ASIC）：主要外汇 30:1，非主要外汇和黄金 20:1，非黄金商品和非主要股指 10:1，股票 5:1，加密货币 CFD 2:1。开曼实体根据 CIMA 规则可能允许更高的杠杆。
母公司披露
GAIN Capital 于 2020 年 7 月被 StoneX Group Inc.（NASDAQ: SNEX）收购，现为其全资子公司。
关联关系
TradingHost 保持独立，与 FOREX.com、GAIN Capital、StoneX Group 或 City Index（GAIN Capital 旗下的姐妹品牌）无任何隶属关系。

第 02 节 · FOREX.com 支持概况

FOREX.com 支持概况

FOREX.com 通过托管在 ciapi.cityindex.com 共享 GAIN Capital / StoneX 基础设施上的 REST API，提供现货外汇、股指和商品 CFD、贵金属以及股票 CFD（非美国实体）。美国客户可使用 CFTC 允许的子集。具体的端点、合约标识符和限频规则请参阅 StoneX-GAIN 开发者文档。

市场与策略模式

  • 基于 80 多种外汇货币对的 REST 策略
  • 适用于美国用户的核心外汇策略（遵循 NFA Rule 2-43b）
  • 主要和次要股指 CFD 突破策略（仅限美国/英国实体）
  • XAU/USD 和 XAG/USD 贵金属策略
  • 基于 WTI 和 Brent 的能源 CFD 策略
  • 模拟盘验证后直接上线实盘

API 接口

产品接口
80 多种现货外汇货币对、主要和次要股指 CFD、金属（XAU/USD、XAG/USD）、能源（WTI、Brent）和软商品。非美国实体（英国、澳大利亚、CIMA）提供股票 CFD。美国客户仅可交易 CFTC 允许的子集：现货外汇以及期货型股指和金属产品。模拟账户与实盘账户相互独立。
连接方式
REST API 托管于 ciapi.cityindex.com（FOREX.com 与其姐妹品牌 City Index 共享的 StoneX-GAIN 基础设施）。该 REST 接口涵盖会话管理、账户、订单、持仓、市场数据和历史价格。同时提供 WebSocket 流，用于获取实时价格和交易事件。
身份验证
基于会话的身份验证，使用用户名和密码（或 AppKey，取决于开户实体）。初始的 /Session 调用会返回一个用于后续请求的 session token。实盘 API 接入通常需要向 FOREX.com 支持团队发送邮件，以在实盘账户上启用 REST；模拟账户在开发时默认已启用 REST。

具体细节请参考 FOREX.com 和 StoneX-GAIN

具体端点、主机路径、身份验证流程和限频规则请参阅 GAIN Capital REST 文档。请以此文档为准。

第 03 节 · 使用 AI 构建

使用 AI 构建您的 FOREX.com 策略

选择一种集成方式，派生（fork）一个 TradingHost 框架起步模板，然后在 AI IDE 中编写您的策略。FOREX.com REST API 是与 TradingHost 兼容的标准路径。美国客户需在 CFTC 允许的产品范围内进行交易。

  • 原生 FOREX.com REST

    直接控制 FOREX.com 的行为、session token、账户状态以及 StoneX-GAIN 订单模型。

  • NautilusTrader

    集成了外汇经纪商的 Python 框架。适用于回测与实盘共用代码的事件驱动型策略。

    开始使用 NautilusTrader

  • MetaTrader 4 / 5（取决于具体实体）

    FOREX.com 在部分实体中提供 MT4 和 MT5。这属于终端内的 EA 模型，而非 TradingHost 容器工作负载。

  • 自定义连接器

    基于 FOREX.com REST 和 WebSocket 流端点，使用您自己的 Python、JavaScript、Java、.NET、Go 或 Rust 客户端。

各框架对 FOREX.com 产品的支持情况

FOREX.com REST 和共享的 StoneX-GAIN REST 涵盖了完整的产品范围，其中股票 CFD 仅在非美国实体中提供。美国客户在 CFTC 允许的子集内进行交易。加密货币 CFD 目前不属于 FOREX.com 零售业务的一部分。

框架外汇指数商品CFD加密货币 CFD
Native FOREX.com REST支持支持支持部分支持未记录支持
StoneX-GAIN REST (City Index)支持支持支持部分支持未记录支持
NautilusTrader支持部分支持部分支持未记录支持未记录支持
MetaTrader 4 / 5 (entity-dependent)部分支持部分支持部分支持未记录支持未记录支持

✓ 已根据 FOREX.com REST 文档和 StoneX-GAIN 文档确认支持。“non-US” 表示该产品在非美国零售层级提供。“limited” 表示框架适配器仅部分覆盖。工作流链接指向目前正在编写的 /workflows/ 页面。

TradingHost 不绑定任何框架。它只运行您的项目。

AI 辅助编写

上述框架起步模板可与 AI IDE 完美契合。TradingHost 的 MCP 控制面板实现了闭环：AI 工具可以与您一同检查部署、查看日志并管理运行环境，但绝不会介入交易执行路径。

章节 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

FOREX.com（GAIN Capital，StoneX Group 旗下子公司）提供经纪商账户和 REST API。TradingHost 则提供运行您连接到 FOREX.com 的策略的生产环境。

您无需在笔记本电脑、台式机、通用 VPS 或手动配置的服务器上运行策略代码，只需从 GitHub 部署到 TradingHost 托管的容器运行环境中。

您

  • 您的代码库包含您的代码。
  • 您的部署定义了其运行方式。
  • 您的策略通过 REST 连接到 FOREX.com。

TradingHost

  • 保持运行环境在线。
  • 呈现日志和健康检查。
  • 区域选择。
  • 受控的部署面板。

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 账户。

  2. 步骤 02

    关联代码库或从框架起步

    将 TradingHost 指向您现有的策略仓库，或者派生（fork）一个 TradingHost FOREX.com REST 起步模板作为可运行的基础。

  3. 步骤 03

    部署到 TradingHost 容器中

    选择一个区域（适用于 GAIN Capital Group LLC 美国可用账户和 StoneX 撮合场所的 US-East，或适用于 GAIN Capital UK FCA 实体的 EU），提供策略所需的环境变量（FOREX.com 用户名和密码或 AppKey、账户标识符、模拟或实盘主机），然后进行部署。TradingHost 会根据代码库构建您的容器，并在托管的 Kubernetes 基础设施上运行您的策略。

  4. 步骤 04

    监控日志和健康状况

    从 TradingHost 控制台查看实时日志、健康状况和运行状态。任何 AI IDE 都可以通过 MCP 访问相同的面板，因此 Cursor、Claude Code 或 CLI 代理可以与您一同读取部署状态并管理运行环境。

  5. 步骤 05

    更新与重新部署

    将更改推送到您的 GitHub 主分支，TradingHost 将自动重新部署。

部署

章节 05 · 运维说明

FOREX.com 运维说明

在容器化云端运行环境中实际运行 FOREX.com 策略时需要注意的潜在问题。以下所有说明均转述自 FOREX.com、StoneX-GAIN 的官方文档或相关监管机构；部署方面的指南则源自我们在 TradingHost 上运行这些策略的实际经验。

  1. 01 · 共享基础设施

    FOREX.com REST 运行在共享的 StoneX-GAIN ciapi.cityindex.com 主机上

    FOREX.com 的 REST API 与其姐妹品牌 City Index 使用的是同一个 StoneX-GAIN 平台。基准 URL 为 ciapi.cityindex.com/tradingapi/。由于采用共享基础设施，会话端点、账户端点和订单模型都是通用的；docs.labs.gaincapital.com 上的文档同时适用于 FOREX.com 和 City Index 实体。请使用与您的环境（实盘或模拟盘）以及您账户所属实体相匹配的主机。

    来源FOREX.com API trading overviewStoneX-GAIN REST documentation

  2. 02 · 会话认证

    会话令牌（session token）认证；实盘 API 启用需手动申请

    FOREX.com REST 通过 /Session 调用进行身份验证，该调用会返回一个用于后续请求的 session token。模拟账户默认已启用 REST 以供开发使用。实盘账户通常需要显式启用：请向 FOREX.com 支持团队发送电子邮件并注明您的账号，他们会在实盘账户上启用 REST。请将 session token 保存在进程内存中，切勿将其提交到您的代码仓库。

    来源StoneX-GAIN REST getting started

  3. 03 · NFA Rule 2-43b

    GAIN Capital Group LLC (US) 强制执行 FIFO 订单撮合且单持仓品种禁止对冲

    根据 NFA Rule 2-43b，GAIN Capital Group LLC 的美国零售客户无法在同一交易品种上同时持有做多和做空头寸，且必须按照开仓顺序平仓（先进先出，FIFO）。如果策略在同一货币对上放置对冲订单，该订单将与现有头寸进行净额结算。此规则不适用于 FOREX.com 的非美国实体（GAIN Capital UK、StoneX Financial Pty Ltd）。对于跨实体部署的策略，相同的代码在美国账户和非美国账户之间可能会产生不同的盈亏归因结果。

    来源NFA Compliance Rule 2-43b

  4. 04 · 母公司变更

    FOREX.com 于 2017 年承接了 FXCM 的美国零售业务；StoneX 于 2020 年收购了 GAIN

    FOREX.com 历史上有两次重要的股权变更事件。首先，2017 年 2 月，CFTC 永久禁止 FXCM 参与美国零售外汇业务，FXCM 随后将其美国客户账户转移给当时已运营 FOREX.com 的 GAIN Capital。其次，StoneX Group Inc. (NASDAQ: SNEX) 于 2020 年 7 月收购了 GAIN Capital。因此，当前的 FOREX.com 实体是一家支持美国客户接入的经纪商（通过 GAIN Capital Group LLC），拥有纳斯达克上市的母公司背景，并且是 FXCM 美国零售业务的正式继承者。

    来源CFTC 2017 FXCM press releaseStoneX completes GAIN Capital acquisition (July 2020)

  5. 05 · 美国产品范围

    美国客户仅能交易 CFTC 允许的零售产品子集，而非 FOREX.com 的完整国际版产品列表

    根据 CFTC 零售规则，GAIN Capital Group LLC 的美国客户可以交易现货外汇以及监管机构允许的指数和金属产品。英国、澳大利亚和开曼实体提供的许多 CFD 产品（例如股票 CFD）并不向美国零售客户提供。如果策略中硬编码了股票 CFD 品种，在针对美国实体下单时将会失败。如果您的代码需要跨实体运行，请在启动时通过 API 读取可用交易品种，并根据实体进行分支处理。

    来源FOREX.com US product disclosures

  6. 06 · 交易报告

    Dodd-Frank、EMIR 和 ASIC 报告由 FOREX.com 负责

    GAIN Capital Group LLC 作为 CFTC RFED，根据 Dodd-Frank Title VII 掉期数据报告规则进行报告。GAIN Capital UK Limited 根据 FCA / MiFID II / EMIR 规则进行报告。StoneX Financial Pty Ltd 根据 ASIC 衍生品交易报告规则进行报告。TradingHost 不会代表您进行监管交易报告，亦不提供报告服务。您在 TradingHost 上运行的策略代码属于您个人的算法活动；报告义务归属于持有您账户的 FOREX.com 实体。

    来源NFA BASIC database (GAIN Capital Group LLC)

第 06 节 · 适用对象

适用对象

TradingHost FOREX.com 运行环境最适合：

  • 在 AI IDE（Cursor、Claude Code）中构建策略的开发者
  • 支持美国接入的算法外汇交易员（了解 NFA Rule 2-43b）
  • 使用 StoneX-GAIN 基础设施的量化外汇策略开发者
  • 指数和金属系统化交易员
  • 正在从 MetaTrader 和 VPS 托管转向容器化部署的团队

连接 GitHub 并创建您的首个策略是免费的。

第 08 节 · 常见问题

常见问题

不是。TradingHost 是独立的，不隶属于 FOREX.com、GAIN Capital、StoneX Group 或任何 City Index 实体。

不是。TradingHost 不是经纪商，也不是注册投资公司。TradingHost 是一个运行您策略代码的云端运行环境。经纪商关系、账户、杠杆、执行以及监管保护均由持有您账户的 FOREX.com 实体提供。

不会。您的策略代码会连接到 FOREX.com 的 REST API，并根据您自己的逻辑发送指令。TradingHost 仅提供运行该代码的运行环境。

不提供。FOREX.com REST API 访问权限由 FOREX.com (GAIN Capital / StoneX) 提供。您需要向 FOREX.com 支持团队申请启用实盘 API，并自行负责您的账户、凭据以及对 FOREX.com 条款的遵守。

是的。GAIN Capital Group LLC 已在 CFTC 注册且为 NFA 会员，FOREX.com 美国实体接受美国零售客户。在 TradingHost 的 US-East 区域运行的策略与该美国实体自然匹配。请注意，此处适用 NFA Rule 2-43b：单一品种不得对冲，且订单按 FIFO 原则撮合。

可以。FOREX.com REST API 基于 HTTP，任何 Python HTTP 客户端均可使用。WebSocket 流式传输端点可以使用任何标准 Python WebSocket 库进行对接。

可以。TradingHost 支持任何可在容器内运行的语言。FOREX.com REST 基于 HTTP，流式传输端点基于 WebSocket，因此任何拥有 HTTP 和 WebSocket 客户端的语言均可使用。

FOREX.com 在某些实体中提供 MT4 和 MT5。如果您的策略是 MQL Expert Advisor (EA)，该 EA 会在 MetaTrader 终端内运行，传统上需要 Windows VPS。若要使用 TradingHost，请将逻辑移植到 FOREX.com REST，这才是与 TradingHost 兼容的形式。

开立 FOREX.com 账户，向支持团队发送电子邮件以在实盘账户上启用 REST（或使用默认已启用 REST 的模拟账户）。Fork 一个 TradingHost FOREX.com REST 模板，或连接您自己的 GitHub 策略仓库。关联 GitHub 仓库和创建策略是免费的；运行环境方案已列在定价页面上。

可以。杠杆比例由持有您账户的 FOREX.com 实体决定。GAIN Capital Group LLC（美国，适用 NFA Rule 2-43b）：主要货币对为 50:1，非主要货币对为 20:1。GAIN Capital UK (FCA) 和 StoneX Financial Pty Ltd (ASIC) 适用与 ESMA 一致的上限。根据 CIMA 规则，开曼实体可能允许更高的杠杆。各实体的 API 接口是相同的。

保存在您通过 GitHub 控制的 secrets 工作流中。TradingHost 在运行时通过 GitHub 仓库 secrets、环境 secrets 或您自己认可的密钥管理流程来读取 FOREX.com 用户名、密码（或 AppKey）以及 session token 生命周期。

可以。TradingHost 支持针对 AI IDE（包括 Cursor、Claude Code、GitHub Copilot 和基于 CLI 的 AI 智能体）的基于 MCP 的控制。AI 工具可以检查部署、查看日志、重启策略并管理运行环境工作流。MCP 是一个控制和可观测性接口，绝非交易执行路径。

不。Dodd-Frank、EMIR 和 MiFID II 交易报告是经纪商的责任。GAIN Capital Group LLC 根据 Dodd-Frank Title VII 掉期数据报告规则进行报告。GAIN Capital UK 根据 MiFID II 和 EMIR 进行报告。StoneX Financial Pty Ltd 根据 ASIC 规则进行报告。TradingHost 负责运行您的代码，而持有您账户的 FOREX.com 实体负责处理监管报告。

不。TradingHost 专注于生产环境的运行和部署。回测属于您的研究技术栈，应在 NautilusTrader 等框架或 AlgoBuilder 中进行。