阅读时间 … 分钟

适用于 KuCoin 交易策略的 AI 原生运行环境

在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署到托管云端运行环境，提供一流的 MCP 控制、日志查看和区域选择。

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
KuCoin
平台类型
加密货币交易所（现货、杠杆、期货、期权）
资产类别
加密货币
支持的产品
现货、全仓/逐仓杠杆（最高 10 倍）、futures.kucoin.com 上的 USDT/USDC 保证金及币本位（反向）永续合约、BTC/ETH 欧式期权（USDT 结算、仅限买方、仅限 App 端）。
运行环境模式
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 KuCoin REST + WebSocket、CCXT（kucoin、kucoinfutures）、Freqtrade（社区确认支持现货）、Hummingbot（kucoin、kucoin_perpetual）、自定义
AI 工作流集成
MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
KuCoin 角色
交易所账户、API 接入、市场准入、执行场所
关联关系
TradingHost 是独立平台，与 KuCoin 无任何关联。根据 CFTC 同意令（2026 年 3 月），在 Peken Global 于 2025 年 1 月承认 DOJ 指控并被罚款 2.97 亿美元后，KuCoin 已被永久禁止向美国个人提供服务。

第 02 部分 · KuCoin 平台功能

KuCoin 平台功能

KuCoin 通过 REST 和 WebSocket API 提供现货、全仓和逐仓杠杆（最高 10 倍）、futures.kucoin.com 上的 USDT/USDC 保证金及币本位（反向）永续合约，以及 BTC/ETH 欧式期权。策略通过使用 HMAC-SHA256 签名的三部分凭证（API key、secret 和 passphrase）进行身份验证。现货和期货是独立的 API 架构，使用独立的密钥。具体端点可能会随时间变化。整体框架是稳定的，而具体的速率限制权重、手续费等级和交易对列表请参考 KuCoin 的官方文档。

市场与策略模式

  • 深度山寨币交易对的现货做市
  • futures.kucoin.com 上的 USDT 保证金永续合约
  • futures.kucoin.com 上的币本位（反向）永续合约
  • 最高 10 倍的全仓和逐仓杠杆交易
  • 用于策略隔离的子账户（sub-accounts）层级架构
  • 通过 KuCoin 的带单交易者（lead trader）计划复制策略
  • 通过沙盒进行模拟交易（仅限现货）
  • 基于 KCS 质押手续费折扣等级的策略

API 接口

产品范围
现货位于 api.kucoin.com，期货位于 api-futures.kucoin.com，沙盒位于 openapi-sandbox.kucoin.com（仅限现货）。
连接方式
REST 加 WebSocket。WebSocket 需要两步操作：向 /api/v1/bullet-public 或 /api/v1/bullet-private 发送 POST 请求，以从 instanceServers 获取令牌和实际的 wss:// 端点。重连逻辑必须重新获取令牌（令牌会过期）。请遵守返回的 pingInterval（约 18000ms）和 pingTimeout（约 10000ms）。
身份验证
三部分凭证（API key + API secret + passphrase），采用 HMAC-SHA256 签名。必需的请求头：KC-API-KEY、KC-API-SIGN（对 timestamp + method + endpoint + body 进行 HMAC-SHA256 计算后的 base64 编码）、KC-API-TIMESTAMP（自 Epoch 以来的毫秒数）、KC-API-PASSPHRASE（对于 v2 密钥，这是原始 passphrase 的 HMAC-SHA256 的 base64 编码，而非原始值）、KC-API-KEY-VERSION（当前 v2 密钥为 "2"）。现货和期货使用在不同控制面板中创建的独立 API 密钥。

具体细节请参考 KuCoin

具体端点、速率限制权重、交易对列表、手续费等级和版本历史均记录在 KuCoin 的官方文档中。请以此为准。

第 03 部分 · 用 AI 构建

用 AI 构建您的 KuCoin 策略

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

  • 原生 KuCoin REST + WebSocket

    直接控制 KuCoin 特有的行为、账户数据、子账户（sub-accounts）路由和订单执行逻辑。

  • CCXT

    跨 KuCoin 和其他加密货币交易所的通用接口。现货和期货被建模为两个交易所类：kucoin 和 kucoinfutures。

    开始使用 CCXT

  • Freqtrade or Hummingbot

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

    开始使用 Freqtrade开始使用 Hummingbot

  • 自定义连接器

    您自己的内部交易引擎或专有的 KuCoin 集成。

