阅读时间 … 分钟

专为 Crypto.com Exchange 交易策略打造的 AI 原生运行时

在 Cursor、Claude Code 或任何 AI IDE 中编写代码。从 GitHub 部署到托管云端运行时，享有原生 MCP 控制、日志和区域选择支持。

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
Crypto.com Exchange（由开曼群岛 Foris DAX Limited 运营）
平台类型
中心化加密货币交易所
资产类别
加密货币（现货、永续合约衍生品、杠杆）
支持的产品
现货、永续合约衍生品、杠杆。衍生品由获得独立许可的 Crypto.com 关联公司提供，并受到地理限制（根据 Crypto.com 帮助中心列表，受限制的司法管辖区包括美国、英国、新加坡以及其他约 110 个国家和地区）。
运行环境模式
容器化策略运行时
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 Crypto.com Exchange v1 API、CCXT (`cryptocom`)、FIX 4.4（GEN 3.0，机构级）、自定义 HTTP / WebSocket 客户端
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行时、部署、日志、健康检查、区域选择、MCP 控制
Crypto.com Exchange 角色
交易所账户、API 密钥发放、市场接入、执行场所、托管
关联关系
TradingHost 保持独立，与 Crypto.com、Foris DAX Limited 或任何 Crypto.com 集团实体无任何关联。

第 02 部分 · Crypto.com Exchange 平台功能

Crypto.com Exchange 平台功能

Crypto.com Exchange 通过统一的 v1 API 提供现货、永续合约衍生品和杠杆交易，该 API 开放了 REST、WebSocket 和 FIX 4.4 接口。策略使用经 HMAC-SHA256 签名的 API 密钥进行身份验证；支持原生主子账户架构，且在 `uat-api.3ona.co` 上托管了独立的 UAT 沙盒。具体端点可能会随时间变化。虽然整体架构保持稳定，但具体的速率限制配额、错误代码和 `-PERP` 合约列表请以 Crypto.com 的官方文档为准。

市场与策略模式

  • 针对 CRO 及稳定币交易对的现货做市
  • 针对 `-PERP` 合约的永续基差与资金费率套利
  • 跨板块现货与永续合约套利（单一交易所，两个产品板块）
  • 利用杠杆资金进行方向性交易，每个子账户独立隔离风险
  • 2026 年 1 月之后，通过 `private/advanced/create-order` 进行 Advanced Order Management 触发单/止盈/止损编排
  • 带有 `broker_id` 经纪商标签的交易执行，适用于手续费返佣策略
  • 专为机构交易台设计、基于 FIX 4.4 的低延迟交易流
  • 在单一主账户下利用子账户隔离实现多策略分流

API 接口

产品范围
通过统一的 Exchange v1 API 进行现货、永续合约衍生品和杠杆交易。质押（Staking）、Earn 和储蓄产品不支持算法交易。沙盒环境位于 uat-api.3ona.co / uat-stream.3ona.co，使用独立的密钥。
连接方式
支持 REST 和 WebSocket。先前的 Derivatives v1 API 已并入 Exchange v1；Spot v2.1 为上一代版本。WebSocket 运行在两个流上：用户 API 位于 `wss://stream.crypto.com/exchange/v1/user`，市场数据位于 `wss://stream.crypto.com/exchange/v1/market`。此外还为机构账户提供 FIX 4.4 (GEN 3.0) 端点。
身份验证
对 `method + id + api_key + parameter_string + nonce` 进行 HMAC-SHA256 加密，并使用 API 密钥进行签名。通过 `private/get-accounts` 实现主/子账户层级管理。支持可选的单密钥 IP 白名单（具有交易或提币权限的密钥必须配置）。

具体细节请参考 Crypto.com

具体的端点、速率限制配额、合约列表、费率层级和版本历史均记录在 Crypto.com 的官方文档中。请以此作为权威参考。

第 03 部分 · 用 AI 构建

