阅读时间 … 分钟

Gemini 交易策略的 AI 原生运行时

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

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
Gemini
平台类型
加密货币交易所及 NYDFS 授权的信托公司
资产类别
加密货币（现货），特定非美国司法管辖区的加密货币永续合约
支持的产品
现货（网页端和移动端）、ActiveTrader（高级订单簿界面）、Gemini Perpetuals（非美国地区，通过 Gemini Artemis Pte. Ltd. 提供，最高 100 倍杠杆；交易对如 ETHGUSDPERP）、Gemini Custody（合格托管人，独立但可组合）、沙盒环境
运行环境模式
容器化策略运行时
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 Gemini REST、WebSocket 和 FIX 4.4，CCXT (gemini)，自定义 HMAC-SHA384 客户端。Freqtrade 和 Hummingbot 官方不支持 Gemini。
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行时、部署、日志、健康检查、区域选择、密钥管理、MCP 控制
Gemini 角色
交易所账户、API 接入、市场准入、执行场所、机构用户的合格托管服务
关联关系
TradingHost 保持独立，与 Gemini 无关联。Gemini Trust Company LLC 是由 NYDFS 授权的纽约有限目的信托公司（2015 年 10 月）。Gemini 的母公司于 2025 年 9 月在 Nasdaq 上市，股票代码为 GEMI。

第 02 部分 · Gemini 平台功能

Gemini 平台功能

Gemini 是一家经 NYDFS 授权的信托公司，通过其网页和移动端应用提供现货交易，通过 ActiveTrader 提供高级订单簿界面，并为符合条件的非美国账户提供 Gemini Perpetuals（由 Gemini Artemis Pte. Ltd. 运营）。连接方式包括 REST、WebSocket 和 FIX 4.4，并采用 HMAC-SHA384 签名。Hummingbot 和 Freqtrade 对 Gemini 的支持有限或不支持，因此大多数策略代码均基于原生 API 或 CCXT。具体的交易对、速率限制和交易场所准入资格请参阅 Gemini 的官方文档。

市场与策略模式

  • ActiveTrader 统一订单簿执行
  • GUSD / USDC / RLUSD 组合订单簿套利
  • 在生产环境上线前进行沙盒验证部署
  • 机构子账户间的 master- 密钥分发
  • 并行策略实例的单会话 nonce 隔离
  • 策略停止时触发 Cancel All Session Orders 紧急停止开关
  • 结合托管服务的资金库再平衡
  • 机构交易台的 FIX 4.4 同步定位执行

API 接口

产品范围
现货交易所、ActiveTrader、Gemini 衍生品/永续合约（在符合条件的地区）、Sandbox（独立测试环境）。
连接方式
REST (HTTPS)、WebSocket（公开 + 私有）、FIX 4.4 订单输入、FIX 4.4 行情数据、FIX Drop Copy。FIX 需要从经批准的数据中心或外联网络直连至 Gemini 的美国东海岸托管区，无法通过公共互联网访问。
身份验证
对 base64 编码的 JSON 负载进行 HMAC-SHA384 签名。签名位于 X-GEMINI-SIGNATURE，API 密钥位于 X-GEMINI-APIKEY，负载位于 X-GEMINI-PAYLOAD。密钥前缀：master-（集团范围，需要 account 参数）和 account-（单账户）。每个配置的密钥都是一个拥有独立 nonce 流的“会话”。

具体细节请参考 Gemini

具体端点、速率限制权重、交易对列表、费率层级和版本历史记录均记录在 Gemini 的文档中。请以其作为权威参考。

第 03 部分 · 用 AI 构建

用 AI 构建您的 Gemini 策略

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

  • 原生 Gemini API

    直接控制 Gemini 特有的行为（REST、WebSocket、FIX 4.4）、账户数据和订单执行逻辑。

  • CCXT

    通过 gemini 连接器，在 Gemini 和其他加密货币交易所之间使用通用接口。

    开始使用 CCXT

  • Freqtrade 或 Hummingbot

    Hummingbot 没有 Gemini 连接器。Freqtrade 仅通过 CCXT 提供社区支持，且官方不支持。大多数生产环境代码使用原生 API 或 CCXT。

  • 自定义连接器

    您自己的内部交易引擎或专有的 Gemini 集成，通常围绕 HMAC-SHA384 签名和 FIX 4.4 接口构建。

框架对 Gemini 产品的支持情况

Gemini 是一家经 NYDFS 授权的信托公司，通过网页和 ActiveTrader 提供现货交易，并在特定司法管辖区设有由 Gemini Artemis 运营的独立永续合约交易场所。由于 Hummingbot 没有 Gemini 连接器，且 Freqtrade 仅通过 CCXT 提供社区支持，因此大多数生产环境的策略代码都是基于原生 REST / WebSocket / FIX 4.4 或 CCXT。

框架现货永续
Native Gemini API已支持已支持
CCXT已支持部分支持
Freqtrade部分支持未记录支持
Hummingbot未记录支持未记录支持

✓ 官方框架文档确认支持。“partial” 表示支持不完整或依赖于版本。“no” 表示官方文档未说明支持。

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

