阅读时间 … 分钟

适用于 Capital.com 交易策略的 AI 原生运行环境

在 Cursor、Claude Code 或任何 AI IDE 中编写 Capital.com REST 和 WebSocket 策略。从 GitHub 部署到托管云端运行环境,享有卓越的 MCP 控制、日志和区域选择。

由 TradingHost 工程团队撰写

第 01 节 · 一览

一览

经纪商
Capital.com
经纪商类型
零售外汇和 CFD 经纪商
资产类别
外汇、股指 CFD、商品 CFD、股票 CFD、ETF CFD、加密货币 CFD(取决于具体实体)
支持的产品
超过 6,000 种可交易工具,涵盖现货外汇、股指、商品、股票 CFD、ETF CFD 以及(取决于具体实体)加密货币 CFD。面向零售客户,提供简洁的 API。
运行环境模型
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
Capital.com REST API、Capital.com WebSocket 流媒体、capitalcom-python (PyPI 封装包)、官方 Postman 集合、自定义连接器
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
Capital.com 角色
经纪商账户、API 访问、市场准入、执行场所
监管机构
Capital Com (UK) Limited (英国 FCA 机构参考号 793714);Capital Com Australia Pty Ltd (澳大利亚 ASIC AFSL 513393);Capital Com SV Investments Limited (塞浦路斯 CySEC 牌照 319/17);Capital Com Online Investments Ltd (巴哈马 SCB);Capital Com FSA Seychelles 塞舌尔离岸实体。
零售杠杆上限
英国 (Capital Com UK, FCA) 和欧盟 (Capital Com SV, CySEC, 符合 ESMA 标准):主要外汇 30:1,非主要外汇和黄金 20:1,非黄金商品和非主要股指 10:1,股票 5:1,加密货币 CFD 2:1。澳大利亚 (ASIC):与 ESMA 限额一致。巴哈马 (SCB) 和塞舌尔 (FSA) 实体可能允许更高的杠杆。
托管服务器
实盘 REST 主机:api-capital.backend-capital.com。模拟盘 REST 主机:demo-api-capital.backend-capital.com。WebSocket 流媒体端点是独立的,并在 open-api.capital.com 参考文档中进行了说明。
关联关系
TradingHost 是独立的,不隶属于 Capital.com 或任何 Capital Com 实体

第 02 节 · Capital.com 支持概况

Capital.com 支持概况

Capital.com 通过简洁的 REST 和 WebSocket API 提供超过 6,000 种可交易工具,涵盖外汇、股指、商品、股票 CFD 和 ETF。身份验证采用类似于 IG Labs 的会话令牌模型。官方 Postman 集合可加速上手过程。具体端点信息请参阅 open-api.capital.com。

市场与策略模式

  • 针对 6,000 多种工具的 Capital.com REST 策略
  • 70 多种外汇货币对的系统化策略
  • 主要和次要股指 CFD 突破策略
  • 用于价格和交易事件的 WebSocket 流媒体
  • 基于 Postman 集合引导的开发
  • 基于 capitalcom-python 封装包的策略
  • 经模拟盘验证并晋升至实盘的部署

API 接口

产品接口
6,000 多种可交易工具:70 多种现货外汇货币对、主要和次要股指 CFD、商品 CFD(金属、能源、软商品)、股票 CFD 和 ETF CFD。加密货币 CFD 的可用性取决于具体的 Capital Com 实体。
连接方式
用于订单、账户、持仓、自选股和市场数据的 Capital.com REST API。用于实时价格和交易事件的 WebSocket 流媒体。实盘主机:api-capital.backend-capital.com。模拟盘主机:demo-api-capital.backend-capital.com。
身份验证
类似于 IG Labs 的基于会话的身份验证:X-CAP-API-KEY(长期 API 密钥)以及由 POST /session 返回的 CST 和 X-SECURITY-TOKEN 会话令牌。会话令牌会过期,必须进行刷新。模拟盘和实盘 API 密钥在 Capital.com 开发者门户中分别发放。

具体细节请参考 Capital.com

Capital.com API 开发指南和 open-api.capital.com 参考文档是权威的信息来源。位于 github.com/capital-com-sv/capital-api-postman 的 Postman 集合是快速探索 API 接口的最快方式。

第 03 节 · 使用 AI 构建

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