用 AI 构建您的 Crypto.com Exchange 策略

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

  • 原生 Crypto.com Exchange v1 API

    直接控制 Crypto.com Exchange 的特定行为、账户数据和订单执行逻辑。单个统一密钥即可处理现货、杠杆和永续合约衍生品；支持用于手续费返佣流程的 `broker_id` 标签，以及用于止盈/止损和触发单的 Advanced Order Management 端点。

  • CCXT

    跨 Crypto.com Exchange 和其他加密货币交易所的通用接口。CCXT 将 `cryptocom` as 标记为已认证的专业级（pro-tier）接口，支持现货、杠杆和掉期（swap）功能。建议将 CCXT 视为便利层；2026 年 1 月之后的 Advanced Order Management 端点仍遵循原生 Exchange v1 协议。

    开始使用 CCXT

  • FIX 4.4 (GEN 3.0)

    专为对延迟敏感的交易台提供的机构级 FIX 端点。与 REST 和 WebSocket 接口并行运行；接入需通过 Crypto.com 的机构账户审核。

  • 自定义 HTTP / WebSocket 客户端

    您自己通过公共 REST 和 WebSocket 端点构建的内部交易引擎或专有 Crypto.com Exchange 集成。

框架对 Crypto.com Exchange 产品的支持情况

支持情况因框架而异。原生 Crypto.com Exchange v1 API 和 CCXT `cryptocom` 均支持在单个统一密钥下进行现货、永续合约和杠杆交易。Freqtrade 没有官方的 Crypto.com Exchange 支持，仅能通过 CCXT 通用兼容性接入该交易所，且仅限现货。Hummingbot 的 `crypto_com` 连接器在 GEN 3 API 升级后被标记为已过时，且不在 Hummingbot 当前的交易所列表中；对于生产环境，建议优先选择原生 v1 或 CCXT。

框架现货永续杠杆
Native Crypto.com Exchange v1已支持已支持已支持
CCXT (`cryptocom`)已支持已支持已支持
Freqtrade部分支持未记录支持未记录支持
Hummingbot部分支持未记录支持未记录支持

✓ 表示官方框架文档确认支持。“无”表示官方文档未说明支持。“通过 CCXT”表示该框架仅通过通用 CCXT 兼容性接入 Crypto.com。“过时连接器”表示现有连接器未跟进交易所的 API 升级。工作流链接指向目前正在编写的 /workflows/ 页面。

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

使用 AI 编写

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

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

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

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

    将 TradingHost 指向您现有的策略仓库，或者派生（fork）一个 TradingHost 框架运行时（CCXT 或您自己的原生 Crypto.com Exchange 模板）作为可运行的基础模板。

  3. 步骤 03

    部署至 TradingHost 容器

    选择区域（EU 或 US-East），提供策略所需的环境变量（Crypto.com Exchange API 密钥、生产或 UAT 的基础 URL 等），然后进行部署。TradingHost 会直接从代码仓库构建您的容器，并在托管的 Kubernetes 基础设施上运行您的策略。本地无需安装 Docker。

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

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

部署

Section 05 · 运维说明

Crypto.com Exchange 运维说明