使用 AI 编写

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

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

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

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

    将 TradingHost 指向您现有的策略仓库，或者派生（fork）一个 TradingHost 框架运行时（CCXT 或原生 Gemini 模板）作为可运行的基础模板。

  3. 步骤 03

    部署至 TradingHost 容器

    选择一个区域（EU 或 US-East），提供策略所需的环境变量（Gemini API 密钥、master- 或 account- 前缀、HMAC-SHA384 密钥），然后进行部署。TradingHost 会根据代码仓库构建您的容器，并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

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

部署

Section 05 · 运维说明

Gemini 运维说明

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

  1. 01 · 身份验证

    Gemini 使用 HMAC-SHA384 签名，而非 SHA256

    每个私有请求都需要 X-GEMINI-APIKEY、X-GEMINI-PAYLOAD 中 base64 编码的 JSON 负载，以及在 X-GEMINI-SIGNATURE 中该负载的十六进制 HMAC-SHA384 签名（使用 API 密钥作为 key）。从 Coinbase 或 Kraken 示例中复制粘贴的库几乎总是默认使用 SHA256，并静默失败，返回 InvalidSignature。已签名的负载必须包含请求路径和 nonce，在使用 master- 密钥时还必须包含 account 参数。

    来源Gemini API key authenticationGemini error codes

  2. 02 · 密钥模型

    master- 密钥作用于整个群组，account- 密钥仅作用于单一账户

    Gemini 将多个账户归入同一个机构架构下。带有 master- 前缀的密钥可以通过在请求载荷的 account 字段中传入账户别名，来操作群组中的任何账户；而带有 account- 前缀的密钥则会拒绝该参数。选错密钥类型是导致 MissingRole / 403 错误最常见的原因。请将特定于部署的密钥保持在账户级别；将 master 密钥留给资金管理自动化。

    来源Gemini API key authentication

  3. 03 · Nonce

    每个 API 密钥拥有独立的 Nonce 流，且需在 Unix 时间 ±30 秒内

    根据 Gemini 的文档，Nonce 在每个会话（即每个 API 密钥）内是单调递增的，因此两个密钥可以在不同的容器上运行，而无需进行时钟同步。Nonce 必须严格大于该密钥上一次的值，且必须在当前 Unix 时间戳的 ±30 秒范围内；违反其中任何一条规则都会返回 InvalidNonce。在两个容器中运行同一个密钥是常见的故障模式。请为每个策略运行环境配置独立的密钥，并将密钥作为水平扩展的最小单元。

    来源Gemini API key authentication

  4. 04 · 沙盒环境

    在接入生产环境前，先在 api.sandbox.gemini.com 进行验证

    沙盒环境的网页端位于 https://exchange.sandbox.gemini.com，API 位于 https://api.sandbox.gemini.com 和 wss://api.sandbox.gemini.com。账户中预置了测试用的 USD、BTC、ETH、BCH、LTC、OXT、LINK、BAT 和 DAI；价格与生产环境存在偏差。生产环境密钥无法在沙盒环境中使用，反之亦然。对于自动化流程，可以使用验证码 9999999 绕过双重身份验证。

    来源Gemini sandbox environment

  5. 05 · 频率限制

    公共接口 120 次/分，私有接口 600 次/分，支持 5 个请求的突发排队

    根据 Gemini 的文档，公共端点限制为每分钟 120 次请求，私有端点限制为每分钟 600 次，稳态下分别相当于每秒 1 次和 5 次请求。交易所最多可将 5 个超额请求排队，超出后将返回 HTTP 429 及 RateLimit 原因。在开盘或市场波动期间，订单管理的突发请求是导致自行触发 429 限制的典型原因；请采用批量和错峰撤单的方式。

    来源Gemini rate limits

  6. 06 · 风险控制

    Cancel All Session Orders 是您的紧急停止开关

    每个订单都会记录在创建它的 API 密钥下。Cancel All Session Orders 端点仅针对该密钥的活动订单，因此可以终止失控的策略，而不会影响在同一账户中运行在其他密钥上的兄弟策略。将此逻辑接入您容器的 SIGTERM 信号处理程序中，以防部署停止后留下残留的活动订单。在需要紧急停止整个账户的订单时，可配合使用 Cancel All Active Orders。

    来源Gemini REST API reference

  7. 07 · 安全加固

    在启用提币权限前，先将密钥锁定至您的 TradingHost 出口 IP

    Gemini 支持在 API 密钥上设置 Trusted IP 白名单；白名单之外的请求将因 RemoteAddressForbidden 而失败。密钥还针对交易、资金管理和提币设有独立的权限范围；在策略密钥上授予提币权限是不安全的默认做法。应将提币视为独立的运营密钥，并将其 IP 绑定到控制主机，让策略运行环境仅使用交易权限的密钥。

    来源Securing API keys with Trusted IPsGemini error codes

Section 06 · 适用场景

适用场景

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

  • 在 AI IDE（Cursor、Claude Code）中构建策略的开发者
  • 系统化加密货币交易员
  • 受美国监管的机构交易台
  • CCXT 用户
  • 正在从 VPS 托管迁移到容器化部署的团队

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

