适用于 Capital.com 交易策略的 AI 原生运行环境
在 Cursor、Claude Code 或任何 AI IDE 中编写 Capital.com REST 和 WebSocket 策略。从 GitHub 部署到托管云端运行环境,享有卓越的 MCP 控制、日志和区域选择。
第 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 集合使得上手速度快于大多数竞争对手经纪商。
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 实体。
✓ 根据 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
- 保持运行环境在线。
- 呈现日志和健康检查。
- 区域选择。
- 受控的部署面板。
部署流程
- 步骤 01
连接 GitHub
授权 TradingHost 访问您的 GitHub 账户。
- 步骤 02
关联代码库或从框架起步
将 TradingHost 指向您现有的策略仓库,或者派生 (fork) 一个 TradingHost Capital.com REST + WebSocket 模板(capitalcom-python 或您自己的实现)。
- 步骤 03
部署到 TradingHost 容器中
选择一个区域(针对 Capital Com UK / 塞浦路斯 / 欧盟流量选择 EU;若搭配美国市场数据则选择 US-East),提供策略所需的环境变量(X-CAP-API-KEY、用于创建会话的账户邮箱和密码、模拟或实盘主机),然后进行部署。TradingHost 会从代码仓库构建您的容器,并在托管的 Kubernetes 基础设施上运行您的策略。
- 步骤 04
监控日志和健康状况
从 TradingHost 控制台查看实时日志、健康状况和运行状态。任何 AI IDE 都可以通过 MCP 访问相同的面板,因此 Cursor、Claude Code 或 CLI 代理可以与您一同读取部署状态并管理运行环境。
- 步骤 05
更新与重新部署
将更改推送到您的 GitHub 主分支,TradingHost 将自动重新部署。
章节 05 · 运维说明
Capital.com 运维说明
在容器化云运行环境中实际运行 Capital.com 策略时需要注意的潜在问题。以下所有说明均转述自 Capital.com 的 API 文档、已发布的 Postman 集合或相关监管机构;部署侧的指南则源自我们在 TradingHost 上运行这些策略的实际经验。
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 错误。
02 · 域名区分
实盘与模拟盘域名独立,API 密钥不可混用
实盘域名为 api-capital.backend-capital.com,模拟盘域名为 demo-api-capital.backend-capital.com。API 密钥是在 Capital.com 开发者门户中针对实盘或模拟盘账户分别注册的。实盘密钥无法在模拟盘域名上通过验证,反之亦然。请将实盘和模拟盘密钥保存在 TradingHost Secrets 的不同条目中,切勿在不同环境之间共用同一个 .env 文件。
03 · Postman 快速上手
github.com/capital-com-sv 上的官方 Postman 集合可加速首日探索
Capital.com 在 github.com/capital-com-sv/capital-api-postman 发布了官方 Postman 集合。该集合涵盖了所有已记录的端点及示例载荷,是获取新 API 密钥后实现首次成功请求的最快途径。典型的上手流程是将该集合导入 Postman,设置环境变量,请求 /session 并开始探索;生产环境的策略应当是从 Postman 移植到代码中,而不是相反。
04 · WebSocket 流式传输
实时价格和交易事件通过独立的 WebSocket 连接传输
Capital.com 提供了与 REST 接口分离的 WebSocket 流式传输接口,用于获取实时价格和交易事件。请通过文档中记录的 WebSocket 消息协议进行订阅,切勿通过轮询 REST 接口来获取价格。WebSocket 连接需要使用相同的会话令牌(CST 和 X-SECURITY-TOKEN)进行身份验证。重连逻辑必须能够处理会话令牌过期的情况,这可能会在会话进行期间发生。
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 接口完全相同,但在策略中硬编码杠杆意味着您默认了特定的实体。
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 中进行。