在容器化云端运行时中实际运行 Crypto.com Exchange 策略时可能遇到的陷阱，这些内容在 Crypto.com 的文档或框架的 README 中是找不到的。以下所有说明均引用或转述自 Crypto.com 的官方文档；部署侧的指南则源自我们在 TradingHost 上运行这些策略的实际经验。

  1. 01 · API 迁移

    Advanced Order Management API 逐步推出（2025 年 12 月至 2026 年 1 月）

    Crypto.com 于 2025-12-17 08:00 UTC 将触发单迁移至 `private/advanced/create-order`，随后于 2026-01-28 08:00 UTC 迁移了止盈/止损订单的创建和撤销。此前针对止盈/止损或触发单调用 `private/create-order` 的代码，必须迁移到高级端点和 `user.advanced.order` 订阅。在切换前未进行更新的策略将失去条件单功能。

    来源Exchange v1 REST + WebSocket reference

  2. 02 · 平台区分

    Exchange API 并非 App API

    Crypto.com 运营着两个截然不同的平台。Crypto.com Exchange（网页版，crypto.com/exchange）提供公开且有文档支持的 HMAC 签名 API；而 Crypto.com App（零售钱包）则没有公开的交易 API。在 App 内生成的 API 密钥无法在 Exchange 上通过身份验证，反之亦然。这是最常见的新手配置错误。

    来源help.crypto.com, API articlecrypto.com/exchange/api

  3. 03 · 衍生品访问权限

    地理区域限制与实体隔离

    衍生品业务由获得独立许可的 Crypto.com 关联公司运营（国际业务由 Foris DAX MT Limited 运营；美国业务由 Crypto.com Derivatives North America / CDNA 运营）。大约有 110 个司法管辖区被排除在国际衍生品交易平台之外，包括美国、英国和新加坡。即使在符合条件的地区，现货 API 密钥也不会自动授予衍生品交易权限。

    来源Derivatives trading geo-restrictions

  4. 04 · 速率限制

    按方法和通道细分的配额限制

    针对每个方法的 REST 配额非常严格：`private/create-order`、`private/cancel-order` 和 `private/cancel-all-orders` 限制为每 100 毫秒 15 次请求；`private/get-order-detail` 限制为每 100 毫秒 30 次；`private/get-trades` 和 `private/get-order-history` 限制为每秒 1 次；所有其他私有方法限制为每 100 毫秒 3 次。公共 REST 限制为每个 IP 100 rps。WebSocket：User API 为 150 rps，Market Data 为 100 rps。超出限制将返回 `42901`（HTTP 429）。

    来源Exchange v1 REST + WebSocket reference

  5. 05 · WebSocket 生命周期

    30 秒心跳，1 秒预热

    服务器每 30 秒发送一次心跳；客户端必须在 5 秒内使用匹配的 `id` 回复 `public/respond-heartbeat`，否则连接将被关闭。Crypto.com 明确建议在 WebSocket 开启和发送第一个请求之间等待 1 秒，以避免连接时触发速率限制。需要处理的连接终止代码包括：1000（正常关闭）、1006（异常关闭）、1013（服务器重启，需要退避重连）。

    来源Exchange v1 REST + WebSocket reference

  6. 06 · 环境

    UAT 沙盒位于独立主机

    生产环境访问 api.crypto.com 和 stream.crypto.com。UAT 沙盒则运行在 uat-api.3ona.co 和 uat-stream.3ona.co 上，并使用独立的 API 密钥。策略必须从环境变量中读取基础 URL，而不是硬编码 api.crypto.com，否则沙盒运行可能会在无意中请求生产环境。

    来源Exchange v1 REST + WebSocket reference

  7. 07 · 身份验证错误

    Nonce、签名和 IP 失败模式

    身份验证问题主要由三个错误代码引起：`40101`（未通过身份验证，密钥或签名错误）、`40102`（nonce 与服务器时间偏差超过 60 秒）以及 `40103`（请求 IP 不在密钥的白名单中）。在重新部署后，如果容器运行区域的出口 IP 与白名单 IP 不符，是导致 `40103` 最常见的原因。

    来源Exchange v1 REST + WebSocket reference

Section 06 · 适用场景

适用场景

TradingHost Crypto.com Exchange 运行环境最适合用于：

  • 在 AI IDE（Cursor、Claude Code）中构建策略的开发者
  • 系统化加密货币交易员
  • 量化开发人员
  • CCXT 用户
  • 正在从 VPS 托管迁移到容器化部署的团队

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

Section 08 · 常见问题

常见问题

不是。TradingHost 是独立的，不隶属于 Crypto.com、Foris DAX Limited 或任何 Crypto.com 集团实体。

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

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

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

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

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

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