框架对 KuCoin 产品的支持情况

支持范围因框架而异。原生 API 和 CCXT 覆盖了最广泛的 KuCoin 功能；Hummingbot 支持现货和永续期货；Freqtrade 仅支持现货（经社区确认，配置中需要填写 passphrase 字段）。

框架现货杠杆期货
Native KuCoin REST + WebSocket已支持已支持已支持
CCXT已支持已支持已支持
Freqtrade已支持未记录支持未记录支持
Hummingbot已支持未记录支持已支持

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

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

使用 AI 编写

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

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

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

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

    将 TradingHost 指向您现有的策略代码库，或者派生 (fork) 一个 TradingHost 框架运行环境（CCXT、Freqtrade 或 Hummingbot）以获取可直接运行的基础模板。

  3. 步骤 03

    部署至 TradingHost 容器

    选择一个区域（EU 或 US-East），提供策略所需的环境变量（KuCoin 的三部分凭据：Key、Secret 和 Passphrase，以及当前 v2 密钥所需的 KC-API-KEY-VERSION: 2），然后进行部署。TradingHost 会从您的代码仓库构建容器，并在托管的 Kubernetes 基础设施上运行您的策略。本地无需安装 Docker。

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

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

部署

Section 05 · 运维说明

KuCoin 运维说明

在容器化云端运行环境中实际运行 KuCoin 策略时可能遇到的陷阱，这些内容在 KuCoin 的文档或框架的 README 中并未提及。以下所有陈述均引用或转述自 KuCoin 官方文档（或关于美国准入说明的 CFTC 文件）；部署方面的指南源自于在 TradingHost 上运行这些策略的实际经验。

  1. 01 · 三部分凭证

    Key、secret 和 passphrase，以及版本请求头

    现货和期货均需要 key + secret + passphrase。对于 v2 密钥，passphrase 请求头必须是原始 passphrase 的 HMAC-SHA256 的 base64 编码，而非原始值。当前密钥必须将 KC-API-KEY-VERSION 请求头设置为 "2"；在 v2 密钥上省略该请求头会导致签名错误。

    来源KuCoin authentication docs

  2. 02 · 常见错误

    400003 和 400004 为 passphrase 错误

    缺失或格式错误的 passphrase 会导致 400003 KC-API-KEY not exists 或 400004 KC-API-PASSPHRASE error 错误。CCXT 曾有多次因 KC-API-KEY-VERSION 不匹配而导致这些错误的记录。

    来源KuCoin authentication docs

  3. 03 · 独立架构

    现货和期货是使用不同密钥的不同 API

    现货密钥无法在 api-futures.kucoin.com 上进行身份验证。同时交易这两个板块的策略需要两对密钥和两个配置好的客户端。CCXT 将其建模为两个独立的交易所类（kucoin 和 kucoinfutures）。

  4. 04 · WebSocket

    Bullet-token 握手，而非静态 URL

    KuCoin 不提供静态的 wss:// URL。需向 /api/v1/bullet-public（公共数据流）或 /api/v1/bullet-private（账户/订单数据流）发送 POST 请求，以获取一次性 token 以及来自 instanceServers 的实际 wss:// 端点。Token 会过期，因此重连逻辑必须重新获取。请务必遵守返回的 pingInterval（约 18 秒）和 pingTimeout（约 10 秒）。

    来源KuCoin WebSocket: get public token

  5. 05 · 沙盒

    仅限现货，状态完全独立

    openapi-sandbox.kucoin.com 仅涵盖现货端点，并使用完全独立的登录信息、API 密钥集和虚拟余额。沙盒中不包含期货、杠杆和期权，因此涉及 api-futures.kucoin.com 的策略需要通过其他方式进行模拟运行（如模拟执行层、极小实盘资金或框架原生的模拟运行）。

  6. 06 · 频率限制

    按 VIP 等级划分的加权资源池

    按 VIP 等级划分的加权资源池在 30 秒的滑动窗口内重置。额度耗尽时将返回 HTTP 429，响应体错误码为 429000。每个响应都包含资源池配额、剩余配额和重置倒计时的响应头。部分 v1 端点（如 DELETE /api/v1/orders、GET /api/v1/hf/orders/active）已被弃用，建议使用限额更高的 v2/v3 端点。

  7. 07 · 美国可用性

    根据 2026 年 3 月 CFTC 同意令被永久禁止

    根据纽约南区联邦地区法院（SDNY）于 2026 年 3 月 30 日针对 Peken Global Limited（KuCoin 的运营商）下达的同意令，除非 Peken Global 向 CFTC 注册为 Foreign Board of Trade，否则 KuCoin 被永久禁止接受美国客户。该禁令适用于 KuCoin 账户本身，而非策略代码的运行位置；TradingHost 的运行区域和连接性无法绕过此限制。

    来源CFTC press release 9203-26

