阅读时间 … 分钟

针对 Phemex 交易策略的 AI 原生运行环境

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

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
Phemex
平台类型
加密货币交易所
资产类别
加密货币
支持的产品
现货、USDT 及币本位永续合约、交割合约、sub-account，以及公开测试网
运行环境模式
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 Phemex REST 与 WebSocket、CCXT、Freqtrade、Hummingbot、自定义连接器
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 及 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
Phemex 角色
交易所账户、API 接入、市场准入、交易执行场所
关联关系
TradingHost 保持独立，与 Phemex 无任何隶属关系

第 02 部分 · Phemex 平台功能

Phemex 平台功能

Phemex 通过 REST 和 WebSocket API 提供现货、USDT 本位永续合约、币本位永续合约以及交割合约。身份验证采用 HMAC-SHA256，并需携带明确的请求过期时间戳。其限频机制分为三个独立的组（contract、spotOrder、others），因此繁忙的合约循环不会限制现货订单。位于 testnet-api.phemex.com 的独立测试网允许您在不使用真实资金的情况下，针对相同的 API 结构进行验证。Phemex US 作为一个独立的实体运行，全球 API 并不涵盖它。具体端点可能会随时间变化。虽然 API 的整体结构是稳定的，但具体的限频权重、手续费等级和交易对列表请参考 Phemex 的官方文档。

市场与策略模式

  • USDT 本位永续合约策略
  • 币本位（反向）永续合约策略
  • 针对 USDT 和 BTC 交易对的现货策略
  • 基于 sub-account 隔离的多策略部署
  • 在主网上线前通过测试网验证的部署
  • 永续合约资金费率套利
  • WebSocket 订单簿与交易流数据消费
  • 跨限频组执行（contract + spot）

API 接口

产品范围
现货、USDT 本位永续合约、币本位永续合约、交割合约以及 sub-account 层级架构。位于 testnet-api.phemex.com 的公开测试网运行在独立的资金池中，拥有专属的限频额度，且无法交易真实资产。Phemex US 作为一个独立的实体在独立的基础设施上运行，全球 Phemex 账户与 Phemex US 账户不可互通。
连接方式
REST 用于下单和账户查询。WebSocket 用于实时行情数据、订单簿更新、交易和账户事件。私有 WebSocket 订阅需要在连接时进行身份验证。
身份验证
API key、secret 以及使用 HMAC-SHA256 签名的请求过期时间戳。三个限频组（contract、spotOrder、others）各自拥有独立的请求额度，超出其中一个不会限制其他组。sub-accounts 可以持有权限范围限定在母账户之下的密钥。

具体细节请参考 Phemex

具体的端点、限频权重、交易对列表、手续费等级和版本历史均记录在 Phemex 的官方文档中。请以此作为权威参考。

第 03 部分 · 用 AI 构建

用 AI 构建您的 Phemex 策略

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

  • 原生 Phemex API

    直接控制 Phemex 特有的行为、账户数据以及跨现货、USDT 永续和币本位永续的订单执行逻辑。

  • CCXT

    跨 Phemex 和其他加密货币交易所的通用接口。CCXT 通过统一的 `phemex` 类公开 Phemex 的现货和永续合约市场。

    开始使用 CCXT

  • Freqtrade 或 Hummingbot

    基于框架的部署，使用其策略结构和配置模型。两者均将 Phemex 列为支持的交易所。

    开始使用 Freqtrade开始使用 Hummingbot

  • 自定义连接器

    您自己的内部交易引擎或专有的 Phemex 集成，使用 HMAC-SHA256 针对公开的带过期时间戳方案对请求进行签名。

框架对 Phemex 产品的支持情况

支持范围因框架而异。CCXT 涵盖了最广泛的 Phemex 现货和永续合约接口；Freqtrade 和 Hummingbot 支持现货，对永续合约的支持取决于连接器版本；原生 Phemex API 接入则涵盖了 Phemex 提供的所有功能，包括币本位合约和 sub-account 层级架构。

框架现货永续反向杠杆
Native Phemex API已支持已支持已支持已支持
CCXT已支持已支持部分支持部分支持
Freqtrade已支持部分支持未记录支持未记录支持
Hummingbot已支持已支持未记录支持未记录支持

✓ 表示官方框架文档确认支持。“no” 表示官方文档未说明支持。“partial” 表示支持有限，详见上文说明。

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

使用 AI 编写

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

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

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

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

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

  3. 步骤 03

    部署至 TradingHost 容器

    选择一个区域（EU 或 US-East），提供策略所需的环境变量（Phemex API key、secret 以及代码使用的过期时间戳方案），然后进行部署。TradingHost 会从代码仓库构建您的容器，并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

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

部署

Section 05 · 运维说明

