阅读时间 … 分钟

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

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

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

经纪商
Tradier Brokerage Inc.
经纪商类型
受美国监管的零售经纪商,提供面向期权开发者的 API
资产类别
美股、美股期权、ETF
资产覆盖范围
美股(NYSE、NASDAQ、ARCA、BATS、IEX 上市股票)、美国上市期权(单腿和 multi-leg,经 OCC 清算)、ETF。Tradier 另通过 Tradier Brokerage 提供加密货币交易;此处记录的 Trading API 接口仅针对股票和期权。
运行环境模式
容器化策略运行环境
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
Tradier REST API、Tradier WebSocket streaming、python-tradier 及社区 SDK、NautilusTrader、原生 HTTP 客户端、自定义连接器
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行环境、部署、日志、健康检查、区域选择、MCP 控制
Tradier 角色
经纪商账户、API 接入、市场数据、执行场所、托管、清算、税务申报
监管机构
Tradier Brokerage Inc.:SEC 和 FINRA 注册经纪交易商(CRD 142315)。SIPC 成员。
美国零售客户
是。提供用于开发的 sandbox 环境。
隶属关系
TradingHost 保持独立,与 Tradier Brokerage Inc. 或 Tradier Inc. 无任何关联。

第 02 部分 · Tradier 提供的服务

Tradier 提供的服务

Tradier 提供了 REST 和 WebSocket API,定位面向期权开发者。其最显著的特点包括 multi-leg 订单、带 Greeks 的 options chain 端点,以及与生产环境完全一致的 sandbox。具体的端点路径和请求格式请参阅 Tradier 的 documentation。

市场与策略模式

  • Multi-leg 美股期权策略(垂直价差、铁鹰、蝴蝶)
  • 周度及 0DTE SPX、QQQ、SPY 期权自动化
  • 经 sandbox 验证的策略,仅需更改配置即可切换至生产环境
  • 通过 WebSocket 流式传输报价并监控 options chain
  • 以编程方式获取 options chain Greeks 数据
  • 在单一凭据下运行股票加期权的组合策略

API 接口

产品接口
适用于美股、美股期权和 ETF 的 Trading API。用于获取报价、options chains(含 Greeks)、历史数据和逐笔成交数据的 Market Data API。基于 WebSocket 的 Streaming API,用于实时报价和账户事件。Sandbox 端点与生产环境镜像一致,使用相同的路由。
连接方式
使用 HTTPS REST 获取订单、账户状态、options chains 和账户历史。使用 WebSocket 流式传输实时市场数据和账户事件。生产环境 (api.tradier.com) 和 sandbox (sandbox.tradier.com) 使用相同的端点格式,仅主机名和访问令牌不同。
身份验证
在 Authorization header 中使用 OAuth 2.0 bearer token。令牌按应用和环境(sandbox 与生产环境)发放,并可限制为只读、交易或市场数据权限。Sandbox 令牌无法下达生产订单。

具体细节请参考 Tradier

具体的端点、速率限制、期权审批要求和市场数据权限请参阅 Tradier 的 documentation。请以其为准。

第 03 部分 · 使用 AI 构建

使用 AI 构建您的 Tradier 策略

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

  • 原生 Tradier REST 与 WebSocket

    直接对 api.tradier.com(生产环境)或 sandbox.tradier.com 发起 HTTPS REST 请求。通过 WebSocket 流式传输实时报价和账户事件。采用 OAuth 2.0 bearer-token 认证。

  • 社区 Python 库

    社区维护的 REST 和 WebSocket 接口 Python 封装库。python-tradier 是目前活跃维护的选择之一;请选择适合您策略技术栈的库。

  • 框架适配器

    NautilusTrader 和其他事件驱动框架通过经纪商适配器接入 Tradier。由于 Tradier 原生支持 multi-leg 订单,因此对期权策略的支持非常友好。

  • 自定义连接器

    您自研的内部交易引擎或专有的 Tradier 集成。Tradier 的 REST 接口足够精简,只需几百行 Python 或 TypeScript 代码即可完成封装。

Tradier 产品的库与框架支持情况

Tradier 的 REST 和 WebSocket 接口非常精简,因此除了使用社区库外,自研自定义连接器也非常可行。NautilusTrader 的适配器支持范围因版本而异;在依赖特定功能前,请先核对当前的适配器文档。

