适用于 Gate.io 交易策略的 AI 原生运行环境
在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署至托管云端运行环境,享有原生 MCP 控制、日志查看和区域选择支持。
第 01 部分 · 一览
一览
- 交易平台
- Gate.io(自 2024 年品牌重塑后亦使用 Gate.com 品牌,但 API 和 SDK 引用中仍沿用 Gate.io)
- 平台类型
- 加密货币交易所(现货、杠杆、USDT/BTC 保证金永续合约、交割合约、期权、跟单交易、借贷)
- 资产类别
- 加密货币
- 支持的产品
- 现货(4,600+ 种资产)、全仓和逐仓杠杆(约 470 种资产,最高 10 倍)、USDT 保证金永续合约、BTC 保证金永续合约、交割合约、BTC/ETH 及部分主流币种的期权(1h/4h/24h 短期期权及标准到期日)、跟单交易、借贷。衍生品最高杠杆可达 125 倍。
- 运行环境模式
- 容器化策略运行环境
- 部署源
- GitHub
- 编程语言
- 任何可在容器中运行的语言
- 常用集成
- 原生 Gate API v4(REST + WebSocket)、CCXT(交易所 ID 为 `gate`)、Freqtrade(现货 + 永续合约)、Hummingbot(`gate_io` 和 `gate_io_perpetual` 接入器)、自定义集成
- AI 工作流集成
- 适用于 Cursor、Claude Code、GitHub Copilot 及 CLI 智能体的 MCP 控制面板
- TradingHost 角色
- 运行环境、部署、日志、健康检查、区域选择、密钥注入、MCP 控制
- Gate.io 角色
- 交易所账户、API 密钥签发、行情数据、订单路由、托管、结算
- 关联关系
- TradingHost 是独立平台,与 Gate.io 无任何隶属关系。Gate.io 自 2021 年 9 月起对中国大陆地区实施屏蔽,且不对美国个人用户提供服务。
第 02 部分 · Gate.io 平台功能
Gate.io 平台功能
Gate.io 通过统一的 Gate API v4 接口(REST + WebSocket)提供 4,600 多种资产的现货交易、全仓与逐仓杠杆、USDT 保证金和 BTC 保证金永续合约、交割合约、BTC/ETH 及部分主流币种的期权、跟单交易和借贷服务。策略通过 HMAC-SHA512 签名的密钥进行身份验证;Futures TestNet 在独立的服务器上运行并使用专属密钥,而现货交易没有公开的沙盒环境。具体端点细节可能会随时间变化。虽然整体架构保持稳定,但精确的限频权重、手续费等级和交易对列表请以 Gate.io 的官方文档为准。
市场与策略模式
- 长尾山寨币现货轮动
- 跨交易所永续合约套利(USDT 保证金)
- BTC 保证金永续合约基差与资金费率套利
- BTC 和 ETH 期权交易(1h/4h/24h 短期或标准到期日)
- 全仓与逐仓杠杆交易
- 跟单交易信号镜像复制
- 模拟盘(Futures TestNet)沙盒运行
- 用于策略隔离的子账户层级管理
API 接口
- 产品范围
- 现货 REST 接口位于 `https://api.gateio.ws/api/v4`(现货端点在 `/spot/*` 下,杠杆端点在 `/margin/*` 下);永续/交割合约 REST 实盘接口位于 `https://api.gateio.ws/api/v4/futures/{usdt,btc}`(备用服务器为 `https://fx-api.gateio.ws/api/v4`);期权 REST 接口位于 `/api/v4/options`。Futures TestNet 位于 `https://fx-api-testnet.gateio.ws/api/v4`,需使用独立的 API 密钥。现货交易不提供公开沙盒。
- 连接方式
- REST v4(基于 HTTPS 的 JSON)、WebSocket v4(每个市场使用独立的 Socket):现货位于 `wss://api.gateio.ws/ws/v4/`,USDT 永续/交割合约位于 `wss://fx-ws.gateio.ws/v4/ws/usdt`,BTC 永续/交割合约位于 `wss://fx-ws.gateio.ws/v4/ws/btc`,TestNet 位于 `wss://fx-ws-testnet.gateio.ws/v4/ws/{usdt,btc}`。API v2 已于 2023 年 9 月 1 日停用。
- 身份验证
- 私有端点采用 HMAC-SHA512 签名,需在 Header 中携带三个必需字段:`KEY`(API 密钥)、`Timestamp`(Unix 时间戳,秒)、`SIGN`(签名字符串的十六进制 HMAC-SHA512 哈希值)。签名字符串格式为:`Method + "\n" + URL_Path + "\n" + QueryString + "\n" + HexEncode(SHA512(Body)) + "\n" + Timestamp`。支持子账户层级,但资产仅支持主账户与子账户之间划转(不支持子账户之间直接划转)。
具体细节请参考 Gate.io
具体端点、限频权重、交易对列表、手续费等级和版本历史请参阅 Gate.io 官方文档。请以官方文档为准。
第 03 部分 · 用 AI 构建
用 AI 构建您的 Gate.io 策略
选择一种集成方式,Fork 一个 TradingHost 框架模板,然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI Agent 均可无缝接入相同的 GitHub 原生部署循环。
原生 Gate API v4
直接控制 Gate.io 的特定行为、子账户路由以及跨现货、杠杆、永续合约、交割合约和期权的订单执行逻辑。
Freqtrade 或 Hummingbot
基于框架的部署,使用其策略结构和配置模型。Freqtrade 支持 Gate.io 现货和 USDT 保证金永续合约;Hummingbot 提供了 `gate_io` 和 `gate_io_perpetual` 接入器。
自定义接入器
您自主开发的内部交易引擎或专有的 Gate.io 集成方案。
框架对 Gate.io 产品的支持情况
各框架的支持范围有所不同。CCXT 覆盖最广泛的 Gate.io 产品线(现货、杠杆、永续合约、部分期权);Freqtrade 支持现货和 USDT 保证金永续合约;Hummingbot 提供现货和永续合约接入器;而原生 Gate API v4 则支持 Gate.io 的全部产品,包括 BTC、ETH 及部分主流币种的期权。
✓ 表示官方框架文档确认支持。“partial” 表示支持有限或仅限行情数据。“no” 表示官方文档未说明支持。“n/a” 表示该框架未对该产品线建模。工作流链接指向目前正在编写的 /workflows/ 页面。
TradingHost 不强求特定的框架,它只负责运行您的项目。
使用 AI 编写
上述框架模板与 AI IDE 是绝佳的搭配。TradingHost 的 MCP 控制面实现了闭环:AI 工具可以与您一同检查部署、查看日志并管理运行环境,但绝不会介入交易执行路径。
Section 04 · 在 TradingHost 上运行
在 TradingHost 上运行您的代码
Gate.io 提供交易所和 API 访问。TradingHost 则提供生产环境,用于运行您连接到 Gate.io 的策略。
无需在笔记本电脑、台式机、通用 VPS 或手动配置的服务器上运行策略代码,您只需从 GitHub 部署到由 TradingHost 托管的容器运行环境中。
您
- 您的代码库包含您的代码。
- 您的部署定义了其运行方式。
- 您的策略连接到 Gate.io。
TradingHost
- 保持运行环境持续在线。
- 呈现日志和健康状况检查。
- 区域选择。
- 受控的部署环境。
部署流程
- 步骤 01
连接 GitHub
授权 TradingHost 访问您的 GitHub 帐户。
- 步骤 02
关联代码库或从框架开始
将 TradingHost 指向您现有的策略代码库,或者派生 (fork) 一个 TradingHost 框架运行环境(CCXT、Freqtrade 或 Hummingbot)以获取可直接运行的基础模板。
- 步骤 03
部署至 TradingHost 容器
选择一个区域(EU 或 US-East),提供策略所需的环境变量(Gate.io API v4 密钥以及 HMAC-SHA512 签名模式),然后直接部署。TradingHost 会根据您的代码仓库构建容器,并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。
- 步骤 04
监控日志与健康状况
通过 TradingHost 控制面板实时查看日志、健康状况和运行状态。该界面同样支持在任何 AI IDE 中通过 MCP 进行访问,方便 Cursor、Claude Code 或 CLI 智能体与您协同读取部署状态并管理运行环境。
- 步骤 05
更新与重新部署
将代码更改推送到 GitHub 的主分支(main branch),TradingHost 便会自动重新部署。
Section 05 · 运维说明
Gate.io 运维说明
在容器化云端运行环境中实际运行 Gate.io 策略时可能遇到的隐蔽问题——这些内容在 Gate.io 的官方文档或框架的 README 中并未提及。以下所有陈述均引用或改写自 Gate.io 的官方文档;部署层面的指南则源自我们在 TradingHost 上运行这些策略的实际经验。
01 · API v4
v2 已于 2023 年 9 月停用,v4 是唯一可行路径
API v2 已于 2023 年 9 月 1 日下线;旧版 v2 密钥已无法通过身份验证,针对 v2 的任何下单或撤单操作都会静默失败或返回 401 错误。目前所有 Gate.io 集成都应指向 api.gateio.ws/api/v4 下的 v4 端点。
02 · 签名
十六进制编码的 HMAC-SHA512,并嵌入 Body 哈希值
大多数竞争对手交易所使用 SHA256 进行签名。Gate 的签名字符串在 method、path、query、body 的 hex-SHA512 以及 timestamp 之间插入 \n,且输出为十六进制(而非 base64)。组件顺序错误或哈希长度不对是导致 401 错误最常见的原因。请求头:KEY、Timestamp(Unix 秒)、SIGN(十六进制)。
03 · 子账户
仅支持主划转至子,建议使用独立的 API 密钥
资产划转仅支持主账户向子账户单向划转(不支持子账户之间划转)。VIP 等级和交易量额度会累积到主账户。建议为每个子账户签发独立的 API 密钥以隔离策略和风险,这样即使密钥泄露或策略失控,影响也仅限于该子账户,而不会波及整个账户资产。
04 · WebSocket
私有频道需要签名的订阅负载
私有频道需要签名的订阅负载(channel、event: "subscribe"、auth)。现货、USDT 合约、BTC 合约、期权和交割合约各有独立的 socket 连接,请勿复用。如果策略只打开一个 socket 并期望接收所有四种市场类型的数据,将会出现无提示的数据遗漏。
05 · Futures TestNet
在 fx-api-testnet 进行模拟交易,需使用独立密钥
模拟交易在 fx-api-testnet.gateio.ws 运行,需要使用独立的 API 密钥(生产环境密钥在此处会返回 401)。现货没有公开的沙盒环境,因此针对现货的模拟测试应使用 Freqtrade 的 dry_run 或 CCXT 录制功能,而非交易所沙盒。请将 TestNet 和生产环境的密钥保存在不同的 TradingHost Secrets 条目中,切勿跨环境复用。
06 · 地区限制
限制美国和中国大陆地区
美国公民及中国大陆居民无法在 Gate.io 进行交易。其他受限地区还包括加拿大、新加坡、英国、马耳他以及多个受制裁的司法管辖区。策略的运行不得为这些地区的居民牟利。在部署前,请确认您账户所属的持牌实体。
07 · 常见错误
INVALID_SIGNATURE、INVALID_PARAM_VALUE、仅支持限价止损
INVALID_SIGNATURE(签名字符串顺序或 body 哈希错误);提现接口返回 INVALID_PARAM_VALUE(需要 chain 字段);不支持市价止损(请使用限价);使用 POINT 支付手续费会破坏自动手续费推导;未绑定 IP 白名单的 API 密钥将在 90 天后过期。在非生产环境中记录哈希前的原始字符串,以便快速排查签名失败问题。
Section 06 · 适用场景
适用场景
TradingHost Gate.io 运行环境最适合用于:
- 在丰富的资产池中运行横截面动量或均值回归策略的长尾山寨币交易员
- 运行 USDT 保证金或 BTC 保证金永续合约腿的永续套利与基差交易员
- 交易 BTC/ETH 短期及标准到期期权的期权卖方与离散策略交易员
- 管理跟单流量并对接主子账户的跟单交易运营商
- 在 Cursor 或 Claude Code 中基于 CCXT `gate`、Freqtrade 或原生 v4 接口构建策略的 AI-IDE 开发者
连接 GitHub 并创建首个策略完全免费。
Section 08 · 常见问题
常见问题
没有。TradingHost 是独立的平台,与 Gate.io 无任何隶属关系。
不会。您的策略代码会根据您自己的逻辑、账户权限和集成方式连接到 Gate.io 并发送指令。TradingHost 仅提供运行该代码的托管运行环境。
不提供。Gate.io 的 API 访问权限由 Gate.io 官方提供。您需要自行负责您的 Gate.io 账户、API 权限、凭据以及对 Gate.io 服务条款的合规性。
不是。TradingHost 是运行您策略代码的云端运行环境。我们不提供交易信号、AI 预测模型或预设策略。使用 TradingHost,您需要自己编写或生成策略(通常使用 Cursor 或 Claude Code),将其作为代码保存在 GitHub 中,并使用 TradingHost 在生产环境中运行。3Commas、Cryptohopper 及类似产品拥有并提供策略逻辑,而 TradingHost 则是运行您自己编写的策略。
AWS 和 DigitalOcean 提供的是原始算力。您需要自己处理操作系统更新、容器编排、日志传输、密钥轮换、区域容灾和可用性监控。而 TradingHost 为您提供专为交易策略打造的托管运行环境:开箱即用的 GitHub 原生部署、AI IDE 的 MCP 驱动控制、日志和健康状况监控界面。如果您想自己运维基础设施,AWS 没问题;如果您希望将运行环境作为托管服务来使用,TradingHost 是更便捷的途径。
可以。TradingHost 支持运行 Python 策略。您可以选择与您的技术栈匹配的框架运行环境,或者直接部署您自己的代码库。
可以。TradingHost 支持任何可以在容器内运行的语言。
请使用 `gate`。这是当前活跃的类。虽然 `gateio` 仍可解析并继承自 `gate`,但新编写的代码应使用 `gate`。初始化示例:ccxt.gate({"apiKey": ..., "secret": ..., "options": {"defaultType": "swap"}}) 用于 USDT 保证金永续合约,"spot" 用于现货,"future" 用于交割合约,"option" 用于期权。完整配置说明请参阅 CCXT 框架运行环境文档。
可以,只要您的项目是这样设计的。您可以在一个运行环境中运行多个策略进程或服务,也可以将它们拆分到不同的运行环境中以实现隔离和清晰的运维管理。多策略模型详情请参阅 TradingHost 运行环境页面。
最快的方法是 Fork 一个 TradingHost 框架运行环境(如 CCXT、Freqtrade 或 Hummingbot)以获取开箱即用的项目,或者直接连接您自己的 GitHub 策略仓库。关联 GitHub 仓库和创建策略是免费的,运行环境方案详见价格页面。
保存在您通过 GitHub 控制的密钥(secrets)工作流中。TradingHost 在运行时通过 GitHub 仓库密钥、环境密钥或您认可的其他密钥管理流程来读取它们。TradingHost 不需要托管您的 API 密钥和私钥。完整处理模型请参阅平台密钥文档。
不需要。策略绝不应该需要提现权限。请使用限定范围的 v4 权限(现货交易、永续合约等),并使用 Gate.io 的 IP 白名单将密钥绑定到您运行环境的出站 IP。未绑定 IP 白名单的密钥将在 90 天后过期。
是的,这是 Gate 上推荐的模式。在主账户下创建子账户,为每个子账户签发专用的 API v4 密钥(仅赋予策略所需的最小权限),并让 TradingHost 将该密钥作为 Secret 注入。子账户的交易量和 VIP 等级仍会累积到主账户,但这样可以将密钥泄露或策略失控的影响范围限制在对应的子账户内。资产只能从主账户划转到子账户,无法在子账户之间直接划转。
可以。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,即可触发重新部署。
运行环境(runtime)会检测到崩溃,并公开相关的日志和健康状况信息。在支持的情况下,您可以重启受影响的策略,而不会干扰同一容器中运行的其他策略。您的策略代码仍需负责安全错误处理、防重复下单保护和风险控制。有关日志和健康状况界面的信息,请参阅可观测性(observability)部分。
Gate v4 使用 HMAC-SHA512(而非 SHA256)进行签名,签名字符串使用字面量 \n 进行拼接:Method + "\n" + URL_Path + "\n" + QueryString + "\n" + HexEncode(SHA512(Body)) + "\n" + Timestamp。输出为十六进制(hex),而非 base64。所需的三个请求头为 KEY、Timestamp 和 SIGN;不需要 passphrase(那是 OKX 的要求)。Body 哈希必须是原始请求体的十六进制 SHA512 哈希值,空 Body 的哈希值则是空字符串的 SHA512 哈希值。完整指南请参阅上方的“操作说明”部分。
是的,但仅限期货。Futures TestNet 的运行地址为 https://fx-api-testnet.gateio.ws/api/v4 (REST) 和 wss://fx-ws-testnet.gateio.ws/v4/ws/{usdt,btc} (WebSocket)。您必须生成独立的 TestNet API 密钥,生产环境的密钥无法在 TestNet 中通过身份验证。现货没有公开的沙盒环境;在实盘上线前,请使用 Freqtrade 的 dry_run 或 CCXT 的录制与回放模式来测试现货策略。
不可以。Gate.io 屏蔽了美国公民和美国居民。TradingHost 无法从美国账户向 Gate.io 路由订单,该限制源自交易所端。您也无法在中国大陆使用 Gate;在 2021 年 9 月 24 日中国人民银行发布禁令后,Gate 已退出该市场。其他受限制的司法管辖区包括加拿大、新加坡和英国。
TradingHost 在 EU 和 US-East 区域运行。请选择最靠近您策略所依赖的撮合引擎的区域。有关路由和物理距离的详细信息,请参阅区域页面。
不提供。TradingHost 专注于生产环境的运行和部署。回测应当在您的研究技术栈、框架或 AlgoBuilder 中进行。