阅读时间 … 分钟

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

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

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
Coinbase
平台类型
加密货币交易所
资产类别
加密货币,以及 Coinbase International Exchange 上的股票和商品永续合约
支持的产品
现货(Coinbase Advanced)、通过 Coinbase Financial Markets(受 CFTC 监管,自 2025 年 7 月 21 日起上线)提供的美国永续型期货和微型 BTC/ETH 期货、Coinbase International Exchange 上的 USDC 结算永续合约(加密货币、股票和黄金/白银永续合约)、通过 Deribit(于 2025 年 8 月 14 日收购)提供的加密货币期权
运行环境模式
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 Coinbase Advanced REST 和 WebSocket、CCXT、Hummingbot coinbase_advanced_trade 连接器(仅限现货)、Coinbase INTX REST、FIX 和 WebSocket、面向机构的 Coinbase Prime REST、FIX 和 WebSocket,以及自定义 SDK
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
Coinbase 角色
交易所账户、API 访问、市场接入、执行场所
关联关系
TradingHost 保持独立,与 Coinbase 及其自 2025 年 8 月起生效的子公司 Deribit 无任何隶属关系

第 02 部分 · Coinbase 平台功能

Coinbase 平台功能

Coinbase 涵盖四个交易板块和三种身份验证方案:面向零售现货和 CFM 上市的美国永续型期货的 Coinbase Advanced;面向机构现货的 Coinbase Exchange;面向 USDC 结算永续合约(包括加密货币、股票和黄金/白银永续合约)的 Coinbase International Exchange (INTX);以及面向机构经纪业务的 Coinbase Prime。加密货币期权则在 Deribit 上运行(Coinbase 于 2025 年 8 月 14 日以约 29 亿美元收购,目前继续使用现有的 Deribit API)。具体端点细节可能会随时间变化。整体架构是稳定的,而具体的速率限制权重、手续费等级和交易对列表请参考 Coinbase 的官方文档。

市场与策略模式

  • Coinbase International 上的 USDC 结算永续合约做市
  • 受 CFTC 监管的美国微型 BTC 和 ETH 永续型期货执行
  • Coinbase International 上的跨抵押品基差套利(支持将 USDC、BTC、ETH 作为保证金,覆盖 40 多种资产)
  • 股票永续期货策略(Coinbase International 上的美国单只股票永续合约)
  • 针对 USD 和 USDC 交易对的现货 Advanced Trade TWAP 执行
  • 通过 Deribit 结合 Coinbase 现货进行期权与现货 Delta 对冲
  • 针对美国永续型期货和 Coinbase International 永续合约的 USDC 资金费率套利策略
  • Coinbase International 上的黄金和白银永续期货(自 2026 年 4 月 22 日起上线)

API 接口

产品范围
Coinbase Advanced(零售现货以及通过 CFM 提供的美国永续型期货)、Coinbase Exchange(机构现货,前身为 Coinbase Pro)、Coinbase International Exchange / INTX(USDC 结算永续合约)、Coinbase Prime(机构经纪业务),以及仅模拟账户(Accounts)和订单(Orders)的沙盒环境 api-sandbox.coinbase.com。Deribit 在收购后仍保留其独立的 API。
连接方式
Advanced、Exchange 和 INTX 支持 REST 和 WebSocket。INTX 和 Prime 支持 FIX。部分板块的行情数据仅支持 WebSocket。
身份验证
CDP API 密钥以 JWT 形式进行签名。自 2025 年 2 月起,新密钥默认使用 Ed25519 (EdDSA),旧版 SDK 则使用 ECDSA P-256 (ES256)。INTX REST 使用 access-signature 请求头而非 JWT。旧版 Coinbase Pro HMAC 密钥已于 2024 年 6 月 6 日停用,且无法重新签发。

第 03 部分 · 用 AI 构建

用 AI 构建您的 Coinbase 策略

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

  • 原生 Coinbase API

    直接控制 Advanced、Exchange、INTX 和 Prime 的 Coinbase 特定行为、账户数据和订单执行逻辑。

  • CCXT

    跨 Coinbase 和其他加密货币交易所的通用接口。CCXT 通过统一的 `coinbase` 和 `coinbaseexchange` 类公开 Coinbase 现货;目前 CCXT 尚未将 INTX 永续合约作为一等公民(first-class)支持。

  • Hummingbot

    使用 `coinbase_advanced_trade` 连接器进行基于框架的部署。仅限现货;Hummingbot 目前不支持 Coinbase 衍生品。

  • 自定义连接器

    您自己的内部交易引擎或专有的 Coinbase 集成,包括直接对接 Coinbase INTX REST 和 FIX,或用于机构流程的 Coinbase Prime FIX。

框架对 Coinbase 产品的支持情况