库或框架美股美股期权多腿交易沙盒环境
Native REST + WebSocket支持支持支持支持
python-tradier支持支持支持支持
NautilusTrader部分支持部分支持部分支持支持
Custom connector支持支持支持支持

✓ 表示根据库或接口文档已确认支持。“核对适配器”表示框架集成的支持范围因版本而异;请核对当前的文档。

TradingHost 不强求使用特定库。它直接运行您的项目。

使用 AI 编写

Tradier 接口精简且文档完善,非常适合 AI 辅助编写:其 REST API 只是对下单、账户状态和 options chain 查询的轻量封装,AI IDE 可以直接根据文档链接生成代码骨架。TradingHost 的 MCP 控制面板则实现了闭环:AI 工具可以协助您检查部署、查看日志并管理运行环境,但绝不会介入交易执行路径。

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

Tradier 提供经纪商账户、API 接入和执行场所。TradingHost 则提供生产环境,用于运行您连接至 Tradier 的策略。

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

您

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

TradingHost

  • 保障运行环境持续在线。
  • 呈现日志与健康检查。
  • 提供区域选择。
  • 提供受控的部署面板。

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 账户。

  2. 步骤 02

    关联代码库或从模板开始

    将 TradingHost 指向您现有的 Tradier 策略仓库,或者 fork 一个 python-tradier 起步模板以获取可运行的基础代码。

  3. 步骤 03

    部署到 TradingHost 容器中

    选择一个区域(US-East 是美股和期权策略的自然之选),提供您的 Tradier 访问令牌作为环境变量,然后进行部署。TradingHost 会从代码仓库构建您的容器,并在托管的 Kubernetes 基础设施上运行您的策略。使用沙箱令牌的部署可在您切换到生产环境令牌之前进行端到端的验证。

  4. 步骤 04

    监控日志与健康状况

    通过 TradingHost 控制台实时查看日志、健康状况和运行状态。您也可以在任何 AI IDE 中通过 MCP 访问相同的面板,因此 Cursor、Claude Code 或 CLI 智能体可以与您一同读取部署状态并管理运行环境。交易执行仍保留在策略代码路径中,而非通过 MCP。

  5. 步骤 05

    更新与重新部署

    将更改推送至您的 GitHub 主分支,TradingHost 会自动重新部署。在切换到生产环境令牌之前,使用 sandbox 密钥的部署是天然的测试环境。

Section 05 · 运维说明

Tradier 运维说明

在容器化云端运行环境中实际运行 Tradier 策略时需要注意的陷阱。以下所有说明均引用或转述自 Tradier 官方文档;部署侧的指南则源自于在 TradingHost 上运行这些策略的实际经验。

  1. 01 · OAuth2 bearer

    访问令牌为 bearer token,按应用和环境独立发放

    Tradier 通过 Authorization header 中的 OAuth 2.0 bearer token 进行身份验证。令牌按应用和环境发放,因此 sandbox 令牌无法下达生产订单,反之亦然。相同的源代码可以从 TradingHost Secrets 条目中读取令牌;请将 sandbox 和生产环境令牌保存在不同的 secrets 中。

  2. 02 · 沙盒

    sandbox.tradier.com 与 api.tradier.com 实现端点对端点镜像

    沙盒环境提供与生产环境完全相同的端点路径和请求格式,并使用沙盒颁发的 token 和仅限沙盒的账户余额。将通过沙盒验证的策略升级为实盘运行只需切换配置(主机和 token),无需重写代码。这是 Tradier 最强大的开发者体验功能之一。

  3. 03 · 多腿订单

    多腿期权订单在单个请求中使用 order class 字段

    Tradier 通过单个 orders 端点提供单腿、multi-leg、OTOCO 等 order class,并通过 class 字段指定构建方式。请求体中包含每腿的具体规格。相比某些经纪商提供的每腿数组端点,Tradier 的订单端点格式更为紧凑;相应的代价是需要更仔细地构建请求体。具体字段布局请参考 orders 的 documentation。

  4. 04 · 市场数据

    实时数据受权限限制;默认提供延迟行情

    Tradier 账户默认接收延迟行情。实时市场数据需要账户获得明确授权,该权限需通过 Tradier 而非 TradingHost 启用。依赖最优买卖价(top-of-book)实时数据的策略在部署前应先确认已获得相应权限。

  5. 05 · 期权交易权限

    期权交易权限基于账户开通,并限制订单端点的调用

    在 Tradier 进行期权交易,除了开户之外,还需要单独的审批步骤。获批的权限等级决定了订单端点接受哪些策略;超出获批等级的订单将在经纪商端被拒绝。请根据您获批的等级规划策略,或在部署前向 Tradier 申请调高权限等级。

