适用于 CoinW 交易策略的 AI 原生运行环境
在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署到托管云端运行环境，享有原生 MCP 控制、日志查看与区域选择支持。
第 01 部分 · 一览
一览
- 交易平台
- CoinW
- 平台类型
- 加密货币交易所（总部位于迪拜，面向全球）
- 资产类别
- 加密货币
- 支持的产品
- 现货交易、永续合约（`/v1/perpum/` 接口）、copy trading 与 strategy-square（仅限平台内，API 仅部分开放）。对美国、加拿大、日本、英国账户实施 geo-IP 屏蔽。
- 运行环境模式
- 容器化策略运行环境
- 部署源
- GitHub
- 编程语言
- 任何可在容器中运行的语言
- 常用集成
- 原生 CoinW OpenAPI（REST 和 WebSocket）、CCXT、自定义连接器。现货 (api.coinw.com) 与合约 (ws.futurescw.com/perpum) 采用不同的基础 URL。
- AI 工作流集成
- 适用于 Cursor、Claude Code、GitHub Copilot 及 CLI 智能体的 MCP 控制面板
- TradingHost 角色
- 运行环境、部署、日志、健康检查、区域选择、MCP 控制
- CoinW 角色
- 交易所账户、API 接入、市场接入、执行场所
- 关联关系
- TradingHost 保持独立，与 CoinW 无任何隶属关系
第 02 部分 · CoinW 平台功能
CoinW 平台功能
CoinW 通过 CoinW OpenAPI 提供现货和永续合约交易。该交易所将 REST 和 WebSocket 接口拆分在现货 (api.coinw.com) 和合约 (ws.futurescw.com/perpum) 两个不同的基础 URL 下，因此客户端封装库必须根据市场类型进行路由。平台虽然提供 copy trading 和 strategy-square 功能，但仅开放了部分 API 访问权限。针对美国、加拿大、日本、英国账户，平台在 IP 和 KYC 层面实施服务限制。具体接口细节可能会随时间变化。虽然整体架构保持稳定，但具体的频率限制权重、交易对列表和手续费档位请以 CoinW 官方文档为准。
市场与策略模式
- 基于 USDT、BTC 和 ETH 报价对的现货交易
- 永续合约（`/v1/perpum/` 接口）
- 按接口系列订阅 WebSocket（现货与合约相互独立）
- 针对用户自主下单的 OpenAPI 客户端侧过滤
- 跨现货/合约 URL 拆分的多策略部署
- USDT 永续合约的资金费率套利
- 兼容 strategy-square 和 copy trading 的订单过滤（API 会对跟单仓位返回错误）
- 针对特定地理区域的账户管辖权处理（拒绝美国、加拿大、日本、英国用户）
API 接口
- 产品范围
- 现货与永续合约。平台虽然提供 copy trading 和 strategy-square 功能，但仅开放了部分 API 访问权限；尽管前端 UI 会将跟单、strategy-square 和用户自主下单的订单合并显示，但通过 OpenAPI 对跟单仓位进行调用时会返回错误。
- 连接方式
- 现货订单及账户查询使用 REST API，地址为 `https://api.coinw.com`。合约使用 WebSocket，地址为 `wss://ws.futurescw.com/perpum`。现货 REST 与合约 WebSocket 基础 URL 拆分是 CoinW 特有的架构设计；集成客户端必须根据市场类型硬编码路由，而不能假定所有接口都属于同一个域名系列。
- 身份验证
- 每个策略配置独立的 API key 和 secret，并使用 HMAC 签名请求。可针对每个密钥配置权限范围。针对美国、加拿大、日本、英国，平台在 IP 和 KYC 居住地层面实施服务限制；在这些管辖区内签发的 API key 无法下单。
具体细节请参考 CoinW
具体接口、频率限制权重、交易对列表、手续费档位和版本历史请参阅 CoinW 官方文档。请以官方文档为准。
第 03 部分 · 用 AI 构建
用 AI 构建您的 CoinW 策略
选择一种集成方式，Fork 一个 TradingHost 框架模板，然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI Agent 均可无缝接入相同的 GitHub 原生部署循环。
原生 CoinW API
直接控制 CoinW 的特定行为、现货与合约 URL 的拆分，以及处理跟单 API 的特殊机制。
Freqtrade 或 Hummingbot
目前这两个框架均未将 CoinW 列为原生支持的交易所。官方文档推荐的路径是采用自定义实现或基于 CCXT 的实现。
自定义连接器
您自己的内部交易引擎，或跨 api.coinw.com 和 ws.futurescw.com 基础 URL 的专属 CoinW 集成方案。
框架对 CoinW 产品的支持情况
不同框架的支持程度有所不同。CCXT 通过其统一的 `coinw` 类支持 CoinW 现货，对合约的支持较为有限。目前 Freqtrade 和 Hummingbot 均未将 CoinW 列为原生支持的交易所。通过原生 API 访问则可直接对接现货 (api.coinw.com) 和合约 (ws.futurescw.com/perpum) 两个接口系列。
✓ 表示官方框架文档确认支持。“no” 表示官方文档未说明支持。“partial” 表示支持有限。工作流链接指向目前正在撰写的 /workflows/ 页面。
TradingHost 不强求特定的框架，它只负责运行您的项目。
使用 AI 编写
上述框架模板与 AI IDE 是绝佳的搭配。TradingHost 的 MCP 控制面实现了闭环：AI 工具可以与您一同检查部署、查看日志并管理运行环境，但绝不会介入交易执行路径。
Section 04 · 在 TradingHost 上运行
在 TradingHost 上运行您的代码
CoinW 提供交易所和 API 访问。TradingHost 则提供生产环境，用于运行您连接到 CoinW 的策略。
无需在笔记本电脑、台式机、通用 VPS 或手动配置的服务器上运行策略代码，您只需从 GitHub 部署到由 TradingHost 托管的容器运行环境中。
您
- 您的代码库包含您的代码。
- 您的部署定义了其运行方式。
- 您的策略连接到 CoinW。
TradingHost
- 保持运行环境持续在线。
- 呈现日志和健康状况检查。
- 区域选择。
- 受控的部署环境。
部署流程
- 步骤 01
连接 GitHub
授权 TradingHost 访问您的 GitHub 帐户。
- 步骤 02
关联代码库或从框架开始
将 TradingHost 指向您现有的策略仓库，或者 fork 一个 TradingHost 框架运行环境 (CCXT)，以此作为对接 CoinW OpenAPI 的可用基线。
- 步骤 03
部署至 TradingHost 容器
选择一个区域（EU 或 US-East），提供策略所需的环境变量（CoinW API key 和 secret、现货与期货的基础 URL 设置），然后进行部署。TradingHost 会根据代码仓库构建您的容器，并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。
- 步骤 04
监控日志与健康状况
通过 TradingHost 控制面板实时查看日志、健康状况和运行状态。该界面同样支持在任何 AI IDE 中通过 MCP 进行访问，方便 Cursor、Claude Code 或 CLI 智能体与您协同读取部署状态并管理运行环境。
- 步骤 05
更新与重新部署
将代码更改推送到 GitHub 的主分支（main branch），TradingHost 便会自动重新部署。
Section 05 · 运维说明
CoinW 运维说明
在容器化云端运行环境中实际运行 CoinW 策略时可能遇到的暗坑，这些内容在 CoinW 文档或框架的 README 中是找不到的。以下所有说明均提炼自 CoinW 官方文档；部署侧的指南则源自我们在 TradingHost 上运行这些策略的实际经验。
01 · URL 拆分
现货 REST 与合约 WebSocket 位于不同的基础 URL
CoinW 将其 API 拆分在两个基础 URL 之间：现货 REST 位于 `https://api.coinw.com`，合约 WebSocket 位于 `wss://ws.futurescw.com/perpum`。这种拆分方式较为少见；大多数交易所都在同一个根域名下通过路径级别来区分现货和衍生品。集成客户端必须在 URL 级别（而不仅仅是在接口路径级别）根据市场类型进行路由。如果策略为这两种产品硬编码了同一个基础 URL，在路由问题修复之前，另一个市场将会出现静默失败。
02 · 跟单机制特殊性
尽管 UI 将跟单和 strategy-square 仓位合并列出，但 OpenAPI 会对此类仓位返回错误
CoinW 平台在统一的订单历史视图中同时显示 copy trading 持仓、strategy-square 持仓和用户自主创建的订单。但 OpenAPI 并非如此。针对 copy trading 或 strategy-square 持仓的 API 调用会返回错误，而针对用户自主创建订单的调用则能成功。如果策略在没有客户端过滤的情况下遍历订单列表，那么在遇到每个 copy trading 或 strategy-square 持仓时都会报错，这会拉低请求成功率并引发重试风暴。在调用订单管理接口之前，请务必先在客户端过滤出用户自主创建的订单。
03 · 地域限制
在 IP 和 KYC 层面拒绝为美、加、日、英账户提供服务
CoinW 不向美国、加拿大、日本和英国的用户提供账户，也不接受来自这些地区的 API 流量。该限制在 IP (geo-IP) 和 KYC 居住地层面强制执行。使用美国居住地 CoinW 账户进行身份验证的策略在下单时将会失败，无论云运行环境的出口 IP 是什么；将容器迁移到未受限制的地区也无法绕过美国 KYC 账户的限制。请将账户管辖区视为硬性限制，而非运行环境的出口 IP。
04 · 期货接口
`/v1/perpum/` 路径系列用于处理永续合约
CoinW 永续合约接口位于 `/v1/perpum/` 路径系列下。现货和永续合约的交易对信息、保证金要求和订单管理接口各不相同；现货路径树和期货路径树不能混用。一个常见的隐蔽 Bug 是针对永续合约交易对调用现货风格的交易对信息接口，从而收到 404 或空响应。请在您的客户端封装中明确区分现货与期货的路径系列。
05 · 错误代码
依赖文档中记录的错误代码参考，而非根据 HTTP 状态码进行推测
CoinW 发布了结构化的错误代码参考，将响应代码映射到根本原因（身份验证、参数、限流、业务规则）。仅凭 HTTP 状态码无法传达实际的失败原因；响应体中包含指明原因的 CoinW 特定代码。根据 HTTP 状态码进行分支判断的重试循环，可能会针对永远不会成功的业务规则拒绝进行重试。请改为根据文档中记录的错误代码进行分支判断。
06 · 提币权限范围
策略绝不应加载具有提币权限的密钥
CoinW 支持具有独立读取、交易和提币权限的细分 API 密钥。策略绝不需要提币权限。请将提币权限保留在固定主机上独立手动管理的密钥中，且不让任何策略加载该密钥，而为策略配置的密钥仅包含交易和读取权限。泄露的仅限交易的密钥无法将资金转移出交易所，而泄露的具有提币能力的密钥则可以。
Section 06 · 适用场景
适用场景
TradingHost CoinW 运行环境最适合用于：
- 在 AI IDE（Cursor、Claude Code）中构建策略的开发者
- 系统化加密货币交易员
- 量化开发人员
- CCXT 用户
- 正在从 VPS 托管转向容器化部署的团队
连接 GitHub 并创建首个策略完全免费。
Section 08 · 常见问题
常见问题
没有。TradingHost 是独立的，与 CoinW 没有任何隶属或合作关系。
不会。您的策略代码会连接 to CoinW，并根据您自己的逻辑、账户权限和集成方式发送指令。TradingHost 仅提供运行该代码的运行环境。
不提供。CoinW API 访问权限由 CoinW 提供。您需要自行负责您的 CoinW 账户、API 权限、凭据以及对 CoinW 条款的合规性。
不是。TradingHost 是运行您策略代码的云端运行环境。我们不提供信号、AI 预测模型或预建的机器人。使用 TradingHost，您可以自己编写或生成策略（通常使用 Cursor 或 Claude Code），将其作为代码保存在 GitHub 中，并使用 TradingHost 在生产环境中运行它。3Commas、Cryptohopper 及类似产品拥有策略逻辑，而 TradingHost 则是运行您自己的策略。
AWS 和 DigitalOcean 为您提供的是原始算力。您需要自己处理操作系统更新、容器编排、日志传输、密钥轮换、区域故障转移和运行时间监控。而 TradingHost 为您提供的是专为交易策略打造的托管运行环境：开箱即用的 GitHub 原生部署、源自 AI IDE 的 MCP 驱动控制、日志和健康状态面板。如果您想自己运营基础设施，AWS 可以满足需求。如果您希望将运行环境作为托管服务，TradingHost 是更便捷的途径。
可以。TradingHost 支持运行 Python 策略；您可以选择与您的技术栈匹配的框架运行环境，或者部署您自己的仓库。
可以。TradingHost 支持任何可以在容器内运行的语言。
可以。CCXT 提供了一个涵盖现货交易的统一 `coinw` 类；对期货的支持是部分的。将您的 CCXT 策略放入容器中，将其指向 GitHub，TradingHost 就会像运行任何其他 Python 或 Node 项目一样运行它。有关完整的设置说明，请参阅 CCXT 框架运行环境。
可以。CoinW 永续合约可以通过独立基础 URL（WebSocket 为 `wss://ws.futurescw.com/perpum`）上的 `/v1/perpum/` 接口系列进行访问。您容器内的策略代码必须根据市场类型进行路由，因为现货接口位于 `api.coinw.com`，而期货接口位于 perpum 子域名。TradingHost 在运行环境级别是与交易所无关的；关键在于您的代码要正确处理 URL 的拆分。
可以，只要您的项目是这样设计的。您可以在一个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中，以实现隔离和运行清晰度。有关多策略模型的更多信息，请参阅 TradingHost 运行环境页面。
最快的方法是 fork 一个 TradingHost 框架运行环境：例如使用 CCXT 获取开箱即用的项目。或者连接您自己的 GitHub 策略仓库。关联 GitHub 仓库和创建策略是免费的；运行环境方案已在定价页面列出。
保存在您由 GitHub 控制的机密（secrets）工作流中。TradingHost 在运行时通过 GitHub 仓库机密、环境机密或您自己认可的机密管理流程读取它们。TradingHost 不需要托管您的 API 密钥和私钥。有关完整的处理模型，请参阅平台机密。
不需要。策略绝不应该需要提币权限。请将您的 API 密钥权限范围缩小到仅限交易和账户状态读取，并完全关闭该密钥的提币权限。
可以。TradingHost 支持针对 AI IDE 的基于 MCP 的控制，包括 Cursor、Claude Code、GitHub Copilot 和基于 CLI 的 AI 智能体。AI 工具可以检查部署、查看日志、重启策略并管理运行环境工作流。MCP 是一个控制和可观测性界面，而不是交易执行路径。有关完整信息，请参阅 MCP 控制界面。
两者皆可。MCP 控制界面在基于 CLI 的智能体（Claude Code CLI、自定义 MCP 客户端、脚本化 MCP 调用）和 IDE 内部同样表现出色。GitHub 原生部署循环在没有任何 AI 工具的情况下也能正常工作：向您的 main 分支进行常规的 git push 即可触发重新部署。
运行环境会检测到崩溃并展示相关的日志和健康信息。在支持的情况下，可以重启受影响的策略，而不会干扰在同一容器中运行的其他策略。您的策略代码仍需负责安全的错误处理、重复订单保护和风险控制。有关日志和健康状况界面，请参阅可观测性。
CoinW 平台 UI 在统一视图中同时显示 copy trading 持仓、strategy-square 持仓和用户自主创建的订单。尽管这些持仓与用户自主创建的订单并排显示，但针对 copy trading 或 strategy-square 持仓调用 OpenAPI 时会返回错误。如果策略在没有进行客户端过滤的情况下遍历订单列表，则在遇到每个 copy trading 或 strategy-square 持仓时都会报错，从而降低请求成功率并引发重试风暴。在调用订单管理接口之前，请先在客户端过滤出用户自主创建的订单。完整指南请参阅上方的“运行说明”部分。
TradingHost 运行在 EU 和 US-East 区域。请选择最靠近您策略所依赖的撮合引擎的区域。注意：CoinW 在 KYC 居住地层面限制了美国、加拿大、日本和英国账户；选择未受限制的 TradingHost 区域并不能绕过账户居住地的限制。有关路由和延迟的详细信息，请参阅区域页面。
不支持。TradingHost 专注于生产环境的运行和部署。回测应当在您的研究技术栈、框架或 AlgoBuilder 中进行。