各框架的支持范围有所不同。Coinbase 衍生品分布在 CFM(在 Coinbase Advanced 上市的美国永续型期货)和 Coinbase International(USDC 结算的永续合约,包括股票和黄金/白银永续合约)中,而加密货币期权则在 Deribit 上运行(Coinbase 于 2025 年 8 月收购,但保留了其独立的 API)。Hummingbot 的 `coinbase_advanced_trade` 连接器仅支持现货;CCXT 涵盖了 Coinbase Advanced 和机构级 Coinbase Exchange 的现货,但未将 INTX 永续合约作为一等互换(swap)市场呈现;原生 Coinbase API 则可访问 Coinbase 直接运营的每一个交易板块。

框架现货永续期权杠杆
Native Coinbase API已支持已支持未记录支持已支持
CCXT已支持部分支持未记录支持部分支持
Freqtrade部分支持未记录支持未记录支持未记录支持
Hummingbot已支持未记录支持未记录支持未记录支持

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

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

使用 AI 编写

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

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

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

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

    将 TradingHost 指向您现有的策略仓库,或者分叉(fork)一个 TradingHost 框架运行环境(CCXT 或 Hummingbot)作为可运行的基础模板。

  3. 步骤 03

    部署至 TradingHost 容器

    选择一个区域(EU 或 US-East),提供您策略所需的环境变量(Coinbase CDP API 密钥、INTX 访问签名凭据等),然后进行部署。TradingHost 会根据您的代码仓库构建容器,并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

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

Section 05 · 运维说明

Coinbase 运维说明

在容器化云端运行环境中实际运行 Coinbase 策略时可能遇到的陷阱,这些内容在 Coinbase 的文档或框架的 README 中是找不到的。以下每条说明均引用或转述自 Coinbase 的官方文档;部署侧的指南则源自我们在 TradingHost 上运行这些策略的实际经验。

  1. 01 · 旧版停用

    Coinbase Pro API 密钥于 2024 年 6 月停用;旧版 v2 密钥于 2025 年 2 月过期

    独立的 Coinbase Pro REST 和 WebSocket API 已于 2024 年 6 月 6 日弃用,且当时已禁用新 Pro 密钥的创建。Coinbase 自 2025 年 2 月 5 日起开始使所有剩余的旧版零售 API 密钥失效。任何仍绑定 Pro 风格 HMAC 密钥的策略都将返回 401 错误,必须通过 Coinbase Developer Platform 重新签发。

  2. 02 · 签名算法

    Ed25519 为默认算法;ECDSA P-256 为旧版

    自 2025 年 2 月起,新创建的 CDP API 密钥默认使用 Ed25519 (EdDSA)。采用 P-256 签名并作为 JWT ES256 的 ECDSA 仍被接受,且在旧版 SDK(如 `coinbase-advanced-py`)支持 Ed25519 之前仍需使用。除非 SDK 明确强制要求 ECDSA,否则策略应统一使用 Ed25519。

  3. 03 · JWT 有效期

    凭证 Token 有效期仅两分钟;需随每次请求重新生成

    Coinbase Advanced 的 JWT 在签发 120 秒后失效。策略必须在每次调用时重新生成 JWT,或至少设置小于 2 分钟的循环定时器,否则会遇到类似于签名失败的 401 Unauthorized 错误。订阅 user 和 futures_balance_summary 频道的 WebSocket 连接,不仅需要在连接时提供 JWT,还必须在订阅消息本身中包含 JWT。

  4. 04 · 速率限制

    认证接口 30 rps,公开接口 10 rps,支持令牌桶突发流量

    Advanced Trade 的私有 REST 端点限制为每用户每秒 30 次请求 (30 rps)。公开端点限制为每 IP 每秒 10 次请求 (10 rps)。限流器采用延迟填充的令牌桶算法,因此在令牌桶耗尽前允许短时间超过 30 rps 的突发流量,耗尽后 API 将返回 429 错误。请针对最坏情况下的批量撤单风暴做好相应规划。

  5. 05 · 沙盒环境

    Advanced Trade 沙盒仅支持 Accounts 和 Orders 端点

    沙盒主机 `https://api-sandbox.coinbase.com/api/v3/brokerage/` 仅模拟了 Accounts 和 Orders 端点。行情数据、产品、手续费和投资组合端点并不在沙盒中,因此端到端策略测试必须将沙盒化的订单流与生产环境的只读行情数据结合使用,或者对接本地模拟服务。

  6. 06 · 交易场所划分

    Advanced、Exchange、INTX 与 Prime:四个交易场所,三种认证方案

    拥有 Coinbase Advanced 账户并不意味着自动获得 INTX 的访问权限。INTX 要求在 Coinbase Bermuda 进行开户入驻,且仅限符合条件的非美国机构使用;INTX REST 使用 access-signature 请求头,而非 JWT。Coinbase Prime 是一个独立的机构经纪商产品,拥有自己专属的 REST、FIX 和 WebSocket API。策略代码应将交易场所选择作为一级配置进行硬编码,而不是根据密钥类型进行切换。

  7. 07 · 期权交易

    加密货币期权目前仍保留在 Deribit 的 API 上

    Coinbase 于 2025 年 8 月 14 日完成了对 Deribit 的收购,交易金额约为 29 亿美元。Deribit 的期权交易继续在现有的 Deribit API 和品牌下运行;截至 2026 年 5 月,尚未推出合并后的 Coinbase 期权端点。希望进行期权交易的策略需直接对接 Deribit API。

