阅读时间 … 分钟

CEX.IO 交易策略的 AI 原生运行环境

在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署到托管云运行环境,享有原生 MCP 控制、日志和区域选择。

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
CEX.IO
平台类型
加密货币交易所(机构与零售)
资产类别
加密货币(现货、机构聚合流动性)
支持的产品
通过零售 REST/WebSocket 进行主流交易对的现货交易。CEX.IO Prime 通过 FIX 4.4 提供机构级聚合流动性,并设有独立的 REST 和 WebSocket 层级。尽管母公司已进行 FCA MLR 注册,但 Prime 层级仍屏蔽美国流量。
运行环境模式
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
CEX.IO Prime REST 和 WebSocket、CEX.IO Prime FIX 4.4、CCXT(零售现货)、自定义连接器
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 及 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
CEX.IO 角色
交易所账户、API 访问、市场准入、执行场所
关联关系
TradingHost 保持独立,与 CEX.IO 无任何隶属关系。

第 02 部分 · CEX.IO 平台功能

CEX.IO 平台功能

CEX.IO 运营着零售现货交易所和 CEX.IO Prime(支持 FIX 4.4 协议的机构级聚合流动性服务台)。Prime Liquidity API 采用三标头身份验证(X-AGGR-KEY、X-AGGR-TIMESTAMP、X-AGGR-SIGNATURE),其中签名对 action + timestamp + body 进行哈希处理,而非原始主体。每分钟 300 条消息的 Prime 限制以及 Funds External(提币)权限隔离是其两大特色。尽管其母公司已进行 FCA MLR 注册,但 Prime 层级仍屏蔽美国流量。具体端点信息可能会随时间变化。整体架构是稳定的,具体的层级参数和产品列表请以 CEX.IO 的官方文档为准。

市场与策略模式

  • 基于 CEX.IO Prime 聚合流动性的机构现货策略
  • 针对 Prime 客户的 FIX 4.4 驱动型订单管理
  • 零售端上的 REST/WebSocket 现货交易
  • 结合非 CEX.IO 现货场所的跨市场套利
  • 权限范围内的提币隔离(Funds External 独立分离)
  • WebSocket 私有通道的订单与余额数据流
  • 针对聚合 Prime 流动性的 TWAP 和 VWAP 执行
  • 受 KYC 层级限制的法币资金流集成

API 接口

产品范围
CEX.IO 零售现货通过 REST 和 WebSocket 进行。CEX.IO Prime 通过 FIX 4.4、REST 和 WebSocket 提供机构级聚合流动性,并设有独立的层级。Prime Liquidity API 强制执行每分钟 300 条消息的硬性上限,并伴有 429 退避机制。尽管其母公司已进行 FCA MLR 注册,但 Prime 层级仍屏蔽美国流量。
连接方式
CEX.IO Prime REST 和 WebSocket 采用三标头身份验证(X-AGGR-KEY、X-AGGR-TIMESTAMP、X-AGGR-SIGNATURE)。为机构 Prime Liquidity 客户提供 FIX 4.4 协议支持。零售端使用独立的 REST/WebSocket 签名方案。每个接口独立计算速率限制。
身份验证
CEX.IO Prime 签名请求对 action + timestamp + body(而非原始主体)使用 HMAC,并使用 base64 解密的密钥进行签名,输出为 X-AGGR-SIGNATURE。API 密钥权限分为 Read、Trade、Funds Internal、Funds Wallet 和 Funds External(提币)。策略绝不需要 Funds External 权限。权限按密钥进行范围限定。

具体细节请参考 CEX.IO

具体端点、速率限制权重、交易对列表、费率层级和版本历史请参见 CEX.IO 的官方文档。请以官方文档为准。

第 03 部分 · 用 AI 构建

用 AI 构建您的 CEX.IO 策略

