阅读时间 … 分钟

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

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

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

交易平台
Ripio
平台类型
加密货币交易所（拉美，覆盖 8 个司法管辖区）
资产类别
支持拉美多种法币计价的加密货币（BRL、ARS、MXN、EUR、USD）
支持的产品
按国家/地区过滤的交易对现货交易（BTC_BRL、ETH_BRL、BTC_ARS、BTC_MXN、BTC_EUR 等）、本地稳定币（wARS、wBRL、wMXN）、Ripio Trade API v4
运行环境模式
容器化策略运行时
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
原生 Ripio Trade API v4 REST 和 WebSocket、CCXT、自定义连接器
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行时、部署、日志、健康检查、区域选择、MCP 控制
Ripio 角色
交易所账户、API 访问、市场接入、执行场所
关联关系
TradingHost 是独立平台，与 Ripio 无任何隶属关系

第 02 部分 · Ripio 平台功能

Ripio 平台功能

Ripio 在拉美 8 个司法管辖区提供现货交易，支持多种法币计价对（BRL、ARS、MXN、EUR、USD）和本地稳定币（wARS、wBRL、wMXN）。策略通过 Ripio Trade API v4 进行身份验证，并在基于 KYC 状态的分级速率限制下运行。通过 `countries` 查询参数过滤交易对，意味着单个策略可以部署到不同的区域产品集中。具体端点可能会随时间变化。虽然整体架构是稳定的，但具体的速率限制权重、交易对列表和最小交易量请以 Ripio 的官方文档为准。

市场与策略模式

  • BRL 计价的现货策略（BTC_BRL、ETH_BRL、USDC_BRL）
  • 阿根廷比索交易对的 ARS 计价现货策略
  • 墨西哥比索交易对的 MXN 计价现货策略
  • 本地稳定币交易（wARS、wBRL、wMXN）
  • 跨拉美法币的套利策略
  • 通过 `countries` 查询参数发现按国家/地区过滤的交易对
  • 针对敏感主题的 WebSocket 凭证验证订阅
  • 基于账户 KYC 分级的速率限制使用规划

API 接口

产品范围
在阿根廷、巴西、墨西哥、西班牙、乌拉圭、哥伦比亚、智利和美国提供按国家/地区过滤的交易对现货交易。交易对代码使用下划线表示法（如 BTC_BRL、ETH_BRL、BTC_ARS、BTC_MXN）。本地稳定币（wARS、wBRL、wMXN）支持直接的数字货币操作。每个交易对的最小交易量（min_amount）、最小交易额（min_value）和价格步长（price_tick）必须针对具体交易对进行查询。
连接方式
使用 REST 进行下单、账户查询和交易对发现。使用 WebSocket 流获取实时行情数据。访问敏感的 WebSocket 主题不仅需要 API 密钥，还需要在订阅前通过 POST `/v4/ticket` 获取凭证（ticket）。
身份验证
基于 KYC 状态的分级 API 速率限制。未认证账户：每秒 1 次请求（每日约 86,400 次）。已认证账户：每秒 3.5 次请求（每日约 302,400 次）。超出分级限制将返回 HTTP 429 以及标准的 retry-after 响应头。

具体细节请参考 Ripio

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

第 03 部分 · 用 AI 构建

用 AI 构建您的 Ripio 策略

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

  • 原生 Ripio API

    直接控制 Ripio 的特定行为，包括按国家/地区过滤的交易对发现以及拉美法币订单路由。

  • CCXT

    跨 Ripio 和其他加密货币交易所的通用接口。CCXT 通过统一的 `ripio` 类提供对 Ripio Trade 现货交易的支持。

    开始使用 CCXT

  • Freqtrade 或 Hummingbot

    目前这两个框架均未将 Ripio 列为一级支持的交易所。最佳路径是采用自定义实现或基于 CCXT 的实现。

  • 自定义连接器

    您自己的内部交易引擎，或针对 REST 和 WebSocket 接口自主开发的 Ripio Trade API v4 集成。

