盈透证券 Flex Query 设置教程

Flex Query 适合谁

如果你只是偶尔复盘，手动导出 Activity Statement XML 就够了。如果你希望每天自动更新净值、持仓、交易、股息、费用和税务视图，就应该设置 Activity Flex Query。

设置步骤

1. 登录 IBKR Client Portal，进入 Reports 或 Performance & Reports。
2. 找到 Flex Queries，新建一个 Activity Flex Query。
3. Format 选择 XML，Delivery 不需要发邮件，保留在线查询即可。
4. Sections 勾选交易、持仓、现金流水、股息、费用、汇率、NAV、公司行动、期权行权/到期等字段。
5. 保存后记录 Query ID。
6. 到 Flex Web Service 设置里启用 Token，把 Token 和 Query ID 填进 IB Dashboard。

Token 和 Query ID 是什么

Query ID 决定“拉哪一份报表模板”，Token 决定“这个请求有没有权限”。它们都应该当成敏感信息保存，不要发到微信群、截图或公开仓库里。建议只放在 IB Dashboard 的加密配置里，并定期轮换。

推荐 section 模板

中文用户最容易漏掉的是 Withholding Tax、Statement of Funds、Currency Conversion Rates、Transaction Fees 和 Options Exercises/Assignments/Expirations。漏掉这些字段，IBKR 股息税、摊薄成本、期权 Wheel、汇率影响和费用侵蚀就会不完整。

自动同步的注意点

• IBKR 报表通常不是实时行情，它更适合做日终复盘。
• 第一次同步建议拉长历史范围，比如 12 个月或更久，否则成本分析不完整。
• 如果你有多个账户，最好每个账户确认 base currency 和 query 覆盖范围。
• 如果 Token 失效，IB Dashboard 会提示重新配置，不要把错误当成数据丢失。