可以。CCXT 将 Crypto.com 开放为交易所 ID `cryptocom`，并将其列为已认证的专业级（pro-tier）交易所，支持现货、杠杆和永续合约（swap）功能。您可以将 CCXT 视为一个便利层；其速率限制语义以及 2026 年 1 月之后推出的 Advanced Order Management 端点仍遵循原生的 Exchange v1 协议。有关完整配置说明，请参阅 CCXT 框架运行环境。

可以，只要您的项目是这样设计的。您可以在单个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中，以实现隔离和运行清晰度。Crypto.com Exchange 的主/子账户层级结构与此天然契合：每个策略都可以在单个主密钥下指向其专属的子账户。有关多策略模型的更多信息，请参阅 TradingHost 运行环境页面。

最快的方法是 fork 一个 TradingHost 框架运行环境（例如 CCXT）以获取开箱即用的项目，或者直接连接您自己的 GitHub 策略仓库。关联 GitHub 仓库并创建策略是免费的；运行环境方案已在定价页面列出。

保存在您通过 GitHub 控制的机密（secrets）工作流中。TradingHost 在运行时通过 GitHub 仓库机密、环境机密或您自己批准的机密管理流程来读取它们。TradingHost 不需要托管您的 API 密钥和私钥。有关完整的处理模型，请参阅平台机密。

不需要。策略绝不需要提币权限。Crypto.com 要求对具有交易或提币权限的密钥进行 IP 白名单限制；请确保您的策略密钥不包含提币权限，并单独管理提币。

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

运行时会检测到崩溃并公开相关的日志和健康信息。在支持的情况下，受影响的策略可以重新启动，而不会干扰在同一容器中运行的其他策略。您的策略代码仍需负责安全错误处理、防重复下单保护和风险控制。有关日志和健康界面的信息，请参阅可观测性。

40101 表示 HMAC-SHA256 签名、密钥或签名参数顺序错误；请重新检查签名字符串 `method + id + api_key + parameter_string + nonce` 以及参数键的升序排序。40102 表示您的 nonce 与 Crypto.com 服务器时钟的偏差超过 60 秒；请同步 NTP。40103 表示您的请求 IP 不在 API 密钥的白名单中；交易和提币密钥需要设置 IP 白名单。完整指南请参阅上方的“操作说明”部分。

Crypto.com Exchange 是拥有公开且有文档记录的 v1 API 的交易场所，用于算法交易；这正是 TradingHost 所集成的对象。而 Crypto.com App 是零售钱包和消费级产品，并不提供交易 API。API 密钥是在 Exchange 网页端 UI 的“用户中心 > API”中生成的，而不是在手机端 App 中。

在 2025-12-17 08:00 UTC 触发订单迁移之后，止盈（Take Profit）和止损（Stop Loss）订单的创建与撤销已于 2026-01-28 08:00 UTC 从 `private/create-order` 迁移至 `private/advanced/create-order`。策略现在必须调用高级端点来处理条件订单，并订阅 `user.advanced.order` 以获取状态更新。普通限价单和市价单继续使用 `private/create-order`。

在国际站上，统一的 Exchange v1 API 密钥可以在一个凭据中同时处理现货、杠杆和永续合约，但底层的衍生品交易权限是绑定在账户而非密钥上的。账户必须启用衍生品交易，且该账户必须位于非排除司法管辖区。在美国，衍生品交易在单独获得许可的关联机构（CDNA）上运行，并有其独立的准入流程。

Freqtrade 可以通过 CCXT 连接 Crypto.com，但并未获得 Freqtrade 团队的官方支持。自 GEN 3 API 升级以来，Hummingbot 的 `crypto_com` 连接器已被标记为过时，且不在 Hummingbot 当前的交易所列表中；请将其视为不支持，并直接使用 CCXT 或原生 v1。

TradingHost 在 EU 和 US-East 区域运行。请选择最靠近您策略所依赖的撮合引擎的区域。有关路由和物理距离的详细信息，请参阅区域页面。

不进行。TradingHost 专注于生产环境的运行时和部署。回测属于您的研究技术栈、框架或 AlgoBuilder。