阅读时间 … 分钟

适用于 Uphold 交易策略的 AI 原生运行时

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

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
Uphold
平台类型
加密货币 interchange / swap 交易场所（多资产；非基于订单簿）
资产类别
加密货币、法币、precious metals 以及 tokenised equity（40 多种资产类别）
支持的产品
通过 Uphold liquidity pools 进行直接的资产对资产 swap（任意资产间互换）、支持资产的质押（staking）、代币化出入金流程，无原生永续合约或期权。
运行环境模式
容器化策略运行时
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 Uphold REST API（Core、KYC Connector、Market Pulse、Widgets、Topper）、Personal Access Token (PAT) 身份验证、自定义连接器。CCXT 目前未将 Uphold 列为统一交易所。
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 及 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行时、部署、日志、健康检查、区域选择、MCP 控制
Uphold 角色
交易所账户、API 访问、市场准入、流动性提供商、执行场所
关联关系
TradingHost 为独立平台，与 Uphold 无任何隶属关系

第 02 部分 · Uphold 平台功能

Uphold 平台功能

Uphold 是一个 interchange / swap 交易场所，而非订单簿交易所。资产通过 Uphold liquidity pools 进行 swap，其实时定价基于资金池深度。策略不会针对订单簿下单，而是请求 swap 报价并针对资金池执行。其资产范围涵盖 40 多个类别：加密货币、法币、precious metals 和 tokenised equity。其 API 由模块化端点（Core、KYC Connector、Market Pulse、Widgets、Topper）组成，供企业混合搭配。具体端点细节可能会随时间变化，但整体架构是稳定的；精确的费率、支持的资产和集成模式请参考 Uphold 的开发者文档。

市场与策略模式

  • 通过 Uphold liquidity pools 进行任意资产间的 swap
  • 基于实时资金池定价的加密货币对法币 swap 策略
  • 加密货币对 precious metals 的 swap（gold、silver、palladium、platinum）
  • 通过 Uphold interchange 获取 tokenised equity 风险敞口
  • 针对资金池深度的滑点感知型订单规模控制
  • 针对支持资产的质押收益（staking-yield）策略
  • 模块化 API 组合（Core、KYC Connector、Market Pulse、Widgets、Topper）
  • 使用 Personal Access Token (PAT) 进行身份验证的单账户流程

API 接口

产品范围
通过 Uphold liquidity pools 在加密货币、法币、precious metals 和 tokenised equity（40 多个资产类别）之间进行直接的资产对资产 swap。无原生永续合约或期权。支持对特定资产进行质押（staking）。其 interchange 模式意味着单次“交易”是以资金池衍生汇率在两种资产之间进行 swap，而不是在订单簿上挂单。
连接方式
由模块化端点组成的 REST API：Core（用户、资产、账户、交易）、KYC Connector（身份验证流程）、Market Pulse（实时定价）、Widgets（可嵌入式 UI）、Topper（整合式出入金）。这种模块化组合即为 API 的全部接口，并不存在单一的庞大端点。
身份验证
基于 OAuth 的身份验证，并提供 Personal Access Token (PAT) 选项。PAT 允许通过单次 API 调用获取单个 Uphold 账户的凭据访问权限。由于没有期货产品，因此无需区分现货交易与期货交易的权限范围。

具体细节请参考 Uphold

具体端点、支持的资产、定价机制和集成模式请参见 Uphold 的开发者文档。请以此作为权威参考。

第 03 部分 · 用 AI 构建

用 AI 构建您的 Uphold 策略

选择一种集成方法，在 AI IDE 中针对 Uphold 模块化 API 编写您的策略，并将其作为容器部署。Cursor、Claude Code、GitHub Copilot 和基于 CLI 的 AI 智能体都适用于相同的 GitHub 原生部署循环。

  • 原生 Uphold API

    直接控制 Uphold 特有的行为：swap 报价、Personal Access Token 身份验证，以及 Core / Market Pulse / Topper 的模块化组合。

  • CCXT

    由于 Uphold 基于 swap 而非订单簿，因此 CCXT 目前未将 Uphold 列为统一交易所。需要框架抽象的策略应直接通过原生 API 进行路由。

  • Freqtrade 或 Hummingbot

    这两个框架都不针对 swap / interchange 模式。两者中均不存在 Uphold 连接器；官方文档推荐的路径是进行自定义或原生 API 集成。

  • 自定义连接器

    您自己的内部交易引擎或专有的 Uphold 集成，组合了 Core、KYC Connector、Market Pulse、Widgets 和 Topper API。

框架对 Uphold 产品的支持情况

Uphold 基于 swap，而非订单簿。加密策略框架生态（CCXT、Freqtrade、Hummingbot）围绕订单簿构建，因此它们都不提供原生 Uphold 连接器。通过模块化技术栈（Core、KYC Connector、Market Pulse、Widgets、Topper）进行原生 API 集成是官方文档推荐的路径。下方列标题使用的是 Uphold 的实际产品词汇，而非在此处不适用的现货/永续合约术语。