Section 06 · 适用对象

适用对象

TradingHost Tradier 运行环境最适合:

  • 在 AI IDE(Cursor、Claude Code)中构建策略的开发者
  • 期权策略自动化交易者(垂直价差、铁鹰价差、日历价差)
  • 周度及 0DTE 系统化期权交易者
  • 构建 API 优先股票工具的 Python 开发者
  • 独立量化交易员及小型交易工作室

连接 GitHub 并创建您的首个策略是免费的。

Section 08 · 常见问题

常见问题

没有。TradingHost 是一家独立公司,与 Tradier Brokerage Inc. 或 Tradier Inc. 无任何隶属关系。

不是。TradingHost 是交易策略代码的运行环境(runtime)。Tradier Brokerage Inc. 才是经纪交易商(broker-dealer),在 SEC 和 FINRA(CRD 142315)注册,且为 SIPC 成员。您的账户、资产托管、市场接入、清算和税务申报均由 Tradier 负责。

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

不提供。Tradier API 访问权限由 Tradier 提供。您需要自行负责您的 Tradier 账户、应用注册、OAuth token 以及遵守 Tradier 的条款。

可以。Tradier 提供了 multi-leg 订单端点,接受垂直价差(vertical spreads)、铁鹰价差(iron condors)、蝴蝶价差(butterflies)、日历价差(calendars)和对角价差(diagonals)。您 Tradier 账户的期权交易权限等级决定了经纪商接受哪些策略;TradingHost 无法绕过该权限审批。

可以,但取决于您的期权交易权限等级和市场数据权限。Tradier 通过与月度合约相同的 options chain 端点提供周度及 0DTE 到期合约的数据。获取实时数据可能需要升级数据权限。

任何可以在容器中运行的语言。Tradier 的 API 是 HTTPS REST 加上 WebSocket 流媒体,因此任何 HTTP 和 WebSocket 客户端都可以与其通信。社区 Python 库(包括 python-tradier)非常流行;Node.js、Go、Rust 等语言也以同样的方式工作。

连接包含策略代码的 GitHub 仓库,将其关联到 TradingHost,然后进行部署。使用配置了 sandbox-token 的部署作为测试环境,待策略稳定后升级为生产 token。关联 GitHub 和创建策略是免费的;运行环境方案已列在定价页面上。

存放在您通过 GitHub 控制的 secrets 工作流中。TradingHost 在运行时通过 GitHub 仓库 secrets、环境 secrets 或您自己批准的密钥管理流程读取它们。TradingHost 不需要托管您的 bearer token。有关完整的处理模式,请参阅平台 secrets。

不需要。策略绝不需要提现或资金划转权限。访问 token 仅需要下单和获取市场数据所需的权限范围(scopes)。

可以。TradingHost 支持针对 AI IDE(包括 Cursor、Claude Code、GitHub Copilot 和基于 CLI 的 AI 智能体)的基于 MCP 的控制。AI 工具可以检查部署、查看日志、重启策略并管理运行环境工作流。MCP 是一个控制和可观测性界面,而非交易执行路径。请参阅 MCP 控制界面了解全貌。

不会。PDT 规则(FINRA Rule 4210)由 Tradier 强制执行,而非 TradingHost。资产低于 $25,000 的保证金账户在进行日内交易时将受到 PDT 限制。

不会。您的 1099 表单在年底由 Tradier 提供,而非 TradingHost。

不享有。SIPC 成员保护为您的 Tradier 证券账户提供最高 $500,000(包括 $250,000 现金)的保障。TradingHost 的运行环境不享有 SIPC 保险,因为 TradingHost 不是经纪商。

TradingHost 在 EU 和 US-East 区域运行。US-East 距离美股和美国期权撮合引擎最近,是 Tradier 策略的自然之选。请参阅区域页面了解路由与物理距离详情。

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