阅读时间 … 分钟

OKX 交易策略的 AI 原生运行环境

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

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
OKX
平台类型
加密货币交易所
资产类别
加密货币
支持的产品
现货、永续合约、交割合约、期权（BTC 和 ETH）、杠杆、Simple Earn（活期和定期）。USDT 保证金 BTC/ETH 交割合约将于 2026 年 6 月 26 日前逐步下线，此后将继续提供 USD 保证金交割合约。
运行环境模式
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 OKX v5 REST 和 WebSocket、CCXT (okx)、Hummingbot (okx, okx_perpetual)、Freqtrade（现货和期货，有注意事项）、自定义
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
OKX 角色
交易所账户、API 访问、市场接入、执行场所
关联关系
TradingHost 保持独立，与 OKX 无任何隶属关系

第 02 部分 · OKX 平台功能

OKX 平台功能

OKX 通过支持 multi-currency 和 portfolio margin 模式的 Unified Account 提供现货、永续合约、交割合约、BTC 和 ETH 期权以及杠杆交易。其 v5 API 提供了 REST 以及三个 WebSocket URL（Public、Private、Business），并提供了一个模拟盘环境（该环境使用生产环境的主机名，并通过添加 `x-simulated-trading: 1` 请求头来访问，而不是使用独立的测试网主机）。具体的 API 接口可能会随时间变化，但整体架构是稳定的；具体的限频权重、手续费等级和交易对列表请参考 OKX 官方文档。

市场与策略模式

  • 永续合约（USDT 保证金和币本位保证金）
  • BTC 和 ETH 期权策略（备兑看涨期权、价差套利、到期日交易）
  • portfolio margin 模式（基于跨产品风险的保证金）
  • multi-currency margin 模式（多种资产共享折算为 USD 价值的保证金）
  • 涵盖现货、杠杆、永续、交割和期权的 Unified Account
  • 母账户下的子账户层级架构
  • 通过模拟盘 API 密钥及 x-simulated-trading: 1 请求头进行模拟交易
  • 模拟盘到实盘的平滑过渡（使用独立的模拟盘密钥，随后直接切换为实盘密钥，无需重写代码）

API 接口

