SmarterWheelSmarterWheel
返回文章列表
如何开始

如何连接 IBKR Flex Query API

创建 Activity Flex Query 并填入 Flex Web Token 和 Query ID，即可自动同步账户数据。

Options Insight•2026年8月13日•更新于 2026年9月1日•约 3 分钟阅读
如何连接 IBKR Flex Query API

创建 Activity Flex Query 并填入 Flex Web Token 和 Query ID 后，本站即可自动同步账户资产、持仓、成交和资金流水。

Flex Token 是敏感凭证，请勿发送给他人或提交到代码仓库。本站会在服务端加密存储，页面仅显示脱敏值。

第一步：创建 Activity Flex Query

登录 IBKR Client Portal，进入 Performance & Reports → Flex Queries。

使用 Configure with AI（推荐）

IBKR 现在可以根据自然语言直接生成 Flex Query。点击 Configure with AI，粘贴以下提示词：

Create an Activity Flex Query in XML format for syncing account cash,
cash transactions, daily NAV, open positions, trades, and transfers.
Include the account, currency, report date, position, option contract,
P/L, commission, cash flow, and FX-to-base fields needed for each section.

生成后，将 Sections 和 Fields 与下表核对，补齐缺失字段再保存。AI 生成结果可能会有遗漏，下表配置为准。

手动配置

如果账户暂无 Configure with AI，也可以手动创建：

  1. 在 Activity Flex Query 区域点击加号。
  2. 输入名称，例如 Smarterwheel Sync。
  3. 在 Sections 中添加以下六项，并选择对应 Fields。
SectionFields
Cash ReportAccount ID、Currency、Starting Cash、Ending Cash、Ending Settled Cash、To Date、From Date
Cash TransactionsAccount ID、Currency、Date/Time、Amount、Type、Report Date、FX Rate To Base
Net Asset Value (NAV) in BaseAccount ID、Currency、Report Date、Cash、Stock、Options、Total
Open PositionsAccount ID、Currency、Asset Class、Symbol、Expiry、Put/Call、Quantity、Mark Price、Position Value、Open Price、Cost Basis Price、Unrealized P/L
TradesAccount ID、Currency、Expiry、Date/Time、Put/Call、Quantity、TradePrice、IB Commission、Realized P/L、Buy/Sell、Asset Class、Symbol、Underlying Symbol、Strike、Net Cash、Open/Close Indicator、Close Price
TransfersAccount ID、Currency、FX Rate To Base、Report Date、Type、Direction、Cash Transfer

配置完成后，Sections 应与下图一致：

IBKR Flex Query Sections 配置结果

在 General Configuration 中将 Format 设为 XML。首次同步建议选择最近 365 天；如果数据量过大，可以先缩短到最近 30 天。

保存 Query 后，回到 Flex Queries 列表并记下数字 Query ID。Query 名称不是 Query ID。

第二步：生成 Flex Web Token

  1. 在 Client Portal 打开 Settings。
  2. 进入 Account Reporting → Flex Web Service。
  3. 启用服务，设置有效期并生成 Token。
  4. 立即保存生成的 Flex Web Token。

Token 可能只完整显示一次。若遗失或过期，请在 IBKR 重新生成。

第三步：连接并同步

回到本站：

  1. 打开账户菜单，进入 券商连接。
  2. 点击 配置 IBKR。
  3. 填写 Flex Web Token 和数字 Query ID。
  4. 点击 保存配置，然后点击 立即同步。

同步成功后，页面会显示账户概览、当前持仓、交易历史和收益日历。

常见问题

Token 或 Query ID 无效

确认使用的是 Flex Web Service Token，而不是 IBKR 登录密码；同时检查 Token 是否已激活、过期或包含多余空格。

没有持仓或资产数据

检查 Query 是否包含上面的六个 Sections 和 Fields，保存后重新同步。

收益日历把入金算成盈利

重点检查 Cash Transactions 中的 Amount、Type、Report Date、FX Rate To Base，以及 Transfers 中的 Direction 和 Cash Transfer。

第一次同步超时

将 Query 周期缩短到最近 30 天，等待几分钟后重新同步。成功后再逐步扩大周期。