阅读时间 … 分钟

适用于 Interactive Brokers 策略的 AI 原生运行时

在 Cursor、Claude Code 或任何 AI IDE 中编写策略。从 GitHub 部署至托管云端运行时，享有原生 MCP 控制、日志及区域选择支持。

由 TradingHost 工程团队撰写

第 01 部分 · 一览

一览

经纪商
Interactive Brokers LLC (Interactive Brokers Group, NASDAQ: IBKR)
经纪商类型
受美国监管的多资产经纪商，面向零售与机构客户
资产类别
美国及国际股票、期权、期货、外汇、债券、ETF、共同基金、加密货币、差价合约（非美国地区）
资产覆盖范围
美股（NYSE、NASDAQ、NYSE ARCA、BATS、IEX）及遍布 33 个国家、150 多个市场的国际股票。美国期权（OCC 清算的股票及指数期权）和期货期权。CME Group、ICE、Eurex、HKEX、OSE、SGX 等交易所的期货及期货期权（FOP）。现货外汇（100 多个货币对，IDEAL FX 网络）。债券：美国国债、美国地方政府债、美国企业债、国际政府及企业债。ETF 及共同基金。加密货币交易（美国客户通过合作平台交易；非美国客户通过独立的 IBKR 实体交易）。非美国实体的差价合约（CFD）及权证。结构性产品。
运行环境模式
容器化策略运行时
部署源
GitHub
编程语言
任何可在容器中运行的语言
常用集成
TWS API (ibapi 官方 Python, ib_insync, ib_async), Client Portal API (REST + OAuth2), Web API, FIX (机构), NautilusTrader, Backtrader, 自定义连接器
AI 工作流集成
适用于 Cursor、Claude Code、GitHub Copilot 及 CLI 智能体的 MCP 控制面板
TradingHost 角色
运行时、部署、日志、健康检查、区域选择、MCP 控制
Interactive Brokers 角色
经纪商账户、API 接入、市场数据、执行场所、托管、清算、税务申报、保证金管理
监管机构
Interactive Brokers LLC：SEC 和 FINRA 注册经纪交易商（CRD 36418），CFTC/NFA 注册期货佣金商及外汇交易商会员（NFA ID 0258600）。SIPC 会员，并通过 Lloyds 提供超额保险。集团旗下实体还受 FCA（英国）、CIRO（加拿大）、ASIC（澳大利亚）、SFC（香港）、MAS（新加坡）、CBI（爱尔兰）等机构监管。
美国零售客户
支持。包含模拟交易（Paper trading）账户。
隶属关系
TradingHost 保持独立，与 Interactive Brokers LLC 或 Interactive Brokers Group, Inc. 无任何关联。

章节 02 · IBKR 提供的服务

Interactive Brokers 提供的服务

Interactive Brokers 提供了三种不同的 API 接口（TWS API、Client Portal API、Web API）以及机构级 FIX。使用同一个账户凭证即可交易美国及国际股票、期权、期货、外汇、债券、ETF、共同基金、加密货币，以及非美国实体的差价合约。这三种 API 接口的功能范围存在实质性差异，选择合适的接口是策略设计的重要一环。

市场与策略模式

  • 跨股票、期权和期货的多资产投资组合
  • 通过 SmartRouting 在 150 多个市场执行国际股票策略
  • CME、ICE 和 Eurex 期货及期货期权自动化
  • 基于 100 多个货币对的 IDEAL FX 现货策略
  • 结合波动率曲面和希腊字母（Greeks）的美国期权策略
  • 投资组合保证金及跨资产保证金管理流程
  • 用于并行无风险测试的模拟交易账户

API 接口

产品接口
Interactive Brokers 提供三种不同的 API 接口：TWS API（套接字协议，需要本地运行 Trader Workstation 或 IB Gateway 进程）、Client Portal API（REST + WebSocket，采用 OAuth 2.0 认证）以及 Web API（较新的 REST 接口）。针对机构客户提供 FIX 接口。每个接口的功能差异显著，请根据具体策略进行选择。
连接方式
TWS API 使用 TCP 套接字连接到正在运行的 TWS 或 IB Gateway 实例，TWS 的端口为 7496/7497（实盘/模拟），IB Gateway 的端口为 4001/4002（实盘/模拟）。Client Portal API 是基于 api.ibkr.com 的 HTTPS REST 和 WebSocket。Web API 是 HTTPS REST。封装库包括：官方的 ibapi (Python)、社区的 ib_insync，以及持续维护的 ib_async 分支。
身份验证
TWS API：策略连接到本地运行的网关，该网关由账户持有人进行交互式身份验证。Client Portal API：使用消费密钥（consumer key）和刷新令牌（refresh tokens）的 OAuth 2.0 认证。Web API：使用 REST 令牌。模拟交易使用与实盘独立的凭证和账号。

