阅读时间 … 分钟

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

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

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
Binance
平台类型
加密货币交易所
资产类别
加密货币
支持的产品
现货、USD-M 合约、COIN-M 合约、期权、全仓和逐仓杠杆
运行环境模式
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 API 代码、CCXT、Freqtrade、Hummingbot、自定义连接器
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 及 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
Binance 角色
交易所账户、API 接入、市场接入、执行场所
关联关系
TradingHost 是一家独立机构，与 Binance 无任何隶属关系

第 02 部分 · Binance 平台功能

Binance 平台功能

Binance 通过 REST 和 WebSocket API 提供现货、USD-M 和 COIN-M 合约、期权以及全仓/逐仓杠杆交易。策略通过经 HMAC-SHA256 签名的 API 密钥进行身份验证，并限定特定权限，且现货和合约均设有独立的公共测试网。具体端点可能会随时间变化。虽然整体架构保持稳定，但具体的频控权重、费率等级和交易对列表请以 Binance 官方文档为准。

市场与策略模式

  • USD-M 永续合约策略
  • COIN-M 币本位反向合约及季度合约策略
  • BTC 和 ETH 期权策略
  • 永续合约资金费率与基差交易策略
  • 子账户隔离的多策略部署
  • 现货与杠杆策略（全仓或逐仓）
  • WebSocket User Data Stream 消费者
  • 经现货与合约测试网验证的部署

API 接口

产品范围
现货、USD-M 合约（永续与交割）、COIN-M 合约、期权、全仓与逐仓杠杆以及子账户层级。每个产品均提供公共测试网，以便在不投入真实资金的情况下，针对相同的 API 接口验证策略。
连接方式
REST 用于下单和账户查询。WebSocket 流用于实时行情数据和深度。WebSocket User Data Streams 用于账户、余额和订单事件。此外，还提供与 REST 接口并行的 WebSocket API 用于请求/响应。
身份验证
每个策略使用独立的 API 密钥和私钥。私有请求使用 HMAC-SHA256 进行签名。权限按密钥进行限定（读取、现货交易、合约交易、提现），并支持可选的 IP 白名单。策略绝不需要提现权限。

具体细节请参考 Binance

具体端点、频控权重、交易对列表、费率等级和版本历史均记录在 Binance 官方文档中。请以官方文档为准。

第 03 部分 · 用 AI 构建

用 AI 构建您的 Binance 策略

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

  • 原生 Binance API

    直接控制 Binance 特有的行为、账户数据和订单执行逻辑。

  • CCXT

    跨 Binance 及其他加密货币交易所的通用接口。

    开始使用 CCXT

  • Freqtrade 或 Hummingbot

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

    开始使用 Freqtrade开始使用 Hummingbot

  • 自定义连接器

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

框架对 Binance 产品的支持情况

各框架的支持范围有所不同。CCXT 覆盖最广泛的 Binance 接口；Freqtrade 和 Hummingbot 支持现货和 USD-M 永续合约；原生 Binance API 接入则支持 Binance 提供的所有功能，包括期权。

框架现货USD-MCOIN-M期权
Native Binance API已支持已支持已支持已支持
CCXT已支持已支持已支持未记录支持
Freqtrade已支持已支持未记录支持未记录支持
Hummingbot已支持已支持未记录支持未记录支持

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

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

使用 AI 编写

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

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

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

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

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

  3. 步骤 03

    部署至 TradingHost 容器

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

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

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

部署

Section 05 · 运维说明