产品范围
现货、永续合约、交割合约、期权（BTC、ETH）、杠杆，以及镜像相同接口的模拟交易（模拟盘）环境。OKX 没有独立的 testnet.okx.com 主机：模拟盘直接使用生产环境的主机名，只需在每个请求中设置 x-simulated-trading: 1，并使用在模拟交易面板中创建的模拟盘 API 密钥即可。
连接方式
REST v5、WebSocket Public (wss://ws.okx.com:8443/ws/v5/public)、WebSocket Private (wss://ws.okx.com:8443/ws/v5/private)、WebSocket Business (wss://ws.okx.com:8443/ws/v5/business)。除了 REST 之外，还可以通过 WebSocket 进行下单、改单和撤单。
身份验证
HMAC-SHA256 签名、API key、secret 和 passphrase（三段式凭据）。请求头：OK-ACCESS-KEY、OK-ACCESS-SIGN、OK-ACCESS-TIMESTAMP（ISO 8601 UTC，毫秒级）、OK-ACCESS-PASSPHRASE。每个 API 密钥的白名单最多支持 20 个 IP。模拟交易使用独立的模拟盘密钥并配合 x-simulated-trading: 1 请求头。

具体细节请参考 OKX

具体接口、限频权重、交易对列表、手续费等级和版本历史均记录在 OKX 官方文档中。请以此作为最终事实来源。

第 03 部分 · 用 AI 构建

用 AI 构建您的 OKX 策略

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

  • 原生 OKX v5 API

    直接控制 OKX 特有的行为、Unified Account 状态、子账户路由以及订单执行逻辑。

  • CCXT

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

    开始使用 CCXT

  • Freqtrade 或 Hummingbot

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

    开始使用 Freqtrade开始使用 Hummingbot

  • 自定义连接器

    您自研的交易引擎或专属的 OKX 集成方案。

框架对 OKX 产品的支持情况

支持范围因框架而异。CCXT 覆盖了最广泛的 OKX 功能；Freqtrade 和 Hummingbot 支持现货和永续合约（Freqtrade 还支持交割合约）；原生 OKX v5 API 访问则支持 OKX 提供的所有产品，包括 BTC 和 ETH 期权。

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

✓ 表示官方框架文档确认支持。“partial” 表示支持有限或仅支持行情数据。“no” 表示官方文档未说明支持。

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

使用 AI 编写

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

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

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

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

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

  3. 步骤 03

    部署至 TradingHost 容器

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

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

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

部署

Section 05 · 运维说明

OKX 运维说明

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

  1. 01 · API 版本

    OKX 当前版本为 v5；v3 已于 2022 年退役，无 v4 版本

    OKX 跳过了 v4（因数字 4 的谐音寓意），直接从 v3 升级到了 v5。在 Unified Account 迁移基本完成后，v3 API 已于 2022 年 1 月 5 日正式下线。目前没有 v3 的备用方案：所有集成都应指向 v5 接口。

    来源OKX Unified Account migration announcementOKX v5 upgrade guide

  2. 02 · 模拟交易

    模拟盘使用请求头标志和独立密钥，而非独立主机

    OKX 没有运行独立的 testnet.okx.com 主机。模拟交易使用的是生产环境的主机名，需要在每个请求中设置 x-simulated-trading: 1，并配合在模拟交易面板中创建的模拟 API 密钥。实盘密钥无法在模拟环境中通过验证，而模拟密钥在缺少该请求头时会静默失败。

    来源OKX demo trading guideOKX API FAQ

  3. 03 · 身份验证

    三段式凭据加签名时间戳

    OKX 需要 API key、secret 和 passphrase（此 passphrase 是在创建密钥时设置的，而非账户密码）。请求需要使用 HMAC-SHA256 base64 对 时间戳 + 方法 + requestPath + body 进行签名，并将结果放入 OK-ACCESS-SIGN 中。错误代码 50111 对应密钥无效，50113 对应签名无效，这两者通常在缺少 passphrase 或时间戳偏差时出现。

    来源OKX API v5 referenceOKX API FAQ

  4. 04 · WebSockets

    三个 WebSocket URL，而非一个

    OKX 将 WebSocket 流量拆分为公共（Public，行情数据，无需验证）、私有（Private，账户、成交、持仓、订单，需要验证登录）和业务（Business，算法、网格及部分特定频道）。如果策略在公共 URL 上订阅仅限业务的频道，将无法接收到任何数据，表现为“静默”。频道与 URL 的映射关系会偶尔调整，在添加订阅前请检查迁移说明。

    来源OKX WebSocket URL changes

  5. 05 · 账户模式

    portfolio margin 模式为主动启用，且会改变保证金计算方式

    Unified Account 拥有多种模式（简单、单币种保证金、multi-currency margin、portfolio margin）。多币种模式使用折合为 USD 的资产作为共享保证金。portfolio margin 则在现货、杠杆、永续、交割和期权之间应用基于风险的模型，以提高资金效率。OKX 已在 multi-currency margin 和 portfolio margin 模式中停用逐仓保证金持仓，因此针对逐仓模式编写的仓位计算逻辑无法直接迁移。

    来源OKX multi-currency vs portfolio margin

  6. 06 · 美国地区访问限制

    全球站 OKX 屏蔽美国零售用户；OKX US 为独立平台

    2025 年 2 月，DOJ 宣布 OKX 关联实体 Aux Cayes FinTech Co. Ltd. 承认经营未经许可的资金传送业务，并同意支付总计约 5.05 亿美元的罚金（没收 4.203 亿美元，罚款 8440 万美元）。作为政策，全球站 OKX 自 2017 年起便限制美国人士访问，该限制在 okx.com 上持续生效。随后，OKX 于 2025 年在 okx.com/en-us 上重新推出了独立的美国实体（上线时覆盖 41 个州；肯塔基州、纽约州、德克萨斯州及少数领地暂不适用）。策略应针对与账户所属持牌实体相匹配的 OKX 终端。

    来源DOJ $500M settlement with OKX affiliate

  7. 07 · IP 白名单

    未绑定 IP 白名单的 API 密钥存在合规与安全风险

    OKX 每个密钥的白名单最多支持 20 个 IP，并强烈建议将密钥绑定到特定 IP。如果不绑定 IP，一旦密钥泄露，便可在任何地方被使用。对于容器化运行环境，请使用策略所在区域的静态出口 IP，并将其添加到密钥的白名单中；一旦怀疑有泄露风险，请立即轮换 passphrase 和 secret（passphrase 一旦丢失将无法找回）。

    来源OKX API FAQ

Section 06 · 适用场景

适用场景

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

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

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

Section 08 · 常见问题

常见问题

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

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

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

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

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

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

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

CCXT 支持对接 OKX（okx，前身为 okex）的现货和永续合约交易，以及账户、行情和历史数据，同时也支持交割合约。虽然可以通过 OKX 的命名规则获取期权行情数据，但通过 CCXT 的统一方法执行期权委托会受到限制；建议通过原生的 OKX v5 客户端路由期权订单。OKX 交易所对象需要配置 apiKey、secret 和 password（即 passphrase），以及标准的子账户请求头。请参阅 CCXT 框架运行环境以获取完整的配置指南。

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

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

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

不需要。交易策略绝不应该需要提币权限。请使用限定范围的权限（只读、交易），并利用 OKX 的 IP 白名单（每个密钥最多支持 20 个 IP）将密钥绑定到您运行环境的出口 IP。

OKX 使用三段式凭据：API key、secret 和 passphrase。passphrase 是用户在创建 API 密钥时自行设置的字符串，在每次需要身份验证的请求中通过 OK-ACCESS-PASSPHRASE 发送，并与 secret 一起混入 HMAC-SHA256 签名中。如果 passphrase 丢失，OKX 无法找回，您只能重新生成密钥。请将其视为另一个需要妥善保管的机密。

可以。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，即可触发重新部署。

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

50111 表示 OKX 找不到该 API 密钥（密钥错误、环境错误，或在实盘中使用了模拟盘密钥）。50113 表示签名验证失败。常见原因包括：密码（passphrase）错误或缺失、私钥（secret）错误、OK-ACCESS-TIMESTAMP 时钟偏差（必须是精确到毫秒的 ISO 8601 UTC 格式）、待签名字符串顺序错误（应为 timestamp + method + requestPath + body），或者在使用模拟盘密钥时遗漏了 x-simulated-trading: 1 请求头。建议在容器中运行 NTP 同步，并在非生产构建中记录待签名字符串。

可以。在 OKX 模拟交易面板中创建模拟盘 API 密钥，并在每个 REST 和 WebSocket 请求头中添加 x-simulated-trading: 1。域名保持不变。模拟盘密钥无法进行实盘交易，实盘密钥也无法进行模拟盘交易，且每次调用都必须携带该请求头。在切换到实盘时，请务必同时更换密钥并移除或修改该请求头。

账户模式在 Unified Account 级别进行设置，并会影响保证金计算。multi-currency margin 将折合为 USD 的资产视为共享保证金。portfolio margin 则采用基于风险的模型，对现货、杠杆、永续、交割和期权的风险敞口进行净额结算。在 multi-currency margin 或 portfolio margin 模式下，不再支持逐仓保证金仓位。

根据 2017 年的一项政策，全球站 OKX (okx.com) 限制美国个人用户使用。2025 年 2 月，OKX 关联公司 Aux Cayes FinTech Co. Ltd. 承认在美国运营未经许可的资金传送业务，并支付了 5.05 亿美元。另一个独立的美国实体 (okx.com/en-us) 于 2025 年在美国 41 个州重新上线。OKX US 与全球站 OKX 是不同的交易平台；在部署前，请确认您的账户属于哪一个实体。

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

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