适用于 Alpaca 策略的 AI 原生运行环境
在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署到托管云端运行环境，提供一流的 MCP 控制、日志和区域选择。
第 01 部分 · 一览
一览
- 经纪商
- Alpaca Securities LLC
- 经纪商类型
- 受美国监管的零售经纪商，API 优先
- 资产类别
- 美股、美股期权、加密货币
- 资产覆盖范围
- 美股（NYSE、NASDAQ、NYSE ARCA、BATS、IEX 上市股票）、美国上市期权（单腿和多腿，经 OCC 清算）、加密货币（通过子公司 Alpaca Crypto LLC 提供）、碎股、ETF。
- 运行环境模式
- 容器化策略运行环境
- 部署源
- GitHub
- 编程语言
- 任何可在容器中运行的语言
- 常用集成
- alpaca-py（当前的 Python SDK）、alpaca-trade-api（旧版）、alpaca-trade-api-js、原生 REST 和 WebSocket 客户端、NautilusTrader、自定义连接器
- AI 工作流集成
- 适用于 Cursor、Claude Code、GitHub Copilot 和 CLI 代理的 MCP 控制面板
- TradingHost 角色
- 运行环境、部署、日志、健康检查、区域选择、MCP 控制
- Alpaca 角色
- 经纪商账户、API 接入、行情数据、执行场所、托管、清算、税务申报
- 监管机构
- Alpaca Securities LLC：SEC 和 FINRA 注册经纪交易商（CRD 288257），SIPC 成员。Alpaca Crypto LLC：FinCEN 注册的加密货币交易货币服务业务（MSB）。
- 美国零售客户
- 是。同时支持模拟（Paper）和实盘（Live）交易。
- 隶属关系
- TradingHost 保持独立，与 Alpaca Securities LLC 或 Alpaca Crypto LLC 无任何隶属关系
第 02 部分 · Alpaca 提供的服务
Alpaca 提供的服务
Alpaca 通过单一凭证提供面向开发者的 REST 和 WebSocket API，涵盖美股、美股期权和加密货币。Trading API 和 Market Data API 位于不同的主机。模拟和实盘环境共享相同的端点结构并使用独立的密钥，因此在模拟环境中测试过的策略无需重写代码即可直接上线实盘。
市场与策略模式
- 支持碎股（fractional share）的投资组合再平衡
- 单腿和多腿美股期权策略
- 统一 Trading API 下的股票、期权和加密货币交易
- 经模拟验证的策略，无需修改代码即可直接上线实盘
- 报价、交易和账户事件的 WebSocket 流式传输
- Alpaca Crypto LLC 现货加密货币策略（BTC、ETH 等）
- 基于 Algo Trader Plus SIP 数据的系统化股票策略
API 接口
- 产品接口
- 通过单一凭证使用 Trading API v2 进行美股、美股期权和加密货币交易。Market Data API 在独立主机上提供报价、交易和 K 线（bars）数据。模拟和实盘环境使用不同的基础 URL 和独立的密钥；两者采用相同的端点结构，因此在模拟环境中测试过的代码无需重写即可直接上线实盘。
- 连接方式
- REST 用于订单、持仓、账户状态、期权链和资产元数据。WebSocket 流用于实时行情数据（报价、交易、K 线）以及账户级别的交易更新。加密货币、股票和期权共享相同的 REST 和 WebSocket 规范，仅在 asset_class 和端点路径上有所不同。
- 身份验证
- 在请求头中通过 APCA-API-KEY-ID 和 APCA-API-SECRET-KEY 传递 API 密钥 ID 和密钥。模拟和实盘密钥分别发放；模拟密钥无法下达实盘订单。OAuth 2.0 适用于委托应用（例如经纪商前端金融科技项目），而非个人策略接入。
具体细节请参考 Alpaca
具体端点、速率限制、行情数据订阅层级和期权审批要求请参见 Alpaca 的官方文档。请以官方文档为准。
第 03 部分 · 使用 AI 构建
使用 AI 构建您的 Alpaca 策略
选择一种集成方式，派生（fork）一个 TradingHost 框架模板，然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 和基于 CLI 的 AI 代理均支持相同的 GitHub 原生部署工作流。
原生 Alpaca REST 和 WebSocket
直接控制 Alpaca 账户状态、订单端点和 Market Data API。支持在容器中运行任何 HTTP 和 WebSocket 客户端。
alpaca-py
alpacahq 当前的官方 Python SDK。涵盖 Trading API、Market Data API、经纪商 API 和加密货币。推荐新项目使用。
alpaca-trade-api（旧版）
较旧的 Python SDK，目前仍为现有策略提供维护。Alpaca 建议新开发项目迁移至 alpaca-py。
自定义或框架连接器
NautilusTrader、自研引擎、通过 alpaca-trade-api-js 实现的 JavaScript 和 TypeScript，以及任何其他封装了 Alpaca REST 和 WebSocket 端点的框架。
Alpaca 产品的库与框架支持情况
alpaca-py 涵盖了 Alpaca 的完整功能（股票、期权、加密货币、模拟交易），是新项目的推荐 SDK。alpaca-trade-api 仍为现有策略提供维护。NautilusTrader 拥有社区维护的 Alpaca 集成；在依赖该适配器之前，请先查阅其当前文档以确认期权功能的支持情况。
✓ 根据官方 SDK 或适配器文档确认支持。“partial” 表示适配器层面的部分支持；请对照集成的当前文档进行验证。“check SDK” 表示该功能取决于 SDK 版本。工作流链接指向目前正在编写的 /workflows/ 页面。
TradingHost 不强求使用特定库。它直接运行您的项目。
使用 AI 编写
alpaca-py 和 alpaca-trade-api 均可与 AI IDE 协同工作。TradingHost MCP 控制面板实现了闭环：AI 工具可以与您协同检查部署、查看日志并管理运行环境，但绝不会干涉交易执行路径。
Section 04 · 在 TradingHost 上运行
在 TradingHost 上运行您的代码
Alpaca 提供经纪商账户、API 接入和执行场所。TradingHost 则提供生产环境，用于运行您连接至 Alpaca 的策略。
您无需在笔记本电脑、台式机、通用 VPS 或手动配置的服务器上运行策略代码，只需从 GitHub 部署到 TradingHost 托管的容器运行环境中即可。
您
- 您的代码库包含您的代码。
- 您的部署定义了其运行方式。
- 您的策略连接至 Alpaca。
TradingHost
- 保障运行环境持续在线。
- 呈现日志与健康检查。
- 提供区域选择。
- 提供受控的部署面板。
部署流程
- 步骤 01
连接 GitHub
授权 TradingHost 访问您的 GitHub 账户。
- 步骤 02
关联代码库或从模板开始
将 TradingHost 指向您现有的 Alpaca 策略仓库，或者派生（fork）一个 alpaca-py 模板作为可运行的基础。
- 步骤 03
部署到 TradingHost 容器中
选择一个区域（US-East 距离美股撮合引擎最近；EU 适用于欧洲交易时段的加密货币），提供您的 Alpaca API key 和 secret 作为环境变量，然后进行部署。TradingHost 会从代码仓库构建您的容器，并在托管的 Kubernetes 基础设施上运行您的策略。无需在本地安装 Docker。
- 步骤 04
监控日志与健康状况
通过 TradingHost 控制台实时查看日志、健康状况和运行状态。您也可以在任何 AI IDE 中通过 MCP 访问相同的面板，因此 Cursor、Claude Code 或 CLI 智能体可以与您一同读取部署状态并管理运行环境。交易执行仍保留在策略代码路径中，而非通过 MCP。
- 步骤 05
更新与重新部署
将更改推送到您的 GitHub 主分支，TradingHost 将自动重新部署。在升级到实盘密钥之前，使用模拟密钥进行部署是首选的测试方式。
Section 05 · 运维说明
Alpaca 运维说明
在容器化云端运行环境中实际运行 Alpaca 策略时可能会遇到的陷阱，这些内容并不总是在 Alpaca 的官方文档或框架的 README 中提及。以下所有陈述均引用或改写自 Alpaca 自身的官方文档或主要监管机构来源；部署端的指南则源自于在 TradingHost 上运行这些策略的实际经验。
01 · 身份验证请求头
请求头中的 APCA-API-KEY-ID 和 APCA-API-SECRET-KEY
Alpaca 通过在 APCA-API-KEY-ID 和 APCA-API-SECRET-KEY 请求头中携带 API 密钥 ID 和密钥来对 Trading API 请求进行身份验证。没有单独的签名步骤。OAuth 2.0 是一个独立的流程，供委托应用程序（例如为客户基于 Alpaca 构建服务的金融科技公司）使用，而非供个人策略使用。模拟（Paper）和实盘（Live）密钥是分别颁发的，不可互换。
02 · 模拟与实盘
模拟环境使用不同的基准 URL 和不同的密钥
模拟交易运行在 paper-api.alpaca.markets。实盘交易运行在 api.alpaca.markets。WebSocket 流式传输端点也存在类似差异。为模拟环境生成的密钥无法在实盘环境中下单，反之亦然。除此之外，端点接口完全相同，因此在模拟环境中验证通过的代码只需更换基准 URL 和密钥集即可晋升至实盘。请将模拟和实盘的机密信息保存在不同的 TradingHost Secrets 条目中；切勿跨环境复用。
03 · 市场数据层级
基础版（仅限 IEX）对比 Algo Trader Plus（完整美国 SIP）
Alpaca 的默认市场数据计划仅返回 IEX 的报价和交易，这对于许多系统化策略来说已经足够，但从定义上讲它只是部分订单簿。Algo Trader Plus 是付费的 SIP 级别计划，可解锁综合行情数据。依赖跨所有交易场所的最优报价（top-of-book）准确性的策略，应将订阅 Algo Trader Plus 声明为部署的前提条件；而仅基于 IEX 采样运行的策略则不需要。
04 · 碎股交易
碎股订单使用 notional 而非 qty，并检查 fractionable: true
Alpaca 支持按代码逐个启用碎股交易。要按美元金额而非股票数量进行购买，请提交带有 notional 而非 qty 的订单。在提交之前，请检查资产元数据端点并确认 fractionable: true；并非所有上市代码都支持碎股交易。已取消的碎股订单无法像整股订单那样进行部分成交，因此错误处理需要考虑到这一差异。
05 · 期权交易权限审批
需与股票账户分开申请；审批层级决定了可接受的策略
在 Alpaca 进行期权交易，除了股票开户之外，还需要一个单独的审批步骤。审批层级会暴露在账户端点上；超出审批层级的订单将被 Alpaca 拒绝，而非被 TradingHost 拒绝。请围绕符合您已获批层级的策略来规划部署，或者在部署前向 Alpaca 申请提高审批层级。TradingHost 无法豁免或提升期权审批层级。
06 · 典型日内交易者
根据 FINRA Rule 4210，PDT 适用于资金低于 $25,000 的保证金账户
根据 FINRA Rule 4210，如果在五个工作日内进行四次或更多次日内交易，保证金账户将被标记为 Pattern Day Trader，并限制进一步的日内交易，直到账户净值达到 $25,000。Alpaca 在账户端点上暴露了该标志（pattern_day_trader）。该规则由经纪商强制执行，而非由运行环境执行。在低于该门槛的保证金账户上频繁进行日内交易的策略，需要围绕该限制进行规划，或者将账户资金充值到 $25,000 以上。
07 · 加密货币实体
加密货币通过 Alpaca Crypto LLC 进行交易，这是一家独立的 FinCEN 注册实体
现货加密货币交易由在 FinCEN 注册的货币服务企业（Money Services Business）Alpaca Crypto LLC 提供，而非由 Alpaca Securities LLC 提供。从策略的角度来看，凭据是相同的，且订单接口通过相同的 Trading API 暴露；但从监管的角度来看，法律实体是不同的。SIPC 的保障范围适用于经纪自营商（broker-dealer）账户，但不适用于持有的加密货币。请在您随策略生成的任何风险披露文本中明确说明这一点。
Section 06 · 适用对象
适用对象
TradingHost Alpaca 运行环境最适合：
- 在 AI IDE（Cursor、Claude Code）中构建策略的开发者
- 系统化股票和期权交易员
- 从 notebook 转向生产环境的量化开发者
- 使用 alpaca-py 的 Python 开发者
- 告别经纪商 GUI（Robinhood、Webull、Power E*Trade）的零售交易员
连接 GitHub 并创建您的首个策略是免费的。
Section 08 · 常见问题
常见问题
没有。TradingHost 是独立的，与 Alpaca Securities LLC 或 Alpaca Crypto LLC 没有任何隶属关系。
不是。TradingHost 是交易策略代码的运行环境。Alpaca Securities LLC 是经纪自营商（broker-dealer），在 SEC 和 FINRA（CRD 288257）注册，且为 SIPC 成员。您的账户、托管、市场准入、结算和税务申报均由 Alpaca 负责。
不会。您的策略代码会连接 to Alpaca，并根据您自己的逻辑、账户权限和集成方式发送订单指令。TradingHost 仅提供运行该代码的运行环境。
不提供。Alpaca API 访问权限由 Alpaca 提供。您需要自行负责您的 Alpaca 账户、API 权限、凭据以及对 Alpaca 条款的合规性。
AWS 和 DigitalOcean 为您提供的是原始算力。您需要自己处理操作系统更新、容器编排、日志传输、机密轮换、区域容灾和运行时间监控。而 TradingHost 为您提供专为交易策略构建的托管运行环境：GitHub 原生部署、来自 AI IDE 的 MCP 驱动控制，以及开箱即用的日志和健康状况监控界面。如果您想自己运营基础设施，AWS 是可行的。如果您希望将运行环境作为托管服务，TradingHost 是更快捷的途径。
可以。Alpaca 当前的 Python SDK 是 alpaca-py；较旧的 alpaca-trade-api 仍在维护中。两者都可以在 TradingHost 上运行。JavaScript 和 TypeScript 可以通过 alpaca-trade-api-js 运行。
可以。TradingHost 支持任何可以在容器内运行的语言。Alpaca 为 JS 和 TS 提供了 alpaca-trade-api-js；其他语言可以直接调用 REST 和 WebSocket 端点。
可以，但须经 Alpaca 的期权审批。期权与股票和加密货币通过相同的 Trading API 凭据暴露。获批的层级决定了经纪商接受哪些策略；TradingHost 无法绕过期权审批。
可以。加密货币由 Alpaca Crypto LLC 提供，这是一家在 FinCEN 注册的货币服务企业（Money Services Business），与 Alpaca Securities LLC 是不同的法律实体。从策略的角度来看，Trading API 凭据是相同的；但从监管的角度来看，实体是不同的。
连接包含策略代码的 GitHub 仓库，将其链接到 TradingHost，然后进行部署。使用配置了模拟密钥的部署作为测试环境，一旦策略稳定，即可晋升为实盘密钥。链接 GitHub 和创建策略是免费的；运行环境计划列在定价页面上。
保存在您由 GitHub 控制的机密工作流中。TradingHost 在运行时通过 GitHub 仓库机密（repository secrets）、环境机密（environment secrets）或您自己批准的机密管理流程来读取它们。TradingHost 不需要托管您的 APCA-API-KEY-ID 和 APCA-API-SECRET-KEY。有关完整的处理模式，请参阅平台机密。
不需要。策略绝不需要提现或资金转移权限。API 密钥只需具备下单和获取市场数据所需的权限范围（scopes）。
可以。TradingHost 支持针对 AI IDE（包括 Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI agent）的基于 MCP 的控制。AI 工具可以检查部署、查看日志、重启策略并管理运行时工作流。MCP 是一个控制和可观测性界面，而非交易执行路径。详见 MCP 控制界面以了解全貌。
可以，只要您将它们视为具有独立凭据（secrets）的独立 TradingHost 策略。Alpaca 的 paper 环境与 live 环境使用不同的基础 URL 和不同的密钥，因此部署在配置上是完全隔离的。同一套源代码可以通过配置不同的环境变量来同时驱动这两者。
不会。PDT 规则（FINRA Rule 4210）由 Alpaca 强制执行，而非 TradingHost。资产低于 25,000 美元的融资融券账户（margin accounts）在进行日内交易时会受到 PDT 限制。您的策略应当查询账户端点并遵循 pattern_day_trader 标志。
不会。您的 1099 表单将在年底由 Alpaca 提供，而非 TradingHost。TradingHost 仅提供运行时；Alpaca 负责处理券商税务申报。
不受保护。SIPC 成员保护覆盖您的 Alpaca 券商账户（最高 500,000 美元，其中包括 250,000 美元现金）。TradingHost 的运行时不受 SIPC 保护，因为 TradingHost 不是券商。
TradingHost 在 EU 和 US-East 区域运行。US-East 距离美股撮合引擎最近，是大多数 Alpaca 策略的自然首选。请参阅区域页面以了解路由和网络邻近度详情。
不会。TradingHost 专注于生产环境的运行时和部署。回测属于您的研究技术栈、框架或 AlgoBuilder。