Binance 运维说明

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

  1. 01 · 错误代码 -2015

    "Invalid API-key, IP, or permissions for action"

    最常见的 Binance 身份验证失败错误。这意味着您的密钥存在，但请求 IP 未被列入该密钥的白名单，或者该密钥缺少访问该端点的权限（例如，使用现货密钥请求合约端点，或只读密钥尝试下单）。在 TradingHost 上，容器出口 IP 按区域固定。由于容器会重新调度，请将您所选区域公布的出口 IP 范围（而非单个 IP）加入白名单。

    来源Binance error codes reference

  2. 02 · 提现权限范围

    启用提现权限需要配置 IP 白名单

    Binance: "Adding IP access restrictions is mandatory to enable withdrawal permission." 云端运行环境没有稳定的单一出口 IP，因此在容器中运行带有提现权限的密钥非常困难。正确的模式是：根本不要在策略密钥上启用提现权限。策略不需要该权限。请将提现功能保留在固定 IP 主机上单独手动管理的密钥中。

    来源Binance API key IP restriction policy

  3. 03 · 只读回退

    新生成的系统生成密钥在无 IP 限制时仅具只读权限

    自 2023-01-30 起，Binance 规定：“the system-generated API Key's permission can only be set to [Enable Reading] if your IP is unrestricted.” 如果您在未设置白名单的情况下为 TradingHost 策略生成新密钥，该密钥将无法进行交易，仅能读取数据。您需要将您所在区域的运行环境出口 IP 范围加入白名单，或者使用自生成的 Ed25519 / RSA 密钥以绕过此默认安全控制。

    来源Binance API security upgrade (2023-01-30)

  4. 04 · 密钥权限范围

    每个策略使用独立权限密钥，而非多策略共享主密钥

    Binance 提供四种接口安全类型：NONE（公开市场数据）、TRADE（订单）、USER_DATA（账户状态）和 USER_STREAM（User Data Stream 订阅）。Binance 建议：“you can have an API key with TRADE permission for trading, while using a separate API key with USER_DATA permission to monitor your order status.” 为每个策略配置仅满足其所需权限的专属密钥，可以在密钥泄露时控制受波及的范围。

    来源Binance Spot API spec, endpoint security types

  5. 05 · recvWindow

    默认 5000 毫秒；时钟漂移会导致错误 -1021 INVALID_TIMESTAMP

    Binance 规定：“If recvWindow is not sent, it defaults to 5000 milliseconds. Maximum recvWindow is 60000 milliseconds.” 并且：“It is recommended to use a small recvWindow of 5000 or less!” 如果容器的时钟漂移大于 recvWindow，请求将被拒绝并返回错误 -1021。TradingHost 运行环境已进行 NTP 时间同步，因此默认的 5000 毫秒完全适用。除非您遇到实际的拒绝错误，否则请勿调大 recvWindow，且绝不能将其作为解决时间同步问题的替代方案。

    来源Binance Spot API spec, timing security

  6. 06 · 测试网隔离

    现货测试网与合约测试网为独立环境

    testnet.binance.vision（现货）与 testnet.binancefuture.com（合约）发放不同的密钥、持有独立的余额并提供不同的接口。常见的隐性身份验证失败包括：使用现货测试网密钥配置合约策略，或者在将测试网验证过的代码推向生产环境时忘记更换密钥集。请将测试网和生产环境的敏感信息保存在独立的 TradingHost Secrets 条目中，切勿跨环境混用。

    来源Spot TestnetFutures Testnet

Section 06 · 适用场景

适用场景

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

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

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

Section 08 · 常见问题

常见问题

没有。TradingHost 是独立的平台，与 Binance 没有任何隶属关系。

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

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

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

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

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

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

可以。基于 CCXT 的 Binance 策略可以在 TradingHost 上运行。完整的设置方法请参阅 CCXT 框架运行环境页面。

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

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

保存在由您掌控的 GitHub Secrets 工作流中。TradingHost 在运行时通过 GitHub 仓库密钥（repository secrets）、环境密钥（environment secrets）或您认可的其他密钥管理流程来读取它们。TradingHost 不需要托管您的 API 密钥和私钥。完整的处理模式请参阅平台密钥页面。

不需要。交易策略绝不需要提币权限。请使用受限的权限范围（读取、现货交易、合约交易），并在合适的地方配置 IP 白名单。

可以。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 branch）进行常规的 git push 即可触发重新部署。

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

错误 -2015 "Invalid API-key, IP, or permissions for action" 通常意味着请求 IP 未被列入您密钥的白名单，或者该密钥缺少访问该接口的权限（例如，使用现货密钥请求合约接口）。在 TradingHost 上，由于容器会重新调度，请将您所选区域公布的出口 IP 范围（而非单个 IP）加入白名单。完整指南请参阅上方的“运营说明”部分。

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

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