阅读时间 … 分钟

专为 WhiteBIT 交易策略打造的 AI 原生运行环境

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

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
WhiteBIT
平台类型
加密货币交易所（全球）
资产类别
加密货币
支持的产品
现货、永续合约、逐仓杠杆。按端点分级限流；无公共测试网（集成测试需在实盘 API 上以最小下单量进行）。
运行环境模式
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 WhiteBIT REST 和 WebSocket API、CCXT、自定义连接器
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
WhiteBIT 角色
交易所账户、API 权限、市场接入、交易执行场所
关联关系
TradingHost 保持独立，与 WhiteBIT 无任何隶属关系

第 02 部分 · WhiteBIT 平台功能

WhiteBIT 平台功能

WhiteBIT 通过 REST 和 WebSocket API 提供现货、永续合约和逐仓杠杆交易，并设有按端点分级的限流机制。一个重要的开发事实是：WhiteBIT 没有公共测试网，因此集成测试必须在实盘 API 上以最小下单量进行。跟单交易、自动投资和质押仅限平台网页端使用，未开放 API 访问。具体端点可能会随时间调整，但整体架构保持稳定；详细的限流规则、交易对列表和手续费率请参考 WhiteBIT 官方文档。

市场与策略模式

  • 基于 USDT、BTC 和 ETH 报价货币对的现货交易
  • 永续合约策略
  • 逐仓杠杆策略
  • 每个 WebSocket 连接每分钟最多订阅 200 条消息
  • 按端点分级的限流预算管理
  • 实盘 API 集成测试（无公共测试网可用）
  • Trade Balance 与 Main Balance 之间的资金划转流程
  • 避开仅限平台端功能（跟单交易、自动投资）的 API 驱动型策略

API 接口

产品范围
现货、永续合约和逐仓杠杆。WhiteBIT 虽然提供跟单交易、自动投资和质押，但这些功能仅限平台端使用（未开放 API 访问）。依赖这些功能的策略需要人工介入。
连接方式
用于下单和账户查询的 REST API 设有按端点分级的限流：Main Balance 每 10 秒 1,000 次请求，Trade Balance 每 10 秒 12,000 次请求，创建订单每 10 秒 10,000 次请求，公共市场数据每 10 秒 2,000 次请求。WebSocket 允许每分钟最多 1,000 个并发连接，单个连接每分钟最多 200 条消息。
身份验证
每个策略使用独立的 API key 和 secret，请求需经过 HMAC 签名。可对每个 key 的权限范围进行限制。订阅 WebSocket 私有频道需要客户端自行处理令牌刷新（token-refresh）流程。

具体细节请参考 WhiteBIT

具体端点、限流权重、交易对列表、手续费率和版本历史请参考 WhiteBIT 官方文档。请以此为准。

第 03 部分 · 用 AI 构建

用 AI 构建您的 WhiteBIT 策略

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

  • 原生 WhiteBIT API

    直接控制 WhiteBIT 的特定行为、资金划转流程和分级限流。

  • CCXT

    跨 WhiteBIT 和其他加密货币交易所的通用接口。CCXT 通过统一的 `whitebit` 类提供对 WhiteBIT 现货交易的支持。

    开始使用 CCXT

  • Freqtrade 或 Hummingbot

    目前这两个框架均未将 WhiteBIT 列为原生支持的交易所。根据文档，可行路径是使用自定义实现或基于 CCXT 的实现。

  • 自定义连接器

    您自己的内部交易引擎，或针对 REST 和 WebSocket API 的专属 WhiteBIT 集成。

框架对 WhiteBIT 产品的支持情况

各框架的支持程度有所不同。CCXT 通过其统一的 `whitebit` 类支持 WhiteBIT 现货交易，但对合约和杠杆交易的支持并不完整。目前 Freqtrade 和 Hummingbot 均未将 WhiteBIT 列为原生支持的交易所。使用原生 API 则可以访问 WhiteBIT 开放的所有功能，包括合约和逐仓杠杆。

框架现货期货杠杆期权
Native WhiteBIT API已支持已支持已支持未记录支持
CCXT已支持部分支持部分支持未记录支持
Freqtrade未记录支持未记录支持未记录支持未记录支持
Hummingbot未记录支持未记录支持未记录支持未记录支持

✓ 表示官方框架文档确认支持。"no" 表示官方文档未说明支持。"partial" 表示支持有限。工作流链接指向目前正在撰写的 /workflows/ 页面。

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

使用 AI 编写

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

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

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

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

    将 TradingHost 指向您现有的策略仓库，或者派生（fork）一个 TradingHost 框架运行环境（CCXT），以此作为对接 WhiteBIT REST 和 WebSocket API 的可用基准。

  3. 步骤 03

    部署至 TradingHost 容器

    选择一个区域（EU 或 US-East），提供策略所需的环境变量（WhiteBIT API key 和 secret、余额划转设置），然后进行部署。TradingHost 会根据您的代码仓库构建容器，并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

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

部署

Section 05 · 运维说明

WhiteBIT 运维说明

