阅读时间 … 分钟

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

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

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
Bybit
平台类型
加密货币交易所（以衍生品为主）
资产类别
加密货币（现货、正向与反向永续合约、USDC 交割合约、期权、价差交易）
支持的产品
现货、USDT 永续合约、USDC 永续合约、USDT 交割合约、USDC 交割合约、反向永续合约、反向交割合约、欧式 USDC 期权、价差交易、跟单策略、模拟交易。通过 UTA 2.0 提供（2025 年及之后注册的账户默认开通）；老用户仍可使用 UTA 1.0。不再提供 Classic 账户。
运行环境模式
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 Bybit v5 REST 与 WebSocket、CCXT、Freqtrade、Hummingbot、自定义
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 及 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
Bybit 角色
交易所账户、API 接入、市场接入、执行场所
关联关系
TradingHost 保持独立，与 Bybit 无任何隶属关系

第 02 部分 · Bybit 平台功能

Bybit 平台功能

Bybit 的 v5 API 通过单一的 `category` 参数统一了现货、正向与反向永续合约、USDT 与 USDC 交割合约以及欧式 USDC 期权，并提供 Spread Trading 和模拟交易作为额外接口。在 UTA 2.0 下，所有类别共享同一个跨产品保证金池。策略使用 HMAC-SHA256（系统生成）或 RSA-SHA256（自生成）密钥进行身份验证，并通过 REST 或 WebSocket 接入交易所。主网、测试网和主网模拟是三个独立的运行环境，其密钥命名空间互不相通。具体端点可能会随时间变化。整体架构是稳定的，而具体的速率限制额度、手续费等级和交易对列表请参考 Bybit 官方文档。

市场与策略模式

  • USDT 永续合约做市
  • USDC 永续合约基差与套利交易
  • 反向永续合约币本位套期保值
  • 期权 Gamma 剥头皮（USDC 结算，组合保证金模式）
  • 通过 Spread Trading 订单簿进行资金费率套利
  • 通过 Master Trader 自动化实现跟单策略
  • UTA 2.0 跨产品组合保证金策略
  • 在主网部署前进行模拟交易演练

API 接口

产品范围
统一的 v5 类别（`spot`、`linear`、`inverse`、`option`），以及 Spread Trading 和模拟交易端点。UTA 2.0 将所有类别统一在同一个保证金池下。主网、测试网 (api-testnet.bybit.com) 和主网模拟 (api-demo.bybit.com) 是三个独立的运行环境，其密钥命名空间互不相通。
连接方式
REST v5 (HTTPS)、WebSocket 公有（行情数据）、WebSocket 私有（订单、执行、持仓、钱包）、WebSocket 交易（通过 WS 报单，仅限主网）。
身份验证
HMAC-SHA256（系统生成的密钥）或 RSA-SHA256（自生成的密钥）。必需的请求头：`X-BAPI-API-KEY`、`X-BAPI-TIMESTAMP`、`X-BAPI-SIGN`、`X-BAPI-RECV-WINDOW`（默认 5000 毫秒）。支持子账户层级及单密钥 IP 白名单。来自美国或中国大陆 IP 的 API 访问将返回 HTTP 403。

具体细节请参考 Bybit

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

第 03 部分 · 用 AI 构建

用 AI 构建您的 Bybit 策略

选择一种集成方式，派生 (fork) 一个 TradingHost 框架模板，并在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 和基于 CLI 的 AI 智能体均可配合相同的 GitHub 原生部署循环工作。Bybit 的 v5 基于类别的产品体系和 UTA 2.0 跨产品保证金意味着，单个策略即可通过一个统一账户触及现货、永续合约、交割合约和期权。

  • 原生 Bybit API

    通过 v5 统一 API 直接控制 Bybit 特有的行为、账户数据和订单执行逻辑。

  • CCXT

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

    开始使用 CCXT

  • Freqtrade 或 Hummingbot

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

    开始使用 Freqtrade开始使用 Hummingbot

  • 自定义连接器

    您自有的内部交易引擎或专属 Bybit 集成。

框架对 Bybit 产品的支持情况

支持范围因框架而异。CCXT 和原生 v5 覆盖了 Bybit 的全部功能；Freqtrade 支持现货和正向永续合约（建议每个机器人使用一个子账户）；Hummingbot 支持现货和永续合约，并提供部分反向合约支持（一次仅限一种模式）。

框架现货永续反向期权
Native Bybit v5已支持已支持已支持已支持
CCXT已支持已支持已支持已支持
Freqtrade已支持已支持未记录支持未记录支持
Hummingbot已支持已支持部分支持未记录支持