具体细节请参考 Interactive Brokers

具体端点、速率限制、账户最低余额、期权批准等级、市场数据订阅以及各市场的佣金标准，请参阅 Interactive Brokers 的官方文档。请以官方文档为准。

第 03 部分 · 使用 AI 构建

借助 AI 构建您的 IBKR 策略

选择一种集成方式（需要最完整功能请选 TWS API，无需本地网关的纯云端部署请选 Client Portal API），派生（fork）一个起步模板，然后在 AI IDE 中编写您的策略。Cursor、Claude Code、GitHub Copilot 以及基于 CLI 的 AI 智能体均支持相同的 GitHub 原生部署流程。

  • TWS API (套接字)

    IBKR 的旗舰 API。功能最完整，但需要策略连接到本地运行的 TWS 或 IB Gateway 进程。Python 推荐使用 ibapi（官方）或 ib_async（社区基于 asyncio 对 ib_insync 进行维护的分支）。

    tws-api on GitHubib_async on GitHub

  • Client Portal API (REST)

    基于 OAuth 2.0 认证的 REST 加 WebSocket 接口。虽然功能比 TWS API 稍轻量，但无需本地网关，更适合纯云端部署。

  • Web API (REST)

    IBKR 较新的 REST 接口。目前功能是 TWS API 和 Client Portal 的子集，覆盖范围正在不断扩大。

  • 框架或自定义连接器

    NautilusTrader、Backtrader、QuantConnect 以及自研引擎均对 TWS API 接口进行了封装。请根据您已使用的框架进行选择。

适用于 IBKR 产品的库与框架支持

ibapi 和 ib_async 覆盖了完整的 TWS API 接口，这是 IBKR 功能最强大的接口集。Client Portal API 牺牲了部分高级订单类型，以换取更适合云端部署的 REST + OAuth2。框架适配器（如 NautilusTrader、Backtrader）均封装了底层的某一接口，其功能取决于所封装的底层接口。

库或框架美股国际股票期权期货外汇
ibapi (official Python)支持支持支持支持支持
ib_async (community fork)支持支持支持支持支持
Client Portal API支持部分支持支持支持支持
NautilusTrader (IBKR adapter)支持部分支持部分支持支持支持
Backtrader (IB store)支持部分支持部分支持支持部分支持

✓ 表示根据相关库或适配器文档确认支持。“partial” 表示部分支持；在实际使用前，请务必对照该集成的最新文档进行核对。

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

使用 AI 编写

ibapi、ib_async 和 Client Portal API REST 客户端均可与 AI IDE 协同工作。TradingHost 的 MCP 控制面实现了闭环：AI 工具可以与您一同检查部署、查看日志并管理运行环境，但绝不会触及交易执行路径。

Section 04 · 在 TradingHost 上运行

在 TradingHost 上运行您的代码

Interactive Brokers 提供经纪商账户、API 访问权限和执行场所。TradingHost 则提供运行您连接至 IBKR 的策略的生产环境。

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

您

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

TradingHost

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

部署流程

  1. 步骤 01

    连接 GitHub

    授权 TradingHost 访问您的 GitHub 账户。

  2. 步骤 02

    关联代码库或从模板开始

    将 TradingHost 指向您现有的 IBKR 策略仓库，或者 fork 一个 ibapi 或 ib_async 模板作为可运行的基础起点。

  3. 步骤 03

    部署到 TradingHost 容器中

    选择一个区域（US-East 距离美股和 CME 期货撮合引擎最近；EU 是欧洲交易时段策略和 Eurex 期货的理想选择），提供您的 IBKR 凭据和网关配置作为环境变量，然后进行部署。TradingHost 会从代码仓库构建您的容器，并在托管的 Kubernetes 基础设施上运行您的策略。需要本地 IB Gateway 进程的 TWS API 策略可以将该网关作为 sidecar 运行；Client Portal API 和 Web API 策略则不需要网关。

  4. 步骤 04

    监控日志与健康状况

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

  5. 步骤 05

    更新与重新部署

    将更改推送至您的 GitHub 主分支，TradingHost 会自动重新部署。在升级到实盘密钥之前，使用模拟账户密钥的部署是天然的测试环境。