Section 06 · 适用场景

适用场景

TradingHost KuCoin 运行环境最适合用于：

  • 在 KuCoin 丰富的山寨币交易对中运行现货策略的算法策略开发者
  • 在 futures.kucoin.com 上运行 USDT 保证金或币本位反向永续合约的永续合约交易员
  • 使用 sub-accounts 隔离策略或运行资金池的量化团队
  • CCXT、Freqtrade 和 Hummingbot 用户
  • 通过 MCP 和 GitHub 驱动部署的 AI / Cursor / Claude 开发者

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

Section 08 · 常见问题

常见问题

没有。TradingHost 是独立的平台，与 KuCoin 无任何隶属或合作关系。

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

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

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

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

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

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

KuCoin 的现货和期货交易平台是独立的 API（api.kucoin.com 与 api-futures.kucoin.com），并使用独立的 API 密钥。在 CCXT 中，这对应两个交易所类：用于现货和杠杆的 kucoin，以及用于 futures.kucoin.com 的 kucoinfutures。您需要使用各自的 key + secret + passphrase 实例化这两个类，根据交易对将订单路由到正确的客户端，并将这两套凭据作为独立的 TradingHost 密钥（secrets）进行存储。

可以，只要您的项目是这样设计的。您可以在一个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中，以实现隔离和清晰的运维管理。请参阅 TradingHost 运行环境页面了解多策略模型。

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

保存在您通过 GitHub 控制的密钥（secrets）工作流中。TradingHost 在运行时通过 GitHub 仓库密钥、环境密钥或您自己认可的密钥管理流程读取它们。TradingHost 不需要托管您的 API 密钥、私钥（secret）或密码（passphrase）。请参阅平台密钥了解完整的处理模型。

不需要。策略绝不应该需要提币权限。请使用受限的权限（读取、交易），并在合适时启用 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 即可触发重新部署。

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

几乎总是以下三种原因之一：（1）v2 密钥的 passphrase 标头必须是原始密码的 HMAC-SHA256 的 base64 编码，而不是原始密码。（2）对于 v2 密钥，KC-API-KEY-VERSION 标头必须设置为 "2"。（3）签名负载为 timestamp + 大写请求方法（UPPERCASE_METHOD） + 带有查询参数的端点（endpoint_with_query） + 请求体（body），在 GET/DELETE 请求中 body 为空字符串。遗漏其中任何一项都会导致此类错误。

KuCoin 不提供静态的 wss:// URL。在建立连接前，需向 /api/v1/bullet-public（公共行情）或 /api/v1/bullet-private（账户/订单推送）发送 POST 请求。响应会返回一个一次性 token，以及 instanceServers[0].endpoint、pingInterval 和 pingTimeout。使用 ?token=...&connectId=... 连接到该端点，并按照返回的间隔发送 ping。Token 会过期，因此重连逻辑必须重新获取 token。

不行。根据 2026 年 3 月 30 日针对 Peken Global Limited（KuCoin 的运营商）达成的 CFTC 同意令，除非注册为 Foreign Board of Trade，否则 KuCoin 被永久禁止接受美国用户。该限制针对的是 KuCoin 账户本身，而非策略代码的托管位置，因此在 TradingHost 上部署并不能改变用户的准入资格。

仅限现货。openapi-sandbox.kucoin.com 仅涵盖现货端点，并使用完全独立的登录账号、API 密钥集和虚拟余额。沙盒中不提供合约（Futures）、杠杆和期权，因此任何涉及 api-futures.kucoin.com 的策略在扩大资金规模前，都需要通过其他方式进行模拟交易（例如模拟执行层、极小实盘资金或框架原生的 dry-run）。

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

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