选择一种集成方式,Fork 一个 TradingHost 框架模板,然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI Agent 均可无缝接入相同的 GitHub 原生部署循环。

  • 原生 CEX.IO Prime API

    直接控制 Prime 聚合流动性、FIX 4.4 以及经 X-AGGR-* 签名的 REST/WebSocket。

  • CCXT

    跨 CEX.IO 零售现货和其他加密货币交易所的通用接口。

  • Hummingbot

    基于框架的部署,使用 Hummingbot 策略结构和配置模型。

  • 自定义 FIX 连接器

    针对 CEX.IO Prime FIX 4.4 的 QuickFIX 或您自己的内部交易引擎。

框架对 CEX.IO 产品的支持情况

框架对 CEX.IO 的支持程度参差不齐。CCXT 通过统一的 cex 类公开 CEX.IO 零售现货。Hummingbot 和 Freqtrade 的官方支持连接器列表中未列出 CEX.IO。FIX 4.4 是一种机构协议,由 QuickFIX 及同等库提供支持,而非零售加密货币框架。原生 CEX.IO Prime API 访问可直接对接机构聚合流动性端和 FIX 4.4。

框架现货FIX 4.4期权
Native CEX.IO Prime已支持已支持未记录支持
CCXT已支持未记录支持未记录支持
Hummingbot未记录支持未记录支持未记录支持
Freqtrade未记录支持未记录支持未记录支持

✓ 表示官方框架文档确认支持。“no” 表示官方文档未明确说明支持。

TradingHost 不强求特定的框架,它只负责运行您的项目。

使用 AI 编写

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

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

CEX.IO 提供交易所和 API 访问。TradingHost 则提供生产环境,用于运行您连接到 CEX.IO 的策略。

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

您

  • 您的代码库包含您的代码。
  • 您的部署定义了其运行方式。
  • 您的策略连接到 CEX.IO。

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

    将 TradingHost 指向您现有的策略仓库,或者派生(fork)一个 TradingHost 框架运行环境(CCXT),以获得针对 CEX.IO 零售现货的可运行基线。

  3. 步骤 03

    部署至 TradingHost 容器

    选择一个区域(EU 或 US-East),提供策略所需的环境变量(CEX.IO Prime API 密钥、secret、相关的 FIX 会话配置等),然后进行部署。TradingHost 会根据您的代码仓库构建容器,并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。

  4. 步骤 04

    监控日志与健康状况

    通过 TradingHost 控制面板实时查看日志、健康状况和运行状态。该界面同样支持在任何 AI IDE 中通过 MCP 进行访问,方便 Cursor、Claude Code 或 CLI 智能体与您协同读取部署状态并管理运行环境。

  5. 步骤 05

    更新与重新部署

    将代码更改推送到 GitHub 的主分支(main branch),TradingHost 便会自动重新部署。

Section 05 · 运维说明

CEX.IO 运维说明

