CoinEx 交易策略的 AI 原生运行环境
在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署到托管云端运行环境，享有原生 MCP 控制、日志和区域选择支持。
第 01 部分 · 一览
一览
- 交易平台
- CoinEx
- 平台类型
- 加密货币交易所（全球，NYAG 和解后不再向美国新用户提供服务）
- 资产类别
- 加密货币
- 支持的产品
- 现货、永续及交割合约、全仓和逐仓杠杆。默认现货手续费为挂单/吃单 0.2%；月交易量达 100 万美元（现货）或 500 万美元（合约）时，可享受 Market Maker 返佣计划（挂单 -0.01%，吃单 0.05%）。
- 运行环境模式
- 容器化策略运行环境
- 部署源
- GitHub
- 编程语言
- 任何支持在容器中运行的语言
- 常用集成
- 原生 CoinEx API v2 REST 和 WebSocket、CCXT、自定义连接器
- AI 工作流集成
- 适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
- TradingHost 角色
- 运行环境、部署、日志、健康检查、区域选择、MCP 控制
- CoinEx 角色
- 交易所账户、API 访问、市场接入、执行场所
- 关联关系
- TradingHost 为独立平台，与 CoinEx 无任何隶属关系
第 02 部分 · CoinEx 平台功能
CoinEx 平台功能
CoinEx 通过 REST API V2 和 WebSocket V2 提供现货交易、永续及交割合约，以及全仓/逐仓杠杆交易。默认现货手续费为挂单/吃单 0.2%；当月交易量达到 100 万美元（现货）或 500 万美元（合约）时，可享受 Market Maker 返佣计划（挂单 -0.01%，吃单 0.05%）。在 NYAG 和解后，CoinEx 不再接受美国新用户注册，现有美国用户的账户余额仅支持提现。欧盟用户交易杠杆和合约产品需提供 MiCA 合规文件。具体 API 接口细节可能会随时间变化。虽然整体架构保持稳定，但具体的频控权重、交易对列表和费率层级请以 CoinEx 官方文档为准。
市场与策略模式
- 现货做市策略（月交易量达 100 万美元以获取 MM 返佣）
- 以 USDT 计价的永续合约策略
- 交割合约基差套利交易
- 现货全仓与逐仓杠杆策略
- USDT 永续合约资金费率套利策略
- 基于 WebSocket V2 的实时行情与账户数据流
- 按接口类别划分的 API 密钥权限范围（行情数据无需签名，账户接口需要签名）
- 单个 CoinEx 账户下的多策略部署
API 接口
- 产品范围
- 支持基于 USDT、BTC 等计价币对的现货交易、永续合约、交割合约、全仓及逐仓杠杆。现货默认挂单/吃单手续费为 0.2%。月交易量达 100 万美元（现货）或 500 万美元（合约）时，可享受 Market Maker 返佣计划（挂单 -0.01%，吃单 0.05%）；费率层级在每月 1 日 UTC 01:00 重新计算。
- 连接方式
- REST API V2 用于下单和账户查询。WebSocket V2 用于实时行情、深度和账户事件。行情接口无需签名；账户和交易接口需要签名。
- 身份验证
- 每个策略配置独立的 API 密钥（Key）和密钥密码（Secret）。API 密钥权限按接口类别划分：行情接口无需签名，账户和交易接口需要 HMAC 签名。策略运行绝不需要提币权限。
具体细节请参考 CoinEx
具体接口、频控权重、交易对列表、费率层级和版本历史请参阅 CoinEx 官方文档。请以官方文档为准。
第 03 部分 · 用 AI 构建
用 AI 构建您的 CoinEx 策略
选择一种集成方式，Fork 一个 TradingHost 框架模板，然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI Agent 均可无缝接入相同的 GitHub 原生部署循环。
原生 CoinEx API
直接控制 CoinEx 特有的行为、MM 层级计划、账户数据以及合约订单执行。
自定义连接器
您自己开发的内部交易引擎，或针对 API V2 REST 和 WebSocket 接口的专属 CoinEx 集成。
框架对 CoinEx 产品的支持情况
支持范围因框架而异。CCXT 通过统一的 `coinex` 类支持现货和合约。Hummingbot 的 `coinex` 连接器仅支持现货。Freqtrade 的官方支持交易所列表中未包含 CoinEx。使用原生 CoinEx API 则可访问 CoinEx 提供的所有功能，包括杠杆交易。
✓ 表示官方框架文档确认支持。“no” 表示官方文档未说明支持。“partial” 表示支持有限，详情请参见上文。
TradingHost 不强求特定的框架，它只负责运行您的项目。
使用 AI 编写
上述框架模板与 AI IDE 是绝佳的搭配。TradingHost 的 MCP 控制面实现了闭环：AI 工具可以与您一同检查部署、查看日志并管理运行环境，但绝不会介入交易执行路径。
Section 04 · 在 TradingHost 上运行
在 TradingHost 上运行您的代码
CoinEx 提供交易所和 API 访问。TradingHost 则提供生产环境，用于运行您连接到 CoinEx 的策略。
无需在笔记本电脑、台式机、通用 VPS 或手动配置的服务器上运行策略代码，您只需从 GitHub 部署到由 TradingHost 托管的容器运行环境中。
您
- 您的代码库包含您的代码。
- 您的部署定义了其运行方式。
- 您的策略连接到 CoinEx。
TradingHost
- 保持运行环境持续在线。
- 呈现日志和健康状况检查。
- 区域选择。
- 受控的部署环境。
部署流程
- 步骤 01
连接 GitHub
授权 TradingHost 访问您的 GitHub 帐户。
- 步骤 02
关联代码库或从框架开始
将 TradingHost 指向您现有的策略仓库，或者派生（fork）一个 TradingHost 框架运行环境（CCXT 或 Hummingbot），以获得对接 CoinEx API V2 的可用基线。
- 步骤 03
部署至 TradingHost 容器
选择一个区域（EU 或 US-East），提供您策略所需的环境变量（CoinEx API Key、Secret 和作用域权限），然后进行部署。TradingHost 会从代码仓库构建您的容器，并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。
- 步骤 04
监控日志与健康状况
通过 TradingHost 控制面板实时查看日志、健康状况和运行状态。该界面同样支持在任何 AI IDE 中通过 MCP 进行访问，方便 Cursor、Claude Code 或 CLI 智能体与您协同读取部署状态并管理运行环境。
- 步骤 05
更新与重新部署
将代码更改推送到 GitHub 的主分支（main branch），TradingHost 便会自动重新部署。
Section 05 · 运维说明
CoinEx 运维说明
在容器化云端运行环境中实际运行 CoinEx 策略时可能遇到的陷阱，这些内容在 CoinEx 文档或框架的 README 中并未提及。以下所有陈述均引用或转述自 CoinEx 官方文档；部署层面的指南则源自于在 TradingHost 上运行这些策略的实际经验。
01 · 美国账户
NYAG 和解后不再向美国新用户提供服务
根据 2023 年 2 月与纽约总检察长（New York Attorney General）达成的和解协议，CoinEx 被禁止为美国客户创建任何新账户，现有美国客户只能从平台提取其加密货币。CoinEx 还通过 IP 地址和 GPS 实施地理限制。使用美国居民 KYC 账户进行身份验证的策略在下单时将会失败，这与 API 密钥权限无关。请将账户管辖区视为硬性的运行限制，而非权限配置问题。
02 · Market Maker 层级
月交易量达 100 万美元（现货）或 500 万美元（合约）可享受 MM 返佣；费率层级在每月 1 日 UTC 01:00 重新计算
CoinEx 的 Market Maker 返佣计划在单账户月交易量达到 100 万美元现货或 500 万美元期货时，挂单（maker）费率可达 -0.01%，吃单（taker）费率可达 0.05%。费率层级在每月 1 日的 01:00 UTC 重新计算。在月中跨过门槛的策略要到下一个层级周期才能获得返佣，而在月中降至门槛以下的策略则会保留返佣直至下一次重置。请根据费率重置的节奏来规划资金部署，而不是仅盯着当前的月交易量。
03 · 端点签名
行情端点无需签名；账户和交易端点需要 HMAC 签名
CoinEx API V2 将端点分为已签名和未签名两类。行情数据端点（行情、深度、K 线）无需签名。账户状态、余额、下单和交易端点则需要 HMAC 签名。对每个请求都进行签名的策略代码会浪费 CPU 资源；而忘记对账户端点进行签名的代码则会导致身份验证失败。这一划分已在 API V2 参考文档中说明；请在您的客户端封装中对端点类别进行编码，而不是进行全局签名。
04 · 默认费率
默认现货费率为挂单/吃单 0.2%；请据此调整您的策略规模
在触发任何 MM 层级返佣之前，CoinEx 的默认现货费率为挂单 0.2% 和吃单 0.2%。这明显高于主流的全球交易平台（例如 Binance 在使用 BNB 折扣前的默认挂单/吃单费率为 0.1%）。从低费率平台移植过来的策略在 CoinEx 的默认费率层级下可能会处于亏损状态，直到交易量达到 MM 门槛。请使用实际的层级费率来构建您的优势模型，而不是使用理想化的返佣目标。
05 · 欧盟合规
欧盟杠杆和期货产品需提供 MiCA 证明文件
根据欧盟《加密资产市场监管法案》（MiCA）法规，CoinEx 要求欧盟居民提供额外文件才能使用杠杆和期货产品。如果针对 KYC 居住地在欧盟的 CoinEx 账户编写策略，在提交 MiCA 文件之前，期货和杠杆端点可能会返回权限错误。这是账户端而非 API 端的限制，运行环境（runtime）无法绕过它。在部署杠杆或期货策略之前，请先在 CoinEx 控制面板中确认您的账户 MiCA 状态。
06 · 密钥权限范围
按端点类别划分权限范围；切勿授予提币权限
CoinEx API 密钥权限是按端点类别划分范围的。策略绝不需要提币权限，不为密钥开启提币权限可以在密钥泄露时控制受损范围。正确的模式是为每个策略配置仅具有读取和交易权限的密钥；提币权限则保留在固定 IP 主机上单独手动管理的密钥中，任何策略都不会加载该密钥。
Section 06 · 适用场景
适用场景
TradingHost CoinEx 运行环境最适合用于：
- 在 AI IDE（Cursor、Claude Code）中构建策略的开发者
- 系统化加密货币交易员
- 量化开发人员
- CCXT 和 Hummingbot 用户
- 从 VPS 托管转向容器化部署的团队
连接 GitHub 并创建首个策略完全免费。
Section 08 · 常见问题
常见问题
没有。TradingHost 是独立的，与 CoinEx 没有任何隶属或合作关系。
不会。您的策略代码会根据您自己的逻辑、账户权限和集成方式连接 to CoinEx 并发送指令。TradingHost 仅提供运行该代码的运行环境（runtime）。
不提供。CoinEx API 访问权限由 CoinEx 提供。您需要自行负责您的 CoinEx 账户、API 权限、凭据以及对 CoinEx 条款的合规性。
不是。TradingHost 是运行您策略代码的云端运行环境（runtime）。我们不提供信号、AI 预测模型或预建的机器人。使用 TradingHost，您可以自己编写或生成策略（通常使用 Cursor 或 Claude Code），将其作为您自己的代码保存在 GitHub 中，并使用 TradingHost 在生产环境中运行它。3Commas、Cryptohopper 及类似产品拥有策略逻辑；而 TradingHost 则是运行您的策略。
AWS 和 DigitalOcean 为您提供的是原始算力。您需要自己处理操作系统更新、容器编排、日志传输、密钥轮换、区域容灾和运行时间监控。而 TradingHost 为您提供的是专为交易策略打造的托管运行环境：开箱即用的 GitHub 原生部署、来自 AI IDE 的 MCP 驱动控制、日志和健康状况监控界面。如果您想自己运营基础设施，AWS 可以满足需求。如果您希望将运行环境作为一项托管服务，TradingHost 是更快捷的途径。
可以。TradingHost 支持运行 Python 策略；您可以选择与您的技术栈匹配的框架运行环境，或者部署您自己的代码库。
可以。TradingHost 支持任何可以在容器内运行的语言。
可以。CCXT 提供了一个统一的 `coinex` 类，涵盖现货和期货交易。将您的 CCXT 策略放入容器中，将其指向 GitHub，TradingHost 就会像运行其他任何 Python 或 Node 项目一样运行它。有关完整的设置说明，请参阅 CCXT 框架运行环境页面。
可以。一旦您的账户符合条件，就可以通过 CoinEx API V2 进行永续和交割季度期货交易，以及全仓和逐仓杠杆交易。TradingHost 在运行环境级别与交易平台无关：任何能够通过期货或杠杆端点身份验证的代码都可以在容器内运行。欧盟居民在期货和杠杆端点响应之前，可能需要向 CoinEx 提交 MiCA 证明文件；这是账户端的检查，而非运行环境的检查。
可以，只要您的项目是这样设计的。您可以在一个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中，以实现隔离和运行清晰度。有关多策略模型的更多信息，请参阅 TradingHost 运行环境页面。
最快的方法是 fork 一个 TradingHost 框架运行环境：选择 CCXT 或 Hummingbot 以获取可直接部署的项目。或者连接您自己的 GitHub 策略代码库。关联 GitHub 代码库并创建策略是免费的；运行环境方案已在价格页面列出。
保存在您通过 GitHub 控制的机密（secrets）工作流中。TradingHost 在运行时通过 GitHub 仓库机密、环境机密或您自己认可的机密管理流程读取它们。TradingHost 不需要托管您的 API 密钥和私钥。有关完整的处理模式，请参阅平台机密页面。
不需要。策略绝不需要提币权限。请将您的 API 密钥权限范围缩小至仅限交易和账户状态读取，并完全关闭该密钥的提币权限。
可以。TradingHost 支持针对 AI IDE（包括 Cursor、Claude Code、GitHub Copilot 和基于 CLI 的 AI 智能体）的基于 MCP 的控制。AI 工具可以检查部署、查看日志、重启策略并管理运行环境工作流。MCP 是一个控制和可观测性界面，而不是交易执行路径。有关完整信息，请参阅 MCP 控制界面页面。
两者皆可。MCP 控制界面在基于 CLI 的智能体（Claude Code CLI、自定义 MCP 客户端、脚本化 MCP 调用）和 IDE 内部同样表现出色。此外，GitHub 原生部署循环在没有任何 AI 工具的情况下也能正常工作：向您的 main 分支进行常规的 git push 即可触发重新部署。
运行环境会检测到崩溃并展示相关的日志和健康信息。在支持的情况下，可以重启受影响的策略，而不会干扰在同一容器中运行的其他策略。您的策略代码仍需负责安全错误处理、防重复下单保护和风险控制。有关日志和健康状况界面的信息，请参阅可观测性页面。
不可以。在与 New York Attorney General 达成和解后，CoinEx 不再开设新的美国账户，现有的美国账户余额仅支持提现（无法交易）。无论 API 密钥权限如何设置，使用美国居民 KYC 账户进行身份验证的策略在下单时都会失败。如果您的账户居住地为非美国地区，则交易不受影响。请将账户管辖区视为硬性的运行限制，API 密钥无法绕过 KYC 居住地限制。详情请参阅上方的“运营说明”部分。
TradingHost 在 EU 和 US-East 区域运行。请选择最靠近您策略所依赖的撮合引擎的区域。请参阅区域页面以获取路由与物理距离详情。
不支持。TradingHost 专注于生产环境的运行和部署。回测应当在您的研究技术栈、框架或 AlgoBuilder 中进行。