在容器化云端运行环境中实际运行 WhiteBIT 策略时可能遇到的坑，这些在 WhiteBIT 的文档或框架的 README 中是找不到的。以下每条说明均提炼自 WhiteBIT 的官方文档；部署层面的建议则来自在 TradingHost 上运行这些策略的实际经验。

  1. 01 · 无测试网

    WhiteBIT 没有公共测试网；集成测试需在实盘 API 上进行

    WhiteBIT 未提供公共测试网。所有集成测试都必须在实盘生产 API 上进行，使用真实资产并以最小下单量执行。与 Binance、Coinbase 或 Bybit 等提供沙盒环境以进行安全部署前验证的交易所相比，这是一个显著的运营缺陷。正确的做法是：划拨一个独立的小额账户或子账户用于首次部署测试，使用最小合规下单量，并在上线第一天就为代码配备标准防护机制（幂等键、最大持仓检查、紧急停止开关），而不是等到发生第一次事故后才去补救。

    来源WhiteBIT API reference

  2. 02 · 分级限流

    按端点限流：Main Balance 1k/10s，Trade Balance 12k/10s，创建订单 10k/10s，公共数据 2k/10s

    WhiteBIT 采用针对每个端点（endpoint）的速率限制，而不是单一的全局额度。Main Balance 端点：每 10 秒 1,000 次请求。Trade Balance 端点：每 10 秒 12,000 次请求。创建订单端点：每 10 秒 10,000 次请求。公开市场端点：每 10 秒 2,000 次请求。频繁请求某一类端点的策略不会消耗其他端点的额度，但会快速耗尽该端点自身的额度。请在您的客户端封装中对不同类别的端点额度进行编码，而不是仅追踪一个全局计数器。

    来源WhiteBIT API reference

  3. 03 · WebSocket 限制

    每分钟 1,000 个并发连接；单个连接每分钟 200 条消息

    WhiteBIT 的 WebSocket 层将整体吞吐量限制为每分钟最多 1,000 次并发连接尝试，且每个已打开的连接每分钟最多发送 200 条消息。如果一个策略在单个连接上订阅了过多的私有频道，可能在订单簿尚未完全订阅前就触发了单连接限制。多策略部署的正确模式是为每个策略分配一个独立的 WebSocket 连接及其专属的消息额度，而不是让多个消费者共享同一个连接。私有频道上的令牌刷新（token-refresh）是客户端的责任；一旦丢失令牌，订阅将会静默中断。

    来源WhiteBIT API reference

  4. 04 · 资金划转错误码

    Error 1 = 禁用从 Trade 划转，2 = 禁用从 Main 划转，3 = 余额不足

    WhiteBIT 将资金划分为 Main 和 Trade 账户。针对 Trade 余额下单但需要读取 Main 余额进行资金调配的策略，需要调用资金划转端点。该划转端点会返回三个需要牢记的特定错误码：error 1 表示禁用从 Trade 划转（通常由账户级设置决定），error 2 表示禁用从 Main 划转，error 3 表示余额不足。这三种错误均无法通过重试恢复，需要进行账户级修复或调整策略决策。

    来源WhiteBIT API documentation repo

  5. 05 · 仅限平台功能

    跟单交易、自动投资和质押无法通过 API 访问

    WhiteBIT 提供跟单交易、定期自动投资和质押功能，但这三者均为仅限平台的功能，未开放 API 访问。对接 WhiteBIT 的策略无法通过编程方式订阅跟单交易领投者、配置自动投资计划或进行余额质押。正确的模式是将这些视为带外（out-of-band）的手动工作流，由人工在 WhiteBIT UI 中进行配置，并让策略代码通过 API 读取最终的余额和订单状态。

    来源WhiteBIT API reference

  6. 06 · 最小订单规模

    实盘对接适用每个交易对的最小规模限制；测试前请先查询

    由于没有测试网，策略下单即为真金白银对接真实流动性。每个交易对都有最小订单规模限制，如果部署的策略提交了低于最小限制的订单，所有请求都将被拒绝。请在启动时查询最小规模端点，按交易对（symbol）缓存这些数值，并在提交前对照缓存的最小值验证每个传出订单。由于 WhiteBIT 会根据市场状况更新最小值，请定期重新获取并更新缓存。

    来源WhiteBIT API reference

Section 06 · 适用场景

适用场景

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

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

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

Section 08 · 常见问题

常见问题

没有。TradingHost 是独立的，与 WhiteBIT 没有任何隶属或合作关系。

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

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

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

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

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

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

可以。CCXT 提供了一个涵盖现货交易的统一 `whitebit` 类。CCXT 对期货和杠杆交易的支持是部分的。将您的 CCXT 策略放入容器中，将其指向 GitHub，TradingHost 就会像运行任何其他 Python 或 Node项目一样运行它。请参阅 CCXT 框架运行环境以了解完整的设置流程。

可以。一旦您的账户符合条件，就可以通过 WhiteBIT API 访问永续合约。TradingHost 在运行环境层层面交易平台是中立的：任何能够通过期货端点身份验证的代码都可以在容器内运行。请注意，跟单交易、自动投资和质押是仅限平台的功能，没有 API 访问权限；策略无法通过编程方式订阅跟单交易领投者或配置自动投资计划。

可以，只要您的项目是这样设计的。您可以在一个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中，以实现隔离和运行清晰度。针对 WhiteBIT，建议每个策略使用一个独立的 WebSocket 连接，这样每个策略都能获得自己专属的单连接每分钟 200 条消息的额度，而不是共享该额度。请参阅 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 即可触发重新部署。

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

WhiteBIT 没有提供公开的测试网。所有的集成测试都需要在生产环境的实盘 API 上进行，使用真实资产和最小下单量。正确的做法是：为首次部署测试划分一个独立的小额账户或子账户，使用合规的最小下单量，并在第一天就部署带有标准防护机制（幂等键、最大持仓限制、一键关停开关）的代码，而不是等到发生第一次事故后才补救。完整指南请参阅上方的“运营说明”部分。

TradingHost 在 EU 和 US-East 区域运行。请选择最靠近您策略所依赖的撮合引擎的区域。请参阅区域页面以获取路由与邻近度详情。

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