在容器化云运行环境中实际运行 CEX.IO 策略时会遇到的陷阱,这些在 CEX.IO 的文档或框架的 README 中是找不到的。以下所有内容均引用或转述自 CEX.IO 的官方文档;部署方面的指南则源于在 TradingHost 上运行这些策略的实际经验。

  1. 01 · 300 次/分钟限制

    CEX.IO Prime Liquidity API 强制执行每分钟 300 条消息的限制并伴有 429 退避

    CEX.IO Prime 在整个 Liquidity API 接口上将签名请求限制为每分钟 300 条。达到上限将返回 429 响应;客户端必须退避,直到滚动分钟窗口清除。通过高频 REST 轮询获取市场数据的策略会迅速消耗完这一额度。对于 Prime,正确的模式是使用 WebSocket 驱动的市场数据和订单更新,而将 REST 留给确实需要的操作。

  2. 02 · X-AGGR 验证

    三标头验证:X-AGGR-KEY、X-AGGR-TIMESTAMP、X-AGGR-SIGNATURE

    CEX.IO Prime 的签名 REST 请求包含三个请求头:X-AGGR-KEY(您的 API 密钥)、X-AGGR-TIMESTAMP(请求时间戳)和 X-AGGR-SIGNATURE。签名是对 action + timestamp + body 进行 HMAC 计算,并使用 base64 解码后的密钥进行签名。请注意,规范的签名输入是 action + timestamp + body,而不是原始 body。仅对 body 进行签名的策略会返回签名错误响应,这看起来像是密钥错误。此外,如果集成不够完善、将密钥直接视为 UTF-8 字符串处理,也会因为忽略了 base64 解码这一细节而导致出错。

  3. 03 · FIX 4.4

    针对机构 Prime Liquidity 客户的 FIX 4.4 协议支持

    CEX.IO Prime 为机构 Prime Liquidity 客户提供除 REST 和 WebSocket 之外的 FIX 4.4 支持。FIX 4.4 拥有自己的会话管理协议(登录、心跳、重连时的序列号恢复),这与 REST/WebSocket 有着本质区别。针对 FIX 的策略应当锁定一个经过实战检验的库(如 QuickFIX),在策略逻辑之外监管会话状态,并将 FIX 会话重置视为可恢复的运行事件,而非致命错误。

  4. 04 · 权限隔离

    API 密钥细分为 Read、Trade、Funds Internal、Funds Wallet、Funds External

    CEX.IO API 密钥权限分为五个范围:Read、Trade、Funds Internal(在账户内的钱包之间转移余额)、Funds Wallet(在子账户之间转移余额)和 Funds External(提币)。策略绝不需要 Funds External 权限;请将具备提币功能的密钥隔离在容器运行环境之外、进行独立的手动管理。这种五分法的权限划分粒度极细,能让每个策略的密钥仅携带其所需的精确权限,绝不越界。

  5. 05 · Prime 屏蔽美国流量

    FCA MLR 注册不包含美国市场准入;Prime 级别屏蔽美国流量

    CEX.IO 在英国根据 FCA 反洗钱条例(MLR)注册运营。该注册不包括美国市场准入;CEX.IO Prime 级别在交易平台边界拦截来自美国的流量。无论账户状态如何,在具有美国出口的 US-East 区域运行的 TradingHost 运行时都将被拒绝访问 Prime 端点。请选择出口地理位置与您的用户协议和您自身的合规要求相符的 TradingHost 区域;对于 Prime,通常选择 EU 区域是正确的。

  6. 06 · 签名输入

    REST 签名哈希 action + timestamp + body,而非仅对原始 body 进行哈希

    CEX.IO Prime 上常见的一个隐性失败是使用了错误的规范签名输入。签名是对拼接后的 action + timestamp + body 进行 HMAC 计算,并使用 base64 解码后的密钥进行签名。如果策略仅对 body 或 URL 路径进行哈希,或者忘记对密钥进行 base64 解码,将会收到类似于密钥错误的签名错误响应。在发布前,请务必针对已知正确的请求对签名路径进行单元测试;在生产环境中调试此问题的成本极高。

Section 06 · 适用场景

适用场景

TradingHost CEX.IO 运行环境最适合用于:

  • 在 AI IDE(Cursor、Claude Code)中构建策略的开发者
  • 系统化加密货币交易员
  • 量化开发人员
  • CEX.IO Prime 机构客户
  • CCXT 用户
  • 从 VPS 托管转向容器化部署的团队

连接 GitHub 并创建首个策略完全免费。

Section 08 · 常见问题

常见问题

不是。TradingHost 是独立的,与 CEX.IO 没有任何隶属关系。

不会。您的策略代码会连接到 CEX.IO,并根据您自己的逻辑、账户权限和集成方式发送指令。TradingHost 仅提供运行该代码的托管环境。

不提供。CEX.IO API 访问权限由 CEX.IO 提供。您需要自行负责您的 CEX.IO 账户、API 权限、凭据以及对 CEX.IO 条款的合规性。

不是。TradingHost 是运行您策略代码的云端运行环境。我们不提供交易信号、AI 预测模型或预建的机器人。使用 TradingHost,您需要自己编写或生成策略(通常使用 Cursor 或 Claude Code),将其作为您自己的代码保存在 GitHub 中,并使用 TradingHost 在生产环境中运行它。3Commas、Cryptohopper 及类似产品拥有策略逻辑;而 TradingHost 则是运行您自己的策略。