框架掉期质押托管代币化
Native Uphold API已支持已支持已支持已支持
CCXT未记录支持未记录支持未记录支持未记录支持
Freqtrade未记录支持未记录支持未记录支持未记录支持
Hummingbot未记录支持未记录支持未记录支持未记录支持

✓ 表示官方框架文档确认支持。“no” 表示官方文档未说明支持。工作流链接指向目前正在编写的 /workflows/ 页面。

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

使用 AI 编写

原生 API 路径与 AI IDE 自然契合。TradingHost MCP 控制面板实现了闭环：AI 工具可以与您协同检查部署、查看日志并管理运行时，而绝不会触及交易执行路径。

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

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

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

    将 TradingHost 指向您现有的策略仓库。由于 Uphold 基于 swap 而非订单簿，因此它在 CCXT、Freqtrade 或 Hummingbot 中没有原生连接器；典型的模式是针对原生 Uphold 模块化 API 进行自定义集成。

  3. 步骤 03

    部署至 TradingHost 容器

    选择一个区域（EU 或 US-East），提供策略所需的环境变量（Uphold Personal Access Token 或 OAuth 凭证），然后进行部署。TradingHost 会从您的代码仓库构建容器，并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

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

部署

Section 05 · 运维说明

Uphold 运维说明

在容器化云端运行时中实际运行 Uphold 策略时会遇到的坑，这些在 Uphold 的文档或框架的 README 中是找不到的。以下每条说明均转述自 Uphold 官方文档；部署侧的指南则源于在 TradingHost 上运行这些策略的实际经验。

  1. 01 · 固定价格模型

    Uphold 以单一固定价格进行交易，而非针对订单簿交易

    Uphold 宣传其服务为“无论订单大小，均享单一固定价格”且“无隐藏加价”。在实际操作中，这意味着每次交易都是您接受或拒绝的报价，而不是在订单簿上挂出的限价/市价单。针对订单簿抽象编写的策略代码（限价/止损/iceberg 订单、深度订阅、taker/maker 分类）如果不经过重大重构，是无法移植到 Uphold 的。其执行路径是“请求报价”然后“接受报价”，中间没有任何订单簿侧的原语。

    来源Uphold homepage (fixed-price model)Uphold developer REST API introduction

  2. 02 · 无订单簿原语

    无原生限价单、止损单或滑点上限订单类型

    由于 Uphold 不运行订单簿，因此订单簿交易场所提供的订单原语（如 post-only、滑点百分比上限、time-in-force、iceberg）在此处并不存在。依赖滑点上限或条件订单的策略必须在客户端实现：请求报价，与价格源参考进行对比，然后根据策略自身的容忍度决定接受或拒绝。大额交易不一定会产生线性的价格影响；在确定交易规模前应先通过报价进行验证，而不是假设存在深度曲线。

    来源Uphold homepage (fixed-price model)

  3. 03 · 模块化 API 组合

    五个独立的模块化 API：Core、KYC Connector、Market Pulse、Widgets 和 Topper

    Uphold 的 REST API 套件“在原则上是模块化的”，由五个命名服务组成：Core（用户、资产、账户、交易）、KYC Connector（第三方合规数据集成）、Market Pulse（数字资产市场情报）、Widgets（可嵌入的 UI 组件）和 Topper（整合的入金/出金通道）。每个服务都发布了 OpenAPI 规范。仅进行资产交易的策略可能只需涉及 Core 和 Market Pulse；进行法币入金的策略可能会增加 Topper；处理新用户流程的策略可能会增加 KYC Connector。

    来源Uphold developer REST API introduction

  4. 04 · 身份验证

    支持 Personal Access Token (PAT) 凭证选项的 OAuth

    Uphold 使用基于 OAuth 的身份验证。对于单账户集成（您自己的 Uphold 账户，而非第三方流程），Personal Access Token (PAT) 选项允许通过单次 API 调用获取凭证访问权限，无需进行完整的 OAuth 授权协商。PAT 保存在您的 TradingHost secrets 中，并在运行时以与其他 API 凭据相同的方式加载到容器中。多租户集成（代表您的用户运行您的平台）则需要完整的 OAuth 流程及刷新令牌处理，这比单账户 PAT 模式更为繁重。

    来源Uphold developer REST API introduction

  5. 05 · 支持的资产范围

    涵盖加密货币、法币、precious metals 和 tokenised equity 的 300 多种资产

    Uphold 宣传“交易 300 多种资产”，涵盖加密货币（BTC、ETH、USDC 等）、法币（USD、EUR、GBP 等）、precious metals（gold、silver、palladium、platinum）以及 tokenised equity。任意资产间的兑换是其默认产品；其跨资产范围明显宽于纯加密货币订单簿交易场所。依赖这种广泛性的策略（如 gold 与加密货币对冲、precious metals 配对交易、法币与稳定币桥接流）是 Uphold 的天然使用场景。纯加密货币对加密货币的交易在订单簿交易场所拥有更深的流动性，因此，请为了跨资产优势而路由至 Uphold，而不是为了纯加密货币交易流。

    来源Uphold homepage (300+ assets)

  6. 06 · 框架

    CCXT、Freqtrade 和 Hummingbot 未针对 swap 模型进行设计

    加密策略框架生态系统是围绕订单簿交易场所构建的。CCXT、Freqtrade 和 Hummingbot 都假设针对具有 maker/taker 费率和深度订阅的订单簿进行下单。Uphold 的 swap 模型不符合这种抽象，且这三个框架均未将 Uphold 列为支持的交易场所。从这些框架之一移植的策略必须将下单层替换为针对 Market Pulse 和 Core API 的 swap 报价接受逻辑。

    来源Uphold developer REST API introduction