选择一种集成方式,派生 (fork) 一个 TradingHost 框架模板,并在 AI IDE 中编写您的策略。Capital.com 的 REST + WebSocket 接口简洁且文档齐全。其 Postman 集合使得上手速度快于大多数竞争对手经纪商。

  • 原生 Capital.com REST + WebSocket

    直接控制 Capital.com 的行为、会话令牌、账户状态和 WebSocket 流媒体接口。

  • capitalcom-python

    围绕 Capital.com REST 和 WebSocket 的社区 Python 封装包。为 Python 算法开发者提供便捷的开发体验。

  • 官方 Postman 集合

    Capital.com 发布了官方 Postman 集合。可用于交互式探索;生产环境策略通常会从 Postman 移植到代码中。

  • 自定义连接器

    您自己在 Capital.com REST 和 WebSocket 之上构建的 Python、Java、.NET 或 Go 集成。

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

Capital.com REST + WebSocket 覆盖了整个零售 CFD 产品线。capitalcom-python 社区封装包镜像了 REST 的覆盖范围。加密货币的可用性取决于具体的 Capital Com 实体。

框架外汇指数商品CFD加密货币 CFD
Capital.com REST + WebSocket支持支持支持支持部分支持
capitalcom-python支持支持支持支持部分支持
Postman / custom HTTP支持支持支持支持部分支持
NautilusTrader未记录支持未记录支持未记录支持未记录支持未记录支持

✓ 根据 open-api.capital.com 确认支持。“取决于具体实体”意味着可用性取决于具体的 Capital Com 实体。工作流链接指向目前正在编写的 /workflows/ 页面。

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

AI 辅助编写

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

章节 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

Capital.com 提供经纪商账户、REST API 和 WebSocket 流媒体。TradingHost 提供运行您连接到 Capital.com 的策略的生产环境。

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 账户。

  2. 步骤 02

    关联代码库或从框架起步

    将 TradingHost 指向您现有的策略仓库,或者派生 (fork) 一个 TradingHost Capital.com REST + WebSocket 模板(capitalcom-python 或您自己的实现)。

  3. 步骤 03

    部署到 TradingHost 容器中

    选择一个区域(针对 Capital Com UK / 塞浦路斯 / 欧盟流量选择 EU;若搭配美国市场数据则选择 US-East),提供策略所需的环境变量(X-CAP-API-KEY、用于创建会话的账户邮箱和密码、模拟或实盘主机),然后进行部署。TradingHost 会从代码仓库构建您的容器,并在托管的 Kubernetes 基础设施上运行您的策略。

  4. 步骤 04

    监控日志和健康状况

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

  5. 步骤 05

    更新与重新部署

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

章节 05 · 运维说明

Capital.com 运维说明

在容器化云运行环境中实际运行 Capital.com 策略时需要注意的潜在问题。以下所有说明均转述自 Capital.com 的 API 文档、已发布的 Postman 集合或相关监管机构;部署侧的指南则源自我们在 TradingHost 上运行这些策略的实际经验。

  1. 01 · 会话认证

    每次进行身份验证的请求都需要 X-CAP-API-KEY、CST 和 X-SECURITY-TOKEN

    Capital.com REST 采用与 IG Labs 非常相似的会话令牌模型。X-CAP-API-KEY 是在 Capital.com 开发者门户中注册的长效 API 密钥。通过 POST /session 提交该 API 密钥、账户邮箱和密码后,会返回 CST 和 X-SECURITY-TOKEN 响应头;后续经过身份验证的调用必须包含这三个请求头。CST 和 X-SECURITY-TOKEN 会过期,必须进行刷新。如果策略仅缓存会话令牌而没有设计刷新路径,在会话窗口关闭后将开始返回 401 错误。

  2. 02 · 域名区分

    实盘与模拟盘域名独立,API 密钥不可混用

    实盘域名为 api-capital.backend-capital.com,模拟盘域名为 demo-api-capital.backend-capital.com。API 密钥是在 Capital.com 开发者门户中针对实盘或模拟盘账户分别注册的。实盘密钥无法在模拟盘域名上通过验证,反之亦然。请将实盘和模拟盘密钥保存在 TradingHost Secrets 的不同条目中,切勿在不同环境之间共用同一个 .env 文件。

  3. 03 · Postman 快速上手

    github.com/capital-com-sv 上的官方 Postman 集合可加速首日探索

    Capital.com 在 github.com/capital-com-sv/capital-api-postman 发布了官方 Postman 集合。该集合涵盖了所有已记录的端点及示例载荷,是获取新 API 密钥后实现首次成功请求的最快途径。典型的上手流程是将该集合导入 Postman,设置环境变量,请求 /session 并开始探索;生产环境的策略应当是从 Postman 移植到代码中,而不是相反。

  4. 04 · WebSocket 流式传输

    实时价格和交易事件通过独立的 WebSocket 连接传输

    Capital.com 提供了与 REST 接口分离的 WebSocket 流式传输接口,用于获取实时价格和交易事件。请通过文档中记录的 WebSocket 消息协议进行订阅,切勿通过轮询 REST 接口来获取价格。WebSocket 连接需要使用相同的会话令牌(CST 和 X-SECURITY-TOKEN)进行身份验证。重连逻辑必须能够处理会话令牌过期的情况,这可能会在会话进行期间发生。

  5. 05 · 多实体运营

    杠杆和可用产品取决于具体的 Capital Com 实体

    Capital Com (UK) Limited (FCA 793714)、Capital Com SV Investments Limited (CySEC 319/17)、Capital Com Australia Pty Ltd (ASIC AFSL 513393)、Capital Com Online Investments Ltd (巴哈马,SCB) 以及塞舌尔离岸实体均独立运营。英国、欧盟和澳大利亚实体适用与 ESMA 一致的 30:1 主要货币对杠杆上限。巴哈马和塞舌尔实体可能允许更高的杠杆。虽然各实体的 API 接口完全相同,但在策略中硬编码杠杆意味着您默认了特定的实体。

  6. 06 · 交易报告

    EMIR、MiFID II 和 ASIC 报告由 Capital.com 负责

    Capital Com (UK) Limited 根据 FCA / MiFID II / EMIR 规则进行报告。Capital Com SV Investments Limited 根据 CySEC / MiFID II / EMIR 规则进行报告。Capital Com Australia Pty Ltd 根据 ASIC 衍生品交易报告规则进行报告。巴哈马和塞舌尔实体则遵循其当地监管机构的规定。TradingHost 不会代表您进行监管交易报告,也不是报告服务商。您在 TradingHost 上运行的策略代码属于您个人的算法活动;报告义务归属于持有该账户的 Capital Com 实体。