AWS 和 DigitalOcean 为您提供的是原始算力。您需要自己处理操作系统更新、容器编排、日志传输、密钥轮换、区域容灾和在线率监控。而 TradingHost 为您提供的是专为交易策略打造的托管运行环境:原生支持 GitHub 部署、支持通过 AI IDE 进行 MCP 驱动的控制,并开箱即用提供日志和健康状况监控界面。如果您想自己运营基础设施,AWS 确实可行。如果您希望将运行环境作为一项托管服务,TradingHost 则是更快捷的途径。

可以。TradingHost 支持运行 Python 策略;选择与您的技术栈匹配的框架运行环境,或者直接部署您自己的代码仓库。

可以。TradingHost 支持任何可以在容器内运行的语言。

可以。CCXT 通过统一的 `cex` 类公开了 CEX.IO 的零售现货市场。CEX.IO Prime 的聚合流动性属于机构级,并非 CCXT 的原生支持市场;对于 Prime,请直接对接原生的 Prime Liquidity API 或 FIX 4.4。有关完整的配置说明,请参阅 CCXT 框架运行环境文档。

可以。TradingHost 在运行环境层面上与交易所无关:any code that can authenticate against CEX.IO Prime can run inside a container, including a FIX 4.4 session. 您在设计时需要考虑的是,FIX 拥有自己的会话管理协议(登录、心跳、序列号恢复),这与 REST/WebSocket 不同。请锁定一个经过实战检验的库(如 QuickFIX),在策略逻辑之外监管会话状态,并将 FIX 会话重置视为可恢复的运行事件。

可以,只要您的项目是这样设计的。您可以在一个运行环境中运行多个策略进程或服务,也可以将它们拆分到不同的运行环境中,以实现隔离并提高运维清晰度。有关多策略模型的详细信息,请参阅 TradingHost 运行环境页面。

最快的方法是 fork 一个 TradingHost 框架运行环境:对于开箱即用的零售现货项目,可以选择 CCXT。如果您针对的是原生的 Prime Liquidity API 或 FIX 4.4,也可以连接您自己的 GitHub 策略仓库。关联 GitHub 仓库并创建策略是免费的;运行环境方案已在价格页面列出。

保存在您通过 GitHub 控制的机密(secrets)工作流中。TradingHost 在运行时通过 GitHub 仓库机密、环境机密或您自己认可的密钥管理流程来读取它们。TradingHost 不需要托管您的 Prime API 密钥、密码或 FIX 会话配置。有关完整的处理模型,请参阅平台机密文档。

不需要。策略绝不需要 Funds External(提币)权限。CEX.IO 将 API 密钥权限细分为五个范围:Read、Trade、Funds Internal、Funds Wallet 和 Funds External。让每个策略的密钥仅携带该策略所需的范围,可以在密钥泄露时控制受损范围;请将具备提币功能的密钥隔离在容器运行环境之外、进行独立的手动管理。

可以。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 即可触发重新部署。

运行环境会检测到崩溃并输出相关的日志和健康信息。在支持的架构下,受影响的策略可以独立重启,而不会干扰同一容器中运行的其他策略。您的策略代码仍需负责安全错误处理、防重单保护和风险控制。请参阅可观测性页面以获取日志和健康指标接口的详细信息。

CEX.IO Prime 使用 base64 解码后的密钥对 action + timestamp + body(而非仅原始 body)进行 HMAC 签名。如果策略仅对 body 进行哈希、直接将密钥作为 UTF-8 字符串进行签名(而非先进行 base64 解码),或者遗漏了 action 前缀,都会导致返回类似于密钥错误的签名错误响应。在部署之前,请务必针对已知正确的请求对签名路径进行单元测试。完整指南请参阅上方的“运营说明”部分。

TradingHost 在 EU 和 US-East 区域运行。对于 CEX.IO Prime,通常选择 EU 区域是正确的,因为尽管其母公司拥有 FCA MLR 注册,但 Prime 级别仍会拦截来自美国的流量。请选择出口地理位置与您的用户协议和您自身的合规要求相符的区域。有关路由和延迟邻近性的详细信息,请参阅区域页面。

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