✓ 官方框架文档确认支持。“partial” 表示文档有记载但存在限制（例如一次仅限一种模式）。“no” 表示官方文档未说明支持。

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

使用 AI 编写

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

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

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

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

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

  3. 步骤 03

    部署至 TradingHost 容器

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

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

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

部署

Section 05 · 运维说明

Bybit 运维说明

在容器化云端运行环境中实际运行 Bybit 策略时会遇到的棘手问题，这些在 Bybit 文档或框架的 README 中是找不到的。以下所有陈述均引用或转述自 Bybit 官方文档；部署侧的指南则源于在 TradingHost 上运行这些策略的实际经验。

  1. 01 · v5 统一化

    v5 API 统一产品类别；v3 已于 2024 年 8 月停用

    Bybit 的 v5 API 通过单一的 `category` 参数统一了现货、正向永续、反向永续和期权。官方的 v3 到 v5 过渡已于 2024 年 8 月 31 日停用了 v3 端点。请针对 v5 编写所有新代码；调用 v3 将返回错误。

    来源Bybit v3-to-v5 transition announcement

  2. 02 · 运行环境

    主网、测试网和主网模拟是三个不同的主机

    主网使用 api.bybit.com 和 stream.bybit.com。测试网使用 api-testnet.bybit.com 和 stream-testnet.bybit.com。主网 Demo 使用 api-demo.bybit.com，私有流使用 wss://stream-demo.bybit.com（公共行情数据仍来自主网）。不同环境之间的 API 密钥不通用，在测试网主机上使用 Demo 密钥会返回 error 10003。WS Trade（通过 WebSocket 下单）在 Demo 环境中不可用。

    来源Bybit v5 demo tradingBybit v5 introduction

  3. 03 · 账户模式

    UTA 2.0、UTA 1.0 与传统 Classic 模式对比

    Bybit 曾存在三种账户模式：Classic（已不再提供）、UTA 1.0（统一现货以及 USDT/USDC 衍生品和期权，反向合约仍保持独立）和 UTA 2.0（所有 category 共享一个保证金池，支持全仓或组合保证金）。2025 年或之后注册的账户默认采用 UTA 2.0。升级到 UTA 是不可逆的；在 UTA 2.0 中，反向合约不再支持对冲模式（hedge mode）。

    来源Bybit v5 account modes

  4. 04 · 速率限制

    单 UID 单 category 滚动窗口限制

    v5 的频限采用单 UID 滚动窗口机制，并按 category 进行隔离。创建订单的频限为：spot 和 linear 为 20 次/秒，inverse 和 option 为 10 次/秒；修改订单在上述四个类别中均为 10 次/秒；撤单频限与创单相同。IP 级别的上限为每 5 秒窗口 600 次 HTTP 请求。批量接口按订单数量（而非请求次数）计入频限，每批上限分别为 10 个（spot）和 20 个（linear / inverse / option）。响应头中会返回剩余的频限额度。

    来源Bybit v5 rate limits

  5. 05 · 安全历史

    2025 年 2 月 Lazarus 安全事件及后续改进

    2025 年 2 月 21 日，与朝鲜 Lazarus Group (TraderTraitor) 相关的攻击者通过入侵第三方多签服务商 Safe{Wallet} 的开发人员工作站并篡改签名者界面，从 Bybit 冷钱包中窃取了约 15 亿美元的 ETH。FBI 在 IC3 PSA-250226 中确认了这一归属。Bybit 在此期间保持正常运营：提币未中断，Hacken 的 Proof of Reserves 审计确认其在 BTC、ETH、SOL、USDT 和 USDC 上的准备金率均超过 100%，且 Bybit 公开声明用户资金未受影响。此后，Bybit 隔离了签名基础设施、重新设计了多签流程、审计了第三方工具、增加了转账异常检测，并继续与 Hacken 合作进行每月的 Merkle-tree PoR。对于 API 用户而言，这属于历史背景：安全防护态势已有所改变，但 API 接口范围并未变化。

    来源FBI IC3 PSA-250226Hacken Bybit Proof of Reserves

  6. 06 · 地区限制

    API 边缘端屏蔽美国和中国大陆 IP

    v5 指南明确指出，源自美国或中国大陆的 IP 地址将返回 403 Forbidden 错误。Bybit 为荷兰、土耳其、哈萨克斯坦、格鲁吉亚、阿联酋、欧洲经济区（EEA）和印度尼西亚等地区提供了区域性域名。KYC 是强制性的，即使 IP 地址通过，美国居民身份也会在验证时被拦截。在为 Bybit 部署策略时，TradingHost 运行环境的地域选择应避开美国区域。

    来源Bybit v5 guide (auth, headers, IP restrictions)

  7. 07 · 常见错误

    需进行监控的身份验证与频限错误码

    10003 invalid api_key 通常意味着环境配置错误（例如主网密钥请求了测试网主机，或 Demo 密钥请求了主网）。10004 invalid sign 表示时钟偏差超出了 `recv_window`，或者签名负载（payload）的拼接顺序有误。10018 exceed IP rate limit 表示触发了每 5 秒 600 次请求的 IP 频限上限；此时应根据 `X-Bapi-Limit-Reset-Timestamp` 进行退避。对于 10003 和 10004 错误，应将其视为“报警并停止”信号，而非进行重试。

    来源Bybit v5 error codes

  8. 08 · 价差交易

    Spread Trading 采用独立的订单簿

    Spread Trading 支持 BTC、ETH、SOL 的现货/永续、现货/交割、永续/交割以及交割/交割组合，拥有独立的订单簿，且手续费比手动分腿下单低 50%。在 v5 文档中，它被列为功能板块，而非一个有文档记录的 `category`；在进行对接时，请通过帮助中心提供的接口参考进行路由。

    来源Bybit Spread Trading help center