Section 06 · 适用场景

适用场景

TradingHost Coinbase 运行环境最适合用于:

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

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

Section 08 · 常见问题

常见问题

不是。TradingHost 是独立的,与 Coinbase 或其自 2025 年 8 月起收购的子公司 Deribit 均无任何隶属关系。

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

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

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

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

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

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

可以。CCXT 提供了统一的 `coinbase` 和 `coinbaseexchange` 类,涵盖了 Coinbase Advanced 上的现货交易以及机构级的 Coinbase Exchange。目前,Coinbase International Exchange 的永续合约尚未作为 CCXT 的一级 swap 市场开放,因此对于 INTX 永续合约,请通过原生的 Coinbase INTX REST 或 FIX API 进行路由。将您的 CCXT 策略放入容器中,指向 GitHub,TradingHost 就会像运行其他任何 Python 或 Node 项目一样运行它。完整的设置说明请参阅 CCXT 框架运行环境。

TradingHost 在运行环境层面上是与交易场所无关的:任何能够通过 Coinbase 接口身份验证的代码都可以在容器内运行。一旦您的账户符合条件,即可通过 Coinbase Advanced 交易 CFM 挂牌的美国永续风格期货(BTC 和 ETH,包括自 2025 年 7 月 21 日起上线的 nano 合约)。Coinbase International Exchange 永续合约则要求在 Coinbase Bermuda 进行 INTX 开户入驻,且仅限符合条件的非美国机构使用。准入资格由 Coinbase 决定,而非 TradingHost;我们只负责运行您的策略代码,并对接您账户有权访问的任何交易场所。

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

最快的方法是 Fork 一个 TradingHost 框架运行环境:选择 CCXT 或 Hummingbot 即可获得开箱即用的项目。或者,您也可以连接自己的 GitHub 策略仓库。绑定 GitHub 仓库并创建策略是免费的;运行环境方案已在定价页面列出。

保存在由您掌控的 GitHub Secrets 工作流中。TradingHost 在运行时通过 GitHub 仓库机密 (repository secrets)、环境机密 (environment secrets) 或您自己认可的机密管理流程来读取它们。TradingHost 不需要托管您的 CDP API 密钥、INTX access-signature 凭证或 Prime 凭证。完整的处理模型请参阅平台机密。

Coinbase 已于 2024 年 6 月 6 日弃用了独立的 Coinbase Pro REST 和 WebSocket API,并在此后停止发放新的 Pro 密钥。自 2025 年 2 月 5 日起,Coinbase 开始使剩余的旧版零售 API 密钥陆续失效。任何仍绑定 Pro 风格 HMAC 密钥的策略都会返回 401 错误,且无法恢复。解决方法是在 Coinbase Developer Platform (CDP) 中生成一个新密钥(除非您的 SDK 强制要求 ECDSA P-256,否则默认使用 Ed25519),并更新您的策略,将 Advanced Trade 请求作为 JWT 进行签名。完整的弃用背景请参阅上方的“运行注意事项”部分。

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

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

Coinbase 最常见的身份验证失败是 Advanced Trade REST 或 WebSocket API 上的 HTTP 401 错误。常见原因包括 JWT 过期(Coinbase JWT 的有效期仅为 2 分钟)、在默认使用 Ed25519 的库中使用了 ECDSA 密钥(反之亦然)、API 密钥仍处于激活延迟期,或者使用了已于 2024 年 6 月停用的旧版 Coinbase Pro 密钥。请生成新的 CDP 密钥,除非 SDK 强制要求 ECDSA,否则请选择 Ed25519,并在每次请求时重新生成 JWT。完整指南请参阅上方的“操作说明”部分。

Advanced Trade 沙盒的主机地址为 `https://api-sandbox.coinbase.com/api/v3/brokerage/`。它仅模拟 Accounts 和 Orders 端点。市场数据、产品、费用和投资组合端点不在沙盒中,因此端到端策略测试必须将沙盒化的订单流与生产环境的只读市场数据相结合,或者针对本地模拟运行。INTX 和 Prime 拥有各自的机构准入流程,而不提供公开沙盒。请将沙盒和生产环境的凭据保存在独立的 TradingHost Secrets 条目中,切勿跨环境复用。

加密货币期权交易位于 Deribit。Coinbase 于 2025 年 8 月 14 日完成了对 Deribit 的收购,交易金额约为 29 亿美元,但 Deribit 期权交易继续在现有的 Deribit API 和品牌下运行;截至 2026 年 5 月,尚未合并 Coinbase 期权端点。希望获得期权敞口的策略可以直接集成 Deribit API,同时运行 Coinbase 现货或永续合约流,并像其他多交易场所策略一样在 TradingHost 容器内运行。

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

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