框架对 Ripio 产品的支持情况

各框架的支持范围有所不同。Ripio 在交易所层面仅支持现货（Trade 平台不提供原生永续合约或期权），因此该矩阵设计得较为精简。CCXT 通过其统一的 `ripio` 类支持 Ripio Trade 现货。目前 Freqtrade 和 Hummingbot 均未将 Ripio 列为一级支持的交易所；通过原生 API 访问则可以获取 Ripio Trade v4 发布的所有内容。

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

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

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

使用 AI 编写

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

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

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

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 帐户。

  2. 步骤 02

    关联代码库或从框架开始

    将 TradingHost 指向您现有的策略仓库，或者派生（fork）一个 TradingHost 框架运行时（CCXT），以建立针对 Ripio Trade API v4 的可用基线。

  3. 步骤 03

    部署至 TradingHost 容器

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

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

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

部署

Section 05 · 运维说明

Ripio 运维说明

在容器化云端运行时中实际运行 Ripio 策略时可能遇到的陷阱，这些内容在 Ripio 的文档或框架的 README 中是找不到的。以下所有陈述均引用或改写自 Ripio 的官方文档；部署侧的指南则源自我们在 TradingHost 上运行这些策略的实际经验。

  1. 01 · 基于 KYC 分级的速率限制

    未认证账户为 1 rps；已认证账户为 3.5 rps

    Ripio Trade API v4 的速率限制是基于 KYC 级别而非端点类别。未认证账户的上限为每秒 1 次请求（每日约 86,400 次）。已认证账户则提升至每秒 3.5 次请求（每日约 302,400 次）。超出该级别限制将返回 HTTP 429。如果一个策略在未认证状态下上线，并在运行中途升级为已认证，其安全轮询频率可以翻四倍；相反，如果一个针对未认证级别的策略在编写时假设其拥有已认证的权限，那么在第一天就会触发 429 错误。请将该级别编码为运行时配置，以确保速率限制预算清晰明确。

    来源Ripio Trade API v4 reference

  2. 02 · 按国家/地区过滤的交易对

    `countries` 查询参数是可交易对的权威来源

    Ripio 覆盖 8 个司法管辖区（AR、BR、MX、ES、UY、CO、CL、US），并设有各国的合规层级。交易对的可用性是通过 `countries` 查询参数进行过滤的，而不是统一的全球交易对列表。在巴西可交易的交易对在阿根廷可能无法交易，反之亦然。如果策略针对巴西的产品集硬编码了交易对列表，那么在阿根廷账户上运行时会静默失效。请在启动时通过受国家过滤的端点动态获取交易对，而不要在代码中写死。

    来源Ripio Trade API v4 reference

  3. 03 · 交易对代码使用下划线

    使用 BTC_BRL 和 ETH_BRL，而非 BTCBRL

    Ripio 交易对代码采用下划线表示法：BTC_BRL、ETH_BRL、BTC_ARS、BTC_MXN、BTC_EUR。这与 Binance 以及大多数将交易对拼接在一起（如 BTCBRL）的全球交易平台不同。CCXT 在其统一接口中会将交易对标准化为 BTC/BRL，但任何直接调用原生 API 的请求都必须使用下划线格式。从其他交易平台移植过来的策略代码，在修改此格式之前，往往会因为“未找到交易对”而静默失败。

    来源Ripio Trade API v4 referenceRipio trade integration examples

  4. 04 · 单个交易对的最小值限制

    `min_amount`、`min_value` 和 `price_tick` 因交易对而异，必须进行查询

    交易对的最小值和价格步长（price ticks）因法币交易对而异。BRL 交易对、ARS 交易对和 MXN 交易对各自拥有不同的 `min_amount`、`min_value` 和 `price_tick` 数值，在下单前必须针对每个交易对进行查询。如果在 BRL 和 ARS 交易对中硬编码使用相同的最小值，策略会根据当前运行的国家静默导致下单量过小或过大。请在启动时缓存每个交易对的字段，并在每次下单前重新验证，而不要假定存在一个全局最小值。

    来源Ripio Trade API v4 reference

  5. 05 · WebSocket 凭证验证

    敏感的 WebSocket 主题需要通过 POST `/v4/ticket` 获取凭证

    公开的 WebSocket 主题（行情数据、订单簿）是开放的。敏感主题（账户状态、订单事件）在订阅前除了需要 API key 外，还需要通过 POST `/v4/ticket` 获取凭证（ticket）。该凭证的生存时间（TTL）较短，对于长期运行的策略，必须定期刷新。容器在 WebSocket 连接断开并重新连接时，每次都必须请求新的凭证；重复使用过期的凭证会导致订阅静默失败，且订单状态回调将停止触发。

    来源Ripio Trade API v4 reference

  6. 06 · 本地稳定币

    wARS、wBRL 和 wMXN 支持直接进行数字货币操作

    Ripio 发行了本地稳定币 wARS、wBRL 和 wMXN，支持针对 BRL、ARS 和 MXN 市场直接进行数字货币操作。这些稳定币与 USDT/USDC 不同，可能具有不同的流动性、结算和手续费特征。针对 USDT 设计的策略所包含的假设无法自动套用到 wARS 或 wBRL 上。在确定实盘风险敞口大小之前，请单独验证本地稳定币交易对的深度和价差。

    来源Ripio Trade API v4 reference