Section 06 · 适用场景

适用场景

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

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

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

Section 08 · 常见问题

常见问题

没有。TradingHost 是一家独立运营的平台，与 Bybit 无任何隶属关系。

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

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

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

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

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

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

可以。CCXT 的 bybit 交易所模块支持基于 v5 的现货、正向和反向永续合约、USDT 和 USDC 交割合约以及 USDC 期权。您可以直接将您的 CCXT 策略从 GitHub 部署到 TradingHost 运行环境中；我们负责运行，您自己保管密钥。请参阅 CCXT 框架运行环境了解完整的配置流程。

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

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

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

不需要。交易策略绝不应该需要提币权限。请在合适的情况下使用精细化的权限控制和针对单个密钥的 IP 白名单，并将提币权限保留在另一个手动管理的独立密钥上。

可以。TradingHost 支持针对 AI IDE（包括 Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI Agent）的 MCP 控制。AI 工具可以检查部署状态、查看日志、重启策略并管理运行环境工作流。MCP 仅作为控制和可观测性面板，而非交易执行路径。请参阅 MCP 控制面板了解完整详情。

两者皆可。MCP 控制面在基于 CLI 的智能体（如 Claude Code CLI、自定义 MCP 客户端、脚本化 MCP 调用）和 IDE 内部的运行效果同样出色。GitHub 原生的部署工作流也无需任何 AI 工具：只需向您的 main 分支进行常规的 git push 即可触发重新部署。

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

几乎所有的 10004 错误都由以下三个原因引起：由于时钟漂移导致请求时间戳超出 recv_window 窗口（默认 5000 毫秒）、签名负载中的参数顺序组装错误，或者不小心将 HMAC 负载格式与 RSA 密钥混用（反之亦然）。请在签名之前同步您的运行时时钟或获取 Bybit 服务器时间。完整指南请参阅上方的操作说明部分。

Bybit 运行着三个密钥命名空间互不相通的环境：mainnet、testnet (api-testnet.bybit.com) 和 mainnet demo (api-demo.bybit.com)。在其中任何一个环境中生成的密钥，在另外两个环境中都会返回 10003。请从对应的控制面板中生成一个全新的密钥。

2025 年或之后开立的账户默认使用 UTA 2.0。如果您目前使用的是 Classic 或 UTA 1.0，并且需要跨产品保证金，请进行升级。请注意，该升级是不可逆的，且 inverse 合约将失去双向持仓模式（hedge mode）。请先在 demo 环境中进行测试。

不可以。Bybit 在 API 边缘通过 403 响应拦截了美国和中国大陆的 IP，且其 KYC 拒绝美国居民身份。TradingHost 无法绕过此限制；该限制是由 Bybit 设定的。

该事件是真实的、规模很大，且有详细记录（FBI IC3 PSA-250226）。Bybit 的热钱包运营、提币和客户余额未受影响；2 月 26 日的 Hacken Proof of Reserves 审计确认主要资产的准备金率超过 100%。此后，Bybit 隔离了签名基础设施，重新设计了多签流程，并继续每月进行 Merkle-tree PoR。对于量化策略用户而言，这属于运营背景信息，并非当前的 API 阻碍，但请务必正视交易所的托管风险，并据此控制资金规模。

TradingHost 运行在 EU 和 US-East 地区。请选择最靠近您策略所依赖的撮合引擎的地区。请注意，Bybit 在 API 边缘屏蔽了美国 IP，因此 Bybit 策略不应从 US-East 地区进行路由。有关路由和邻近度的详细信息，请参阅地区页面。

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