部署

Section 05 · 运维说明

Interactive Brokers 运维说明

在容器化云运行环境中实际运行 Interactive Brokers 策略时容易踩到的坑，这些内容并不总是出现在 IBKR 的文档或框架的 README 中。以下每条陈述均引用或改写自 Interactive Brokers 官方文档或主要监管机构来源；部署侧的指南则源自于在 TradingHost 上运行这些策略的实际经验。

  1. 01 · 三种 API 接口

    TWS API、Client Portal API 和 Web API 无法互换

    Interactive Brokers 提供了三种不同的程序化接口。TWS API 是 ibapi 和 ib_async 使用的套接字协议，需要策略连接到正在运行的 TWS 或 IB Gateway 进程。Client Portal API 是基于 REST 加 WebSocket 并结合 OAuth 2.0 的接口，不需要本地网关。Web API 是一个较新的 REST 接口，目前覆盖的功能较窄。请在策略设计阶段选择好接口；在部署中途切换意味着重写代码，而不仅仅是修改配置开关。

    来源Interactive Brokers API portaltws-api on GitHub

  2. 02 · TWS 本地网关

    TWS API 需要策略连接到本地运行的 TWS 或 IB Gateway 进程

    TWS API 是一种套接字协议，它连接到本地运行的 TWS (Trader Workstation) 或 IB Gateway 实例，TWS 的端口为 7496 或 7497，IB Gateway 的端口为 4001 或 4002（分别对应实盘和模拟盘）。对于纯云端部署，既可以将 IB Gateway 作为 sidecar 容器与策略一同运行，也可以改用 Client Portal API。这个“本地”网关可以运行在同一个 TradingHost 容器中，也可以运行在同一个 Kubernetes pod 的相邻容器中。

    来源IB Gateway documentation

  3. 03 · 模拟账户

    模拟交易使用独立的账号和凭据

    Interactive Brokers 的模拟交易是通过一个独立的账号提供的，而不是通过不同的环境 URL。用户使用模拟盘凭据登录 TWS 或 IB Gateway，网关随后连接到模拟服务。模拟盘和实盘之间的策略代码没有变化，但网关配置和 API 连接（端口和账户 ID）会有所不同。请将模拟盘和实盘凭据保存在不同的 TradingHost Secrets 条目中。

    来源Paper trading account, IBKR docs

  4. 04 · Pattern Day Trader

    根据 FINRA Rule 4210，PDT 适用于资产低于 $25,000 的保证金账户

    根据 FINRA Rule 4210，如果保证金账户在五个工作日内进行了四次或更多次日内交易，则会被标记为 Pattern Day Trader，并限制进一步的日内交易，直到资产达到 $25,000。Interactive Brokers 在保证金账户上强制执行此规则。现金账户不受 PDT 限制，但受结算周期约束（自 2024-05-28 起美股实行 T+1 结算）。请围绕此限制规划您的部署。

    来源IBKR PDT documentationFINRA Rule 4210

  5. 05 · 期权交易权限

    期权交易权限按账户授予，且与股票交易权限相互独立

    在 IBKR 上进行期权交易，除了开户之外，还需要单独的审批步骤。批准的权限级别控制着经纪商接受哪些期权策略：最低级别为备兑看涨期权（covered calls）和现金担保看跌期权（cash-secured puts），最高级别为无担保空头期权（uncovered short options）。超出批准级别的订单将在经纪商端被拒绝，而不是在 TradingHost 端。请围绕您已获批的级别规划策略，或在部署前向 IBKR 申请升级权限。

    来源IBKR options trading permissions

  6. 06 · 市场数据

    行情数据订阅按市场收费，默认不捆绑

    Interactive Brokers 按市场收取行情数据订阅费（例如 US NASDAQ depth、NYSE OpenBook、OPRA US options、CME futures、LSE depth 等）。查询未订阅市场数据的策略会收到延迟报价或空响应。在部署依赖特定市场实时数据的策略之前，请在用户门户中设置好数据订阅。

    来源IBKR market data subscriptions

  7. 07 · SmartRouting

    默认使用 SmartRouting；直接路由需逐笔订单指定

    Interactive Brokers 默认通过 SmartRouting 路由订单，该功能会选择扣除佣金后显示价格最佳的交易场所。若要进行直接路由，请在订单上指定交易所参数。SmartRouting 会影响成交、延迟和交易所费用返还；依赖特定交易场所交互的策略必须选择直接路由。

    来源IBKR SmartRouting overview

