适用于 BitMEX 交易策略的 AI 原生运行环境
在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署到托管云端运行环境，享有原生 MCP 控制、日志和区域选择支持。
第 01 部分 · 一览
一览
- 交易平台
- BitMEX
- 平台类型
- 加密货币交易所（永续合约先驱）
- 资产类别
- 加密货币衍生品（永续掉期与期货）
- 支持的产品
- XBTUSD inverse perpetual（每张合约名义价值 1 USD）、USDT 和 BTC 计价的永续掉期、dated futures，以及特定标的的预测市场风格合约。测试网地址为 testnet.bitmex.com。美国用户因 API 密钥级别的 IP geolocation 限制而被屏蔽。
- 运行环境模式
- 容器化策略运行环境
- 部署源
- GitHub
- 编程语言
- 任何可在容器中运行的语言
- 常用集成
- 原生 BitMEX REST 和 WebSocket、CCXT、自定义连接器
- AI 工作流集成
- 适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
- TradingHost 角色
- 运行环境、部署、日志、健康检查、区域选择、MCP 控制
- BitMEX 角色
- 交易所账户、API 访问、市场准入、执行场所
- 关联关系
- TradingHost 保持独立，与 BitMEX 无任何隶属关系。
第 02 部分 · BitMEX 平台功能
BitMEX 平台功能
BitMEX 开创了加密货币永续掉期合约，且目前仍是仅限衍生品交易的场所。XBTUSD 是其旗舰级 inverse perpetual，每张合约名义价值为 1 USD，并以 Bitcoin 结算。USDT 计价和 BTC 计价的永续合约以及 dated futures 构成了其主要产品线。所有 Bitcoin 数量均以 XBt（聪）为单位，所有 USD 数量均以 USDt 为单位；需要进行客户端转换。具体端点可能会随时间变化。虽然整体架构保持稳定，但具体的合约规格、频率限制权重和费率层级请以 BitMEX 的官方文档为准。
市场与策略模式
- XBTUSD inverse perpetual 做市策略
- BTC 计价的永续掉期策略
- USDT 计价的永续掉期策略
- Dated futures 基差与日历价差交易
- Inverse perpetuals 的 funding rate 套利
- 在主网上线前通过测试网验证部署
- WebSocket 私有频道的订单与持仓数据流
- 结合非 BitMEX 现货或衍生品交易场所的跨平台套利
API 接口
- 产品范围
- 永续掉期（XBTUSD inverse、USDT 计价、BTC 计价）、dated futures，以及特定标的的预测市场风格合约。位于 testnet.bitmex.com 的测试网镜像了生产环境的 API 接口，但使用独立的密钥和余额。
- 连接方式
- 通过 https://www.bitmex.com/api/v1 的 REST 接口进行下单和账户查询。通过 WebSocket 流获取实时市场数据、深度和交易信息。通过 WebSocket 私有频道获取账户、持仓和订单事件。
- 身份验证
- 每个策略使用永久 API 密钥和私钥。私有请求使用 HMAC-SHA256 对 verb + path + nonce + body 进行签名。nonce 可以是 Unix 时间戳（微秒）或 api-expires 请求头的值。美国用户因 API 密钥级别的 IP geolocation 强制执行而被屏蔽；虽然可以成功创建密钥，但交易端点会拒绝访问。
- 计价币种
- 所有 Bitcoin 金额均以 XBt（聪，1 XBt = 0.00000001 XBT）计价。所有 USD 金额均以 USDt（1 USDt = 0.000001 USDT）计价。XBTUSD 永续合约每张名义价值为 1 USD，以 Bitcoin 结算。在呈现或计算标准 BTC 或 USD 单位时，需要进行客户端转换。
具体细节请参考 BitMEX
具体端点、合约规格、频率限制权重、费率层级和版本历史记录均在 BitMEX 的官方文档中提供。请以这些文档为准。
第 03 部分 · 用 AI 构建
用 AI 构建您的 BitMEX 策略
选择一种集成方式，Fork 一个 TradingHost 框架模板，然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI Agent 均可无缝接入相同的 GitHub 原生部署循环。
原生 BitMEX API
直接控制 BitMEX 的特定行为、XBt 和 USDt 计价单位以及订单执行逻辑。
自定义连接器
您自己的内部交易引擎或专有的 BitMEX 集成。
框架对 BitMEX 产品的支持情况
BitMEX 是仅限衍生品交易的场所：矩阵中没有现货列。CCXT 通过统一的 bitmex 类提供永续合约和 dated futures；Hummingbot 通过 bitmex_perpetual 支持永续掉期；Freqtrade 未将 BitMEX 列为支持的交易所。原生 BitMEX API 访问可覆盖 BitMEX 列出的所有合约。
✓ 表示官方框架文档确认支持。“no” 表示官方文档未明确说明支持。
TradingHost 不强求特定的框架，它只负责运行您的项目。
使用 AI 编写
上述框架模板与 AI IDE 是绝佳的搭配。TradingHost 的 MCP 控制面实现了闭环：AI 工具可以与您一同检查部署、查看日志并管理运行环境，但绝不会介入交易执行路径。
Section 04 · 在 TradingHost 上运行
在 TradingHost 上运行您的代码
BitMEX 提供交易所和 API 访问。TradingHost 则提供生产环境，用于运行您连接到 BitMEX 的策略。
无需在笔记本电脑、台式机、通用 VPS 或手动配置的服务器上运行策略代码，您只需从 GitHub 部署到由 TradingHost 托管的容器运行环境中。
您
- 您的代码库包含您的代码。
- 您的部署定义了其运行方式。
- 您的策略连接到 BitMEX。
TradingHost
- 保持运行环境持续在线。
- 呈现日志和健康状况检查。
- 区域选择。
- 受控的部署环境。
部署流程
- 步骤 01
连接 GitHub
授权 TradingHost 访问您的 GitHub 帐户。
- 步骤 02
关联代码库或从框架开始
将 TradingHost 指向您现有的策略仓库，或者派生（fork）一个 TradingHost 框架运行环境（CCXT 或 Hummingbot）作为可运行的基础模板。
- 步骤 03
部署至 TradingHost 容器
选择一个区域（EU 或 US-East），提供您的策略所需的环境变量（BitMEX API key 和 secret 等），然后进行部署。TradingHost 会从代码仓库构建您的容器，并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。
- 步骤 04
监控日志与健康状况
通过 TradingHost 控制面板实时查看日志、健康状况和运行状态。该界面同样支持在任何 AI IDE 中通过 MCP 进行访问，方便 Cursor、Claude Code 或 CLI 智能体与您协同读取部署状态并管理运行环境。
- 步骤 05
更新与重新部署
将代码更改推送到 GitHub 的主分支（main branch），TradingHost 便会自动重新部署。
Section 05 · 运维说明
BitMEX 运维说明
在容器化云端运行环境中实际运行 BitMEX 策略时会遇到的陷阱，这些在 BitMEX 的文档或框架的 README 中是找不到的。以下所有内容均引用或转述自 BitMEX 官方文档；部署端的指南源自我们在 TradingHost 上运行这些策略的实际经验。
01 · XBt 计价单位
所有 Bitcoin 金额均以聪为单位（1 XBt = 0.00000001 XBT）；USD 以 USDt 为单位（1 USDt = 0.000001 USDT）
BitMEX API 响应使用非标准计价单位。Bitcoin 余额、walletBalance 字段、持仓保证金和订单名义价值均以 XBt（聪）而非 XBT 表示。以 USD 计价的金额则以 USDt 表示，比 USDT 小六个小数点。如果策略需要在面向用户的界面中呈现或计算持仓，必须在客户端进行转换。上线首日最常见的 Bug 是：策略本意是建立一个 0.1 BTC 的仓位，但由于忘记了转换，最终只建立了 0.1 XBt 的仓位。
02 · XBTUSD 合约
每个 XBTUSD 永续合约名义价值为 1 USD，以 Bitcoin 结算（反向合约）
XBTUSD 是一种反向永续合约：每个合约代表 1 USD 的名义敞口，盈亏和保证金均以 Bitcoin 结算。强平价格以 USD 计算。这与线性的 USDT 保证金永续合约不同，后者的合约大小随标的代币数量而变化。混合使用多个交易平台的策略必须针对每个工具单独编码合约乘数和结算货币，而不能假设整个账本的合约形式完全一致。
03 · 美国地理限制
API 密钥启用 IP geolocation 强制拦截，限制美国用户访问
BitMEX 禁止美国交易者。该限制是通过 IP geolocation 在 API key 级别实施的：无论账户验证状态如何，只要 API key 最近的流量被定位到美国，其私有端点请求就会被拒绝。因此，位于 US-East 区域且使用美国出口 IP 的 TradingHost 运行环境将被阻止在 BitMEX 上进行交易。请选择一个出口地理位置既符合 BitMEX 用户协议又符合您自身合规要求的 TradingHost 区域。
04 · Nonce 签名
对 verb + path + nonce + body 进行 HMAC-SHA256 签名；相比原始 nonce 更推荐使用 api-expires
BitMEX REST 签名是对拼接字符串 verb + path + nonce + body 进行 HMAC-SHA256 加密，并使用您的密钥进行签名。nonce 可以是 Unix 微秒时间戳，或者更推荐使用 api-expires 请求头，它为请求提供一个未来的过期时间戳。使用 api-expires 可以避开严格的单调递增 nonce 要求，并且对容器之间的时钟偏差更具容错性。大多数 BitMEX SDK 默认使用 api-expires；请检查您的 SDK 并进行确认。
05 · 永久密钥
API 密钥在手动撤销前永久有效；测试网密钥相互隔离
BitMEX API 密钥不会自动过期。密钥轮换是手动责任：请定期轮换密钥，而不是依赖平台过期机制。位于 testnet.bitmex.com 的测试网发放独立的密钥、持有独立的余额并提供独立的端点；一个常见的隐性身份验证失败是，将经测试网验证的代码发布到生产环境，却忘记更换密钥集，反之亦然。请将测试网和生产环境的密钥保存在不同的 TradingHost Secrets 条目中，切勿跨环境复用。
06 · 速率限制
私有端点每分钟 REST 速率限制；热循环强烈推荐使用 WebSocket
BitMEX 在每分钟窗口内限制私有 REST 端点的速率。对于活跃策略，推荐的模式是通过 WebSocket 订阅来驱动市场数据和账户状态，仅在 WebSocket 无法执行的操作（如下单、撤单）中使用 REST。在紧密循环中轮询 REST 以获取订单簿更新或持仓状态会耗尽配额并产生 429 错误。
Section 06 · 适用场景
适用场景
TradingHost BitMEX 运行环境最适合用于：
- 在 AI IDE（Cursor、Claude Code）中构建策略的开发者
- 系统化加密货币交易员
- 量化开发者
- CCXT 和 Hummingbot 用户
- 专注于衍生品的交易台和永续合约做市商
- 从 VPS 托管转向容器化部署的团队
连接 GitHub 并创建首个策略完全免费。
Section 08 · 常见问题
常见问题
没有。TradingHost 是独立的，与 BitMEX 没有任何隶属关系。
不会。您的策略代码会根据您自己的逻辑、账户权限和集成方式连接到 BitMEX 并发送指令。TradingHost 仅提供运行该代码的运行环境。
不提供。BitMEX API 访问权限由 BitMEX 提供。您需要自行负责您的 BitMEX 账户、API 权限、凭据以及对 BitMEX 条款的合规性。
不是。TradingHost 是运行您策略代码的云端运行环境。我们不提供信号、AI 预测模型或预建的机器人。使用 TradingHost，您需要自己编写或生成策略（通常使用 Cursor 或 Claude Code），将其作为您自己的代码保存在 GitHub 中，并使用 TradingHost 在生产环境中运行。3Commas、Cryptohopper 及类似产品拥有策略逻辑；而 TradingHost 则是运行您自己的策略。
AWS 和 DigitalOcean 为您提供原始算力。您需要自己处理操作系统更新、容器编排、日志传输、密钥轮换、区域容灾和在线率监控。TradingHost 为您提供专为交易策略构建的托管运行环境：开箱即用的 GitHub 原生部署、来自 AI IDE 的 MCP 驱动控制、日志和健康状况界面。如果您想自己管理基础设施，AWS 可以满足需求。如果您希望将运行环境作为托管服务，TradingHost 是更便捷的途径。
可以。TradingHost 支持运行 Python 策略；选择与您的技术栈匹配的框架运行环境，或者部署您自己的仓库。
可以。TradingHost 支持任何可以在容器内运行的语言。
可以。CCXT 通过统一的 `bitmex` 类公开 BitMEX，涵盖永续合约和定期交割合约（dated futures）。这里没有需要支持的现货产品。有关完整的设置说明，请参阅 CCXT 框架运行环境。
不可以。BitMEX 禁止美国交易者。该限制是通过 IP geolocation 在 API key 级别实施的：无论账户验证状态如何，只要 API key 最近的流量被定位到美国，其私有端点请求就会被拒绝。因此，位于 US-East 区域且使用美国出口 IP 的 TradingHost 运行环境将被阻止在 BitMEX 上进行交易。请选择一个出口地理位置既符合 BitMEX 用户协议又符合您自身合规要求的 TradingHost 区域。
可以，如果您的项目是这样设计的。您可以在一个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中以实现隔离和运行清晰度。有关多策略模型，请参阅 TradingHost 运行环境页面。
最快的方法是 fork 一个 TradingHost 框架运行环境：选择 CCXT 或 Hummingbot 以获取开箱即用的部署项目。或者连接您自己的 GitHub 策略仓库。关联 GitHub 仓库和创建策略是免费的；运行环境方案列在价格页面上。
保存在您通过 GitHub 控制的密钥（secrets）工作流中。TradingHost 在运行时通过 GitHub 仓库密钥、环境密钥或您自己批准的密钥管理流程读取它们。TradingHost 不需要托管您的 BitMEX API 密钥和私钥。有关完整的处理模型，请参阅平台密钥。
不需要。策略绝不需要提币权限。请使用有范围限制的权限（订单、账户读取），并手动轮换密钥，因为 BitMEX 密钥不会自动过期。
可以。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 即可触发重新部署。
运行环境会检测到崩溃，并输出相关的日志和健康状态信息。在支持的场景下，受影响的策略可以独立重启，而不会干扰同一容器中运行的其他策略。您的策略代码仍需负责安全错误处理、防重复下单保护和风险控制。关于日志和健康状态界面，请参阅可观测性（observability）说明。
BitMEX 将所有 Bitcoin 金额以 XBt（satoshis）计价。1 XBt = 0.00000001 XBT，因此您读取到的 100,000,000 XBt 余额实际上是 1 BTC。USD 金额则以 USDt 计价，比 USDT 小六位小数。最常见的上线首日 Bug 是策略本意是以 BTC 计算仓位，却因为忘记进行单位转换而直接使用了 XBt。XBTUSD 永续合约的每张合约名义价值为 1 USD，并以 Bitcoin 结算。完整指南请参阅上方的“运营说明”（Operational notes）部分。
TradingHost 在 EU 和 US-East 区域运行。请选择最靠近您策略所依赖的撮合引擎的区域。有关路由和延迟细节，请参阅区域页面。
不支持。TradingHost 专注于生产环境的运行和部署。回测应当在您的研究技术栈、框架或 AlgoBuilder 中进行。