Section 06 · 适用场景

适用场景

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

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

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

Section 08 · 常见问题

常见问题

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

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

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

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

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

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

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

可以。CCXT 提供了一个统一的 `ripio` 类，涵盖了 Ripio Trade 交易对上的现货交易。将您的 CCXT 策略放入容器中，将其指向 GitHub，TradingHost 就会像运行其他 Python 或 Node 项目一样运行它。有关完整的设置说明，请参阅 CCXT 框架运行时。

可以。Ripio 的拉美法币交易对（BTC_BRL、ETH_BRL、BTC_ARS、BTC_MXN、BTC_EUR 等）与全球交易对一样，都是通过相同的 REST 和 WebSocket API 进行访问的。您容器内的策略代码使用您的 Ripio Trade API 密钥进行身份验证，而 TradingHost 在运行时层面上与交易平台无关。请注意，交易对的可用性是通过 `countries` 查询参数进行国家过滤的，因此请在启动时动态获取交易对，而不要在代码中写死。

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

最快的方法是 fork 一个 TradingHost 框架运行时：例如使用 CCXT 获取开箱即用的项目。或者连接您自己的 GitHub 策略仓库。关联 GitHub 仓库和创建策略是免费的；运行时方案详见价格页面。

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

不需要。策略绝不需要提币权限。请将您的 API 密钥权限限制在仅允许交易和读取账户状态，并完全关闭该密钥的提币功能。

可以。TradingHost 支持针对 AI IDE 的基于 MCP 的控制，包括 Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI 智能体。AI 工具可以检查部署、查看日志、重启策略并管理运行时工作流。MCP 是一个控制和可观测性界面，而不是交易执行路径。有关完整信息，请参阅 MCP 控制界面。

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

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

Ripio Trade API v4 的频率限制根据 KYC 状态分档。未认证账户限制为每秒 1 次请求；已认证账户限制为每秒 3.5 次请求。超出对应档位的限制将返回 HTTP 429 错误。解决方法是根据您账户当前的档位调整请求频率，将该档位视为运行时的配置参数而非固定常量，并在遇到 429 错误时使用带随机抖动的指数退避算法进行重试。完整指南请参阅上方的“运行说明”部分。

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

不支持。TradingHost 专注于生产环境的运行和部署。回测应当在您的研究工具链、框架或 AlgoBuilder 中进行。