Section 06 · 适用对象

适用对象

TradingHost Interactive Brokers 运行环境最适合：

  • 在 AI IDE（Cursor、Claude Code）中构建策略的开发者
  • 多资产系统化交易员
  • 期权与期货策略运营者
  • 从 notebook 转向生产环境的量化开发者
  • 国际股票与外汇策略编写者

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

Section 08 · 常见问题

常见问题

不。TradingHost 是独立的，不隶属于 Interactive Brokers LLC 或 Interactive Brokers Group, Inc.

不是。TradingHost 是交易策略代码的运行环境。Interactive Brokers LLC 是经纪自营商，在 SEC 和 FINRA (CRD 36418)、CFTC 和 NFA (NFA ID 0258600) 注册，并且是 SIPC 成员，通过 Lloyds 提供超额保险。您的账户、托管、市场准入、结算、保证金和税务申报均由 Interactive Brokers 负责。

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

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

TWS API（通过 ibapi 或 ib_async）具有最广泛的功能覆盖，但需要本地运行 TWS 或 IB Gateway 进程。Client Portal API 是 REST 加 OAuth 2.0，不需要本地网关，因此对于纯云端部署来说更为简单。如果您的策略需要高级订单类型、实时期权希腊字母（Greeks），或者仅在 TWS 套接字协议中公开的功能，请使用 TWS API 并将 IB Gateway 作为 sidecar 运行。如果 REST 能够满足需求，建议优先选择 Client Portal API，因为它的部署结构更简单。

如果选择 TWS API，则需要。IB Gateway 是一个轻量级的 Java 应用程序，它向 IBKR 进行身份验证并公开一个本地套接字供策略连接。在 TradingHost 上，您可以将 IB Gateway 作为 sidecar 进程与策略运行在同一个 Kubernetes pod 中，或者改用 Client Portal API，从而免去对网关的依赖。

可以，但须获得 IBKR 的期权交易批准。期权交易权限按账户授予，且与股票交易权限相互独立；批准的级别控制着经纪商接受哪些策略。TradingHost 不会绕过期权审批流程。

可以，但须获得 IBKR 的期货账户批准。由于 CFTC 和 NFA 的要求，期货交易在开户之外还需要单独的审批步骤。

ibapi 是来自 Interactive Brokers 官方的 Python 封装库，直接反映了套接字协议。ib_insync 曾是一个对 asyncio 友好的社区封装库，但其原作者已将其标记为不再积极维护。ib_async 是 ib_insync 的社区分支，目前仍在持续发布更新。对于新策略，请使用 ibapi 或 ib_async；对于现有的 ib_insync 代码，由于 API 大致兼容，建议规划迁移至 ib_async。

连接包含策略代码的 GitHub 仓库，将其与 TradingHost 关联，然后进行部署。建议使用绑定模拟账户密钥的部署作为测试环境，待策略稳定后再切换为实盘密钥。关联 GitHub 和创建策略是免费的；运行环境方案详见定价页面。

保存在由您掌控的 GitHub secrets 工作流中。TradingHost 在运行时通过 GitHub 仓库 secrets、环境 secrets 或您自己认可的密钥管理流程来读取它们。TradingHost 不需要托管您的 IBKR 用户名、密码或 Client Portal OAuth 令牌。有关完整的处理模式，请参阅平台 secrets 说明。

不需要。策略绝不需要提现或资金划转权限。凭据只需具备下单和获取市场数据所需的权限范围即可。

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

不会。PDT 规则（FINRA Rule 4210）由 Interactive Brokers 强制执行，而非 TradingHost。资产低于 25,000 美元的保证金账户在进行日内交易时会受到 PDT 限制。您的策略应当遵循券商在账户上设置的 PDT 标记。

不会。您的 1099 表单将在年底由 Interactive Brokers 提供，而非 TradingHost。TradingHost 仅提供运行环境；券商税务申报由 IBKR 负责。

不受。SIPC 成员保护为您的 IBKR 券商账户提供最高 500,000 美元（包括 250,000 美元现金）的保障，此外 IBKR 还通过 Lloyds 提供了额外的超额保险。TradingHost 的运行环境不受 SIPC 保护，因为 TradingHost 不是券商。

TradingHost 在 EU 和 US-East 区域运行。US-East 距离美股和 CME 期货撮合引擎最近，是大多数 IBKR 美国策略的理想选择。EU 区域则适用于欧洲交易时段策略和 Eurex 期货。请参阅区域页面以获取路由和物理距离的详细信息。

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