第 06 节 · 适用对象

适用对象

TradingHost Capital.com 运行环境最适合:

  • 在 AI IDE(如 Cursor、Claude Code)中构建策略的开发者
  • 零售 CFD 系统化与量化交易员
  • 使用 capitalcom-python 的 Python 开发者
  • 优先使用 Postman 探索 API 并准备移植到生产环境的开发者
  • 正在从 MetaTrader 和 VPS 托管转向容器化部署的团队

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

第 08 节 · 常见问题

常见问题

不是。TradingHost 是独立的,不隶属于 Capital.com 或任何 Capital Com 实体。

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

不会。您的策略代码会连接 to Capital.com REST 和 WebSocket,并根据您自己的逻辑发送指令。TradingHost 仅提供运行该代码的运行环境。

不提供。Capital.com REST 和 WebSocket 的访问权限由 Capital.com 提供。您需要在 Capital.com 开发者门户中注册 X-CAP-API-KEY。您需自行负责您的 Capital.com 账户、凭据以及对 Capital.com 条款的合规性。

可以。社区 Python 封装库 capitalcom-python 以符合 Python 习惯的方式封装了 Capital.com REST 和 WebSocket。或者,您也可以使用任何 HTTP 客户端直接调用 Capital.com REST。

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

开立 Capital.com 账户,并在开发者门户中注册 X-CAP-API-KEY。导入官方 Postman 集合以探索接口。Fork 一个 TradingHost Capital.com 模板,或连接您自己的 GitHub 策略仓库。关联 GitHub 仓库和创建策略是免费的;运行环境方案已在定价页面列出。

可以。杠杆由 Capital Com 实体设定。Capital Com (UK) Limited (FCA) 和 Capital Com SV (CySEC) 适用与 ESMA 一致的限制(主要货币对为 30:1)。Capital Com Australia Pty Ltd (ASIC) 亦同。Capital Com Online Investments Ltd (巴哈马,SCB) 和塞舌尔离岸实体可能允许更高的杠杆。各实体的 API 接口完全相同。

保存在您通过 GitHub 控制的 Secrets 工作流中。TradingHost 在运行时通过 GitHub 仓库的 Secrets 读取 X-CAP-API-KEY 以及账户邮箱和密码(用于创建会话)。CST 和 X-SECURITY-TOKEN 是会话令牌,并非密钥,它们存在于进程内存中。

可以。TradingHost 支持针对 AI IDE(包括 Cursor、Claude Code、GitHub Copilot 和基于 CLI 的 AI 智能体)的基于 MCP 的控制。MCP 是一个控制和可观测性接口,而非交易执行路径。

不处理。EMIR 和 MiFID II 交易报告由经纪商负责。Capital Com (UK) Limited 根据 FCA / MiFID II / EMIR 规则进行报告。Capital Com SV 根据 CySEC / MiFID II / EMIR 规则进行报告。Capital Com Australia 根据 ASIC 衍生品交易报告规则进行报告。TradingHost 仅运行您的代码;监管报告由 Capital Com 实体处理。

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