Section 06 · 适用场景

适用场景

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

  • 在 AI IDE（Cursor、Claude Code）中构建策略的开发者
  • 跨资产交易员（加密货币、法币、precious metals、tokenised equity）
  • 运行自定义 swap 模型策略的量化开发者
  • 组合使用 Core、Market Pulse 和 Topper API 的企业集成商
  • 从 VPS 托管转向容器化部署的团队

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

Section 08 · 常见问题

常见问题

不是。TradingHost 是独立的，不隶属于 Uphold。

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

不提供。Uphold API 访问权限由 Uphold 提供。您需要自行负责您的 Uphold 账户、API 权限、凭据以及对 Uphold 条款的遵守。

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

AWS 和 DigitalOcean 为您提供原始算力。您需要自己处理操作系统更新、容器编排、日志传输、凭据轮换、区域容灾和在线率监控。TradingHost 为您提供专为交易策略构建的托管运行时：GitHub 原生部署、来自 AI IDE 的 MCP 驱动控制，以及开箱即用的日志和健康状况界面。如果您想自己运营基础设施，AWS 可以满足需求。如果您希望将运行时作为托管服务，TradingHost 是更便捷的途径。

可以。TradingHost 支持运行 Python 策略；由于没有一流的 CCXT、Freqtrade 或 Hummingbot 连接器，Uphold 的典型模式是使用针对原生 Uphold REST API 的自定义 Python 客户端。

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

CCXT 未将 Uphold 列为统一交易所，因为 Uphold 是基于 swap 而非基于订单簿的，这超出了 CCXT 的主要抽象范围。想要框架抽象的策略可以直接通过原生 Uphold 模块化 API 进行路由。有关在交易场所未获得原生支持时框架集成形态如何变化的背景信息，请参阅 CCXT 框架运行时。

在订单簿交易场所，您针对订单簿深度提交限价单或市价单，并支付 maker 或 taker 费用。而在 Uphold，您向交易场所请求 swap 报价，该报价源自 pool 深度并包含交易场所价差，然后您选择接受或拒绝。这里没有单独的 maker 费用，没有 post-only 标志，也没有订单簿深度订阅。策略必须针对 pool 深度而非订单簿深度来规划滑点；在较浅的 pool 中进行较大规模的 swap 会导致价格不成比例地变差。针对订单簿抽象编写的策略代码如果不经过重构，将无法移植到 Uphold。有关完整背景，请参阅上方的“运营说明”部分。

可以，如果您的项目是这样设计的。您可以在一个运行时内运行多个策略进程或服务，也可以将它们拆分到不同的运行时中，以实现隔离和运行清晰度。有关多策略模型，请参阅 TradingHost 运行时页面。

Uphold 不像 Binance 那样拥有框架入门套件，因此最快的途径是连接您自己的 GitHub 策略仓库，该仓库通过 Personal Access Token 针对原生 Uphold 模块化 API（Core、Market Pulse、Topper）。关联 GitHub 仓库并创建策略是免费的；运行时方案已在定价页面列出。

保存在您由 GitHub 控制的 secrets 工作流中。TradingHost 在运行时通过 GitHub 仓库 secrets、环境 secrets 或您自己批准的 secrets 管理流程读取它们。TradingHost 不需要托管您的 Personal Access Token 或 OAuth 凭据。有关完整的处理模型，请参阅平台 secrets。

Personal Access Token 授予对您单个 Uphold 账户的凭证访问权限。策略的范围应仅限于 swap 和读取权限；如果 Uphold 在您的账户仪表板中为 PAT 提供了更细粒度的范围限制，请优先选择更严格的范围。请确保策略加载的任何 token 都关闭了提币权限。

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

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

Uphold swap 模型不像订单簿交易平台那样提供原生的滑点保护阈值。策略必须在客户端实现滑点控制：请求报价，与参考喂价进行对比，然后根据策略自身的容忍度决定接受或拒绝。在较浅的 pools 中，较大的 swap 规模会导致价格不成比例地变差，因此交易规模的缩放并不是线性的。请参阅上方的“操作说明”部分以获取完整指南。

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

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