Phemex 运维说明

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

  1. 01 · 限频拆分

    三个独立的请求组：contract、spotOrder 和 others

    Phemex 的 API 限频器被拆分为三个独立的组，而不是一个全局池。`contract` 组涵盖合约交易端点，`spotOrder` 涵盖现货订单下达，而 `others` 涵盖其他所有内容。每个组都拥有独立的请求额度；超出其中一个组的限制不会导致其他组被限频。在设计同时涉及现货和永续合约的策略时，请针对每个组的额度进行规划，而不是针对单一的合并上限。

    来源Phemex API reference, rate limits

  2. 02 · 请求过期

    每个签名请求都需要明确的过期时间戳

    Phemex 的签名方案要求在每个经过身份验证的请求中包含一个明确的过期时间戳（以 Unix 秒为单位，通常为 `now + 60`）。过期时间已过或设置得过远的请求将被拒绝。一个常见的隐性故障是：客户端代码在启动时计算一次过期时间，并在后续调用中重复使用，导致一分钟后每个请求都会返回 401 错误。请在签名时计算过期时间，而不是在对象构建时，并保持容器时钟通过 NTP 同步。

    来源Phemex API spec, authentication

  3. 03 · 测试网资金池

    Testnet 运行在独立的主机上，拥有专属的密钥和频率限制额度

    Phemex testnet（位于 `testnet-api.phemex.com`）发放独立的 API 密钥，持有独立的余额并提供独立的端点。常见的隐性身份验证失败是将生产策略配置了 testnet 密钥（或将经过 testnet 验证的代码直接推送到生产环境而未更换密钥集）。请将 testnet 和生产环境的敏感信息保存在不同的 TradingHost Secrets 条目中，切勿跨环境复用。testnet 的频率限制额度明显低于主网，请勿根据 testnet 的测试结果来规划策略的吞吐量。

    来源Phemex testnet docs

  4. 04 · 美国实体隔离

    Phemex US 是独立实体，拥有专属的基础设施

    Phemex US（`phemex.com/us`）作为与全球 Phemex 不同的独立公司实体运营，并运行在独立的基础设施上。全球 Phemex 账户无法访问 Phemex US，Phemex US 账户也无法对全球 Phemex 端点进行请求签名。如果您的策略需要在美区和非美区司法管辖区之间切换，请将交易平台选择作为首要的配置项，而不是仅通过密钥类型进行切换。受限司法管辖区的限制在账户创建时执行，并且可能会因 IP 限制而拒绝 API 请求。

  5. 05 · 安全事件后置措施

    若您在 2025 年 1 月安全事件期间持有密钥，请重新生成

    Phemex 披露于 UTC 时间 2025 年 1 月 23 日 11:30 发生了一起热钱包安全事件。充值和提现曾被临时暂停，冷钱包资金未受影响。该交易所聘请了第三方安全公司和执法部门，并在接下来的几周内逐步恢复了服务。如果您在此期间持有 Phemex API 密钥且之后未进行轮换，请将该密钥视为存在风险并重新生成。签名机制本身并未改变，此项操作规范旨在轮换所有在安全事件后置措施调整之前创建的密钥。

    来源Phemex: hot wallet security incident update and timeline

  6. 06 · 子账户范围限制

    子账户拥有独立密钥，请通过子账户路由各策略的专属密钥

    Phemex sub-accounts 是首要的隔离边界：每个 sub-account 都持有独立的余额、仓位和 API 密钥。将每个策略的密钥范围限制在特定的 sub-account 内，可以在密钥泄露时控制波及范围，并允许您将每个策略的资金上限限制在 sub-account 余额内，而非整个账户。建议默认采用“每个生产策略使用一个 sub-account”的模式，并在主账户上保留一个独立的运营密钥用于 sub-account 之间的资金划转，该密钥不应被策略代码获取。

Section 06 · 适用场景

适用场景

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

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

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

Section 08 · 常见问题

常见问题

不是。TradingHost 是独立的，与 Phemex 没有任何隶属关系。

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

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

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

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

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

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

可以。CCXT 通过统一的 `phemex` 类公开了 Phemex 的现货和永续合约市场。将您的 CCXT 策略放入容器中，将其指向 GitHub，TradingHost 就会像运行其他 Python 或 Node 项目一样运行它。请参阅 CCXT 框架运行环境（runtime）了解完整的设置流程。

可以，只要您的项目是这样设计的。您可以在一个运行环境（runtime）内运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中以实现隔离和运行清晰度。Phemex sub-account 与多策略模型是天然的绝配：为每个 sub-account 和每个策略限制一个专属密钥。请参阅 TradingHost 运行环境页面了解多策略模型。

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

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

不需要。策略绝不应该需要提现权限。请使用受限权限（只读、交易），并完全关闭策略密钥的提现功能。Phemex sub-account 允许您控制每个策略的波及范围，因此主账户永远不会持有具备提现功能的策略密钥。

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

都可以。MCP 控制界面在基于 CLI 的代理（Claude Code CLI、自定义 MCP 客户端、脚本化 MCP 调用）和 IDE 内部同样表现出色。GitHub 原生部署循环在没有任何 AI 工具的情况下也能正常工作：向您的主分支进行常规的 git push 即可触发重新部署。

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

Phemex 的频率限制器分为三个独立的组（contract、spotOrder、others），超出其中一个组的限制并不会限制其他组。如果您的 contract 循环被限制而 spot 仍在正常工作，那么限制因素是 contract 组的额度，而不是全局账户。请降低 contract 频率，或将 contract 和 spot 工作拆分到各自拥有独立密钥的 sub-account 中。请参阅上方的“操作说明”部分了解完整指南。

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

不支持。TradingHost 专注于实盘运行与部署。回测应当在您的研究工具链、框架或 AlgoBuilder 中完成。