适用于 Robinhood Crypto 策略的 AI 原生运行时
在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署到托管云端运行时,并享有原生 MCP 控制、日志和区域选择支持。
第 01 部分 · 一览
一览
- 交易平台
- Robinhood Crypto
- 平台类型
- 美国零售加密货币交易平台,独立于 Robinhood Financial(股票)和母公司 Robinhood Markets Inc.。
- 资产类别
- 仅通过公开 API 提供加密货币现货交易。不提供美国股票、期权或期货的公开 API。
- 支持的产品
- Robinhood Crypto Trading API(2024 年 5 月 30 日推出)包含两个版本:v1 涵盖只读端点和无 fee tiers 的订单,v2 为符合条件的司法管辖区增加了支持 fee tier 的订单端点。
- 地区
- 仅限美国。仅限拥有活跃 Robinhood Crypto 账户的用户。
- 运行环境模式
- 容器化策略运行时
- 部署源
- GitHub
- 编程语言
- 任何可在容器中运行的语言
- 常用集成
- 原生 Robinhood Crypto REST 和 WebSocket API。CCXT、Freqtrade 和 Hummingbot 未将 Robinhood 列为支持的交易平台,因此大多数生产环境代码均采用带有 Ed25519 签名的原生 HTTPS 或社区 Python 封装库。
- AI 工作流集成
- 适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
- TradingHost 角色
- 运行时、部署、日志、健康检查、区域选择、机密管理、MCP 控制
- Robinhood 职责
- 加密货币账户、API 凭据、市场接入、执行平台、加密货币余额托管
- 关联关系
- TradingHost 保持独立,与 Robinhood Markets, Inc.、Robinhood Financial LLC 或 Robinhood Crypto, LLC 无任何关联。
第 2 部分 · Robinhood 提供哪些功能
Robinhood Crypto 平台功能
Robinhood Crypto Trading API 于 2024 年 5 月 30 日推出,是 Robinhood 发布的唯一公开编程接口。它为美国的活跃 Robinhood Crypto 客户提供加密货币现货交易。Robinhood 的美国股票、期权或期货产品不提供公开 API。身份验证采用基于固定消息格式的 Ed25519 签名;连接方式为 REST 和 WebSocket。由于 CCXT、Freqtrade 和 Hummingbot 未将 Robinhood 列入其支持的交易平台,因此生产环境策略通常直接针对原生 API 编写。
市场与策略模式
- 美国小额账户加密货币自动化交易(无需股票 API)
- 针对 BTC、ETH、SOL 及主流币种的 24/7 现货再平衡
- 围绕移动参考价格的限价阶梯式建仓
- 纯多头持仓的 stop-loss 和 stop-limit 风险对冲
- 通过 v2 fee-tier 端点进行感知手续费率的订单路由
- 包含美国合规交易所端跨平台套利
API 接口
- 产品范围
- 适用于加密货币现货的 Robinhood Crypto Trading API。该交易平台开放了账户、持仓、产品、行情和订单端点;v2 增加了感知 fee-tier 的订单端点。不提供美国股票、期权或期货的公开 API。
- 连接方式
- 账户、市场数据和订单端点采用 REST (HTTPS),同一门户文档中也提供了 WebSocket 支持。不支持 FIX。部分社区工具对私有端点进行了逆向工程,该途径违反了 Robinhood 的服务条款,并非 Trading API 所提供的内容。
- 身份验证
- Ed25519 密钥对。每个经过身份验证的请求都包含三个请求头:x-api-key、x-signature 和 x-timestamp。签名消息由 api_key、current_timestamp、请求路径、HTTP 方法和请求体拼接而成。公钥通过桌面浏览器上的 API Credentials Portal 进行注册;私钥绝不会离开您的运行时。
- 订单类型
- market、limit、stop_loss、stop_limit。v1 提交不含 fee tiers 的订单;v2 提交的订单会计入符合条件的 30-day volume,以适用相应的手续费率标准。
具体细节请参考 Robinhood
具体端点、限流数值、支持的交易对、fee tiers 和版本历史均记录在 Robinhood 的官方文档中。请以此为准。
第 03 部分 · 用 AI 构建
用 AI 构建您的 Robinhood Crypto 策略
选择一种集成方式,派生(fork)或新建一个策略仓库,然后在 AI IDE 中进行编写。Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI 智能体均可配合相同的 GitHub 原生部署循环工作。
原生 Robinhood Crypto API
采用 Ed25519 签名的直接 REST 和 WebSocket 调用。这是 Robinhood Crypto 风险最低的途径,因为没有框架抽象层,不会出现因框架更新滞后而无法使用平台新功能的情况。
CCXT
CCXT 未将 Robinhood 列入其支持的交易所。如果未来 CCXT 引入了 Robinhood 连接器,您可以在本页面跟踪其进展。
Freqtrade 或 Hummingbot
这两个框架均未提供 Robinhood 连接器。Freqtrade 依赖于 CCXT,因此同样存在这一缺失;Hummingbot 的交易所索引中也没有 Robinhood 条目。
自定义或社区客户端
目前存在社区 Python 客户端(例如 robin-stocks),其中部分针对官方 Crypto Trading API;在生产环境中使用前,请务必核实每个库使用的是带有 Ed25519 的官方文档端点,而非逆向工程的私有端点。
框架对 Robinhood Crypto 的支持情况
Robinhood Crypto 未被 CCXT、Freqtrade 或 Hummingbot 列出,因此适用于 Binance 或 Coinbase 的多交易所框架方案在此处并不适用。策略需直接针对 Robinhood Crypto Trading API 编写,使用 Ed25519 进行签名,并在 TradingHost 上运行,无需任何框架中间件。
✓ 表示官方框架文档确认支持。“否” 表示在发布时未在官方文档中注明支持。工作流链接指向目前正在撰写的 /workflows/ 页面。
TradingHost 不强求特定的框架,它只负责运行您的项目。
使用 AI 编写
直接调用 API 的代码与 AI IDE 是天然的绝配。TradingHost 的 MCP 控制面板实现了闭环:AI 工具可以与您协同检查部署、查看日志并管理运行时,但绝不会介入交易执行路径。
Section 04 · 在 TradingHost 上运行
在 TradingHost 上运行您的代码
Robinhood Crypto 提供交易所和 API 访问。TradingHost 则提供运行您 Robinhood 关联策略的生产环境。
无需在笔记本电脑、台式机、通用 VPS 或手动配置的服务器上运行策略代码,您只需从 GitHub 部署到由 TradingHost 托管的容器运行环境中。
您
- 您的代码库包含您的代码。
- 您的部署定义了其运行方式。
- 您的策略连接到 Robinhood Crypto。
TradingHost
- 保持运行环境持续在线。
- 呈现日志和健康状况检查。
- 区域选择。
- 受控的部署环境。
部署流程
- 步骤 01
连接 GitHub
授权 TradingHost 访问您的 GitHub 帐户。
- 步骤 02
关联代码仓库或从零开始
将 TradingHost 指向您现有的 Robinhood Crypto 策略仓库,或者围绕支持 Ed25519 签名的原生 REST 和 WebSocket 接口构建一个新仓库。
- 步骤 03
部署至 TradingHost 容器
选择一个区域(EU 或 US-East),提供策略所需的环境变量(Robinhood Crypto API 密钥、base64 编码的 Ed25519 私钥),然后进行部署。TradingHost 会根据您的代码仓库构建容器,并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。
- 步骤 04
监控日志与健康状况
通过 TradingHost 控制面板实时查看日志、健康状况和运行状态。该界面同样支持在任何 AI IDE 中通过 MCP 进行访问,方便 Cursor、Claude Code 或 CLI 智能体与您协同读取部署状态并管理运行环境。
- 步骤 05
更新与重新部署
将代码更改推送到 GitHub 的主分支(main branch),TradingHost 便会自动重新部署。
Section 05 · 运维说明
Robinhood Crypto 运维说明
在容器化云运行环境中实际运行 Robinhood Crypto 策略时(而非在 Robinhood 的文档或框架的 README 中)会遇到的陷阱。以下所有内容均引用或转述自 Robinhood 的官方文档;部署层面的指南则源自我们在 TradingHost 上运行这些策略的实际经验。
01 · 适用范围
Robinhood 唯一的公开 API 仅支持美国境内的加密货币现货交易
Robinhood Crypto Trading API 于 2024 年 5 月 30 日推出,是 Robinhood 发布的唯一公开程序化接口。该接口仅限美国境内的活跃 Robinhood Crypto 用户使用。目前没有针对美股、期权或期货的公开 API。如果您的策略需要交易股票或期权,请选择提供官方文档化 API 的交易平台,例如 Alpaca、Interactive Brokers、Tradier 或 Tastytrade;切勿依赖对 Robinhood 私有端点进行逆向工程的社区库。
02 · 身份验证
使用 Ed25519 签名请求,而非 HMAC
每个经过身份验证的请求都需要三个请求头:x-api-key、x-signature 和 x-timestamp。签名消息是 api_key、current_timestamp、请求路径、HTTP 方法和请求体(如果为空则省略请求体部分)的拼接字符串。使用您的 Ed25519 私钥生成签名。直接从 Binance 或 Coinbase 的 HMAC 示例中复制粘贴的代码库会因签名错误而失败;请选择明确针对 Base64 编码密钥对支持 Ed25519 的库。
03 · 版本
v1 用于提交非费率层级订单,v2 用于提交费率层级订单
Robinhood 发布了两个版本的 Trading API。v1 涵盖所有只读端点以及一个不区分费率层级的订单端点。v2 增加了支持费率层级的订单端点,这对于符合条件的司法管辖区用户至关重要,以便将其 API 交易计入已公布的 30-day volume 费率表。请针对每个端点谨慎选择版本;将 v1 订单与 v2 费率层级预期混用,通常是导致产生非预期手续费的原因。
04 · 订单
四种订单类型:market、limit、stop_loss 和 stop_limit
Trading API 支持 market、limit、stop_loss 和 stop_limit 订单。API 层没有原生的双向限价(bracket)、OCO 或追踪止损(trailing-stop)等基本指令;您需要在容器内的策略层自行实现这些逻辑。WebSocket 流与 REST 在同一个门户中提供文档说明,是获取实时行情更新的正确途径,优于通过紧密循环轮询 REST 行情端点。
05 · 框架
CCXT、Freqtrade 和 Hummingbot 未收录 Robinhood
截至本文发布时,CCXT 交易所列表、Freqtrade 文档(依赖于 CCXT)以及 Hummingbot 交易所索引均未收录 Robinhood Crypto。希望使用多交易所框架的策略代码需要自行将 Robinhood API 封装在兼容的接口后,或者直接使用原生 API。在依赖基于框架的捷径之前,请重新核实这三个来源。
06 · 凭据
在桌面浏览器中配置 API 密钥,并将私钥存储在运行环境中
API 凭据是通过桌面浏览器上的 Robinhood Crypto 设置门户创建的,无法在移动应用中创建。该门户会注册您的 Ed25519 公钥;与之配对的私钥始终由您自己控制。请像对待钱包助记词一样对待私钥:将其保存在由 GitHub 控制的机密(secrets)中,在运行时注入,切勿提交到代码仓库,并在员工离职或重新配置运行环境时轮换密钥。
Section 06 · 适用场景
适用场景
TradingHost Robinhood Crypto 运行环境最适合用于:
- 在 AI IDE(Cursor、Claude Code)中构建策略的开发者
- 美国的个人加密货币散户交易者
- 希望实现账户自动化的现有 Robinhood Crypto 客户
- 运行 24/7 现货策略的小额账户
- 从 VPS 托管转向容器化部署的团队
连接 GitHub 并创建首个策略完全免费。
Section 08 · 常见问题
常见问题
没有。TradingHost 是独立的,与 Robinhood Markets, Inc.、Robinhood Financial LLC 或 Robinhood Crypto, LLC 没有任何关联。Robinhood Crypto, LLC 运营加密货币交易所和 Trading API;该合作关系与 TradingHost 无关。
不会。您的策略代码会连接 to Robinhood Crypto,并根据您自己的逻辑、账户权限和集成方式发送指令。TradingHost 仅提供运行该代码的运行环境。
不提供。API 访问权限由 Robinhood Crypto 提供。您需要自行负责您的 Robinhood Crypto 账户、API 凭据、使用资格以及对 Robinhood 条款的合规性。
不能。Robinhood 唯一的公开程序化 API 是 Robinhood Crypto Trading API,仅涵盖加密货币现货。目前没有针对美股、期权或期货的官方公开 API。针对 Robinhood 移动应用端点的社区库依赖于逆向工程,这违反了 Robinhood 的服务条款。如需进行股票或期权的自动化交易,请选择拥有官方支持 API 的交易平台(Alpaca、Interactive Brokers、Tradier、Tastytrade)。
不能。截至本文发布时,CCXT 尚未将 Robinhood 列入其支持的交易所中。由于 Freqtrade 依赖于 CCXT,因此也同样不支持。Hummingbot 的交易所索引中也没有 Robinhood 连接器。在 Robinhood Crypto 上运行的策略需要直接针对支持 Ed25519 签名的原生 API 进行编写。
支持四种订单类型:market、limit、stop_loss 和 stop_limit。双向限价(bracket)、OCO 和追踪止损(trailing-stop)逻辑必须在您容器内的策略层自行实现。
可以。TradingHost 支持运行 Python 策略;您可以针对支持 Ed25519 签名的原生 Robinhood Crypto Trading API 部署您自己的代码仓库。
可以。TradingHost 支持可在容器内运行的任何语言。任何拥有 Ed25519 库的语言都适用于 Robinhood Crypto Trading API。
在桌面浏览器的 Robinhood Crypto 设置门户中创建 API 凭据,生成 Ed25519 密钥对并注册公钥,然后将包含您策略的 GitHub 仓库连接到 TradingHost。关联 GitHub 仓库和创建策略是免费的;运行环境方案已在定价页面列出。
存储在由您通过 GitHub 控制的机密(secrets)工作流中。Ed25519 私钥和 API 密钥会通过 GitHub 仓库机密、环境机密或您自己认可的机密管理流程注入到运行环境中。TradingHost 不需要托管其中任何一个。请参阅平台机密以了解完整的处理模式。
将 api_key + current_timestamp + request_path + http_method + body(如果为空则省略 body)进行拼接。使用您的 Ed25519 私钥对生成的字符串进行签名。发送三个请求头:x-api-key、x-signature 和 x-timestamp。Robinhood 会根据为该 API 密钥注册的公钥来验证签名。
两个版本都支持读取端点(accounts、holdings、orders、products、quotes)。v1 下单时不计入 fee tier(费率层级)。v2 下单则会记入您符合条件的 30-day volume(30 天交易量),并适用已公布的费率表。在支持的司法管辖区内,建议选择 v2,以便 API 交易遵循与 Robinhood App 内交易相同的费率逻辑。
可以。TradingHost 支持针对 AI IDE(包括 Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI agent)的 MCP 控制。AI 工具可以检查部署、查看日志、重启策略并管理运行时的整个工作流。MCP 是控制和可观测性界面,而非交易执行路径。详情请参阅 MCP 控制界面介绍。
TradingHost 在 EU 和 US-East 区域运行。由于 Robinhood Crypto 是一家美国交易平台,因此选择 US-East 是获得最低 API 网络往返延迟的自然选择。有关路由的详细信息,请参阅区域页面。
不可以。Robinhood 仅向位于美国的活跃 Robinhood Crypto 用户开放 Crypto Trading API 访问权限。如果您居住在美国境外,该交易场所并不适用,请选择其他面向全球的加密货币交易所。
Robinhood 于 2024 年 5 月 30 日向美国活跃的 Robinhood Crypto 用户推出了 Crypto Trading API。API 的 v2 版本在发布后新增了支持 fee-tier 的下单端点。
需谨慎对待。原则上,针对官方 Crypto Trading API 并使用 Ed25519 签名的库是没有问题的;但针对 Robinhood 移动端 App 私有端点的库则是通过逆向工程实现的,违反了 Robinhood 的服务条款,并存在被封禁账户的风险。在 TradingHost 运行时中使用任何第三方 Robinhood 库之前,请务必确认其调用的是已公开文档的 Crypto Trading API 端点,而非私有的移动端 App 端点。
不支持。TradingHost 专注于生产环境的运行和部署。回测应当在您的研究工具链、框架或 AlgoBuilder 中进行。