Section 08 · 常见问题

常见问题

没有。TradingHost 是独立的，与 Gemini 没有任何隶属关系。Gemini Trust Company, LLC 是 2015 年 10 月由 NYDFS 特许成立的纽约有限目的信托公司；其母公司于 2025 年 9 月在 Nasdaq 上市，股票代码为 GEMI。该受监管的信托身份与 TradingHost 无关。

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

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

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

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

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

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

可以。CCXT 附带了支持现货的 gemini 连接器，并在其源码中包含了永续合约的处理。在依赖衍生品功能之前，请对照您当前的 CCXT 版本验证交易对和保证金端点的支持情况；对于衍生品交易，原生的 Gemini REST 和 WebSocket API 仍然是风险最低的途径。具体设置方法请参见 CCXT 框架运行环境页面。

可以，只要您的项目是这样设计的。您可以在一个运行环境中运行多个策略进程或服务，也可以将它们拆分到不同的运行环境中，以实现隔离和运行清晰度。Gemini 的单会话 Nonce 模型非常适合为每个策略配置一个 API 密钥。有关多策略模型的详细信息，请参阅 TradingHost 运行环境页面。

最快的方法是 Fork 一个 TradingHost 框架运行环境（例如 CCXT），或者连接您自己围绕原生 Gemini REST、WebSocket 或 FIX 4.4 接口构建的 GitHub 策略仓库。关联 GitHub 仓库并创建策略是免费的；运行环境方案已在定价页面列出。

保存在您通过 GitHub 控制的机密（Secrets）工作流中。TradingHost 在运行时通过 GitHub 仓库机密、环境机密或您自己批准的机密管理流程来读取它们。TradingHost 不需要托管您的 API 密钥和私钥。有关完整的处理模型，请参阅平台机密页面。

不需要。策略绝不应该需要提币权限。Gemini 支持针对交易、资金管理和提币的细粒度权限，以及 Trusted IP 白名单。请将策略密钥限制在仅限交易的范围内，并将其绑定到您所选区域的 TradingHost 出口 IP；将提币权限留给固定 IP 控制主机上的独立运营密钥。

当 API 密钥缺少该端点所需的权限范围时，Gemini 会返回 MissingRole (HTTP 403)；当请求来自未列入该密钥 Trusted IP 白名单的 IP 时，会返回 RemoteAddressForbidden。另外两个需要接入告警系统的身份验证类错误是 InvalidSignature and InvalidNonce。

两个使用相同 API 密钥的容器会竞争彼此的 Nonce 序列。Gemini 在每个密钥（会话）维度限制 Nonce 流，其值必须单调递增且在 Unix 时间的 ±30 秒内。请为每个运行环境实例配置独立的 API 密钥；仅在单写者语义下使用基于时间的 Nonce。

可以。TradingHost 支持基于 MCP 的控制，适用于包括 Cursor、Claude Code、GitHub Copilot 在内的 AI IDE 以及基于 CLI 的 AI agent。AI 工具可以检查部署、查看日志、重启策略并管理运行时的自动化工作流。MCP 是一个控制和可观测性界面，而非交易执行路径。详情请参阅 MCP 控制界面。

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

运行时会检测到崩溃并公开相关的日志和健康信息。在支持的情况下，受影响的策略可以重新启动，而不会干扰在同一容器中运行的其他策略。请将 Cancel All Session Orders 接入您的 SIGTERM 处理程序，以确保部署不会留下未成交的挂单；您的策略代码仍需负责安全错误处理、重复订单保护和风险控制。有关日志和健康状况界面，请参阅可观测性。

TradingHost 在 EU 和 US-East 区域运行。Gemini 的 FIX 4.4 连接需要从经批准的数据中心或外联网络直连至其美国东海岸托管区，因此对于对延迟敏感的 Gemini 策略，US-East 是首选。请参阅区域页面以了解路由和物理距离的详细信息。

是的。Gemini Trust Company, LLC 是一家于 2015 年 10 月获得 NYDFS 批准设立的纽约州有限目的信托公司，使其成为纽约州银行法下的受托人和合格托管人。Gemini Trust 的母公司于 2025 年 9 月在 Nasdaq 上市，股票代码为 GEMI。受监管的信托身份与 TradingHost 无关。

没有影响。Gemini Earn 是一项理财产品（并非现货交易所或 API），已通过 Genesis 破产程序结束。客户在 2024 年 5 月至 6 月的分配中获得了 100% 的实物赔付；SEC 于 2026 年 1 月 23 日主动撤销了对 Gemini Trust 的诉讼，且不得重新起诉。这不会影响交易所访问、API 行为或托管运营。

在符合条件的情况下，可以。Gemini 永续合约由 Gemini Artemis Pte. Ltd. 在特定的非美国司法管辖区运营，提供高达 100 倍的杠杆，合约以 GUSD（例如 ETHGUSDPERP）或 USDC 计价。美国零售用户的访问权限正在通过 CFTC 批准的 Gemini Titan 指定合约市场进行构建。部署前请核实您的账户司法管辖区和交易对的上市板块。

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