Flex Web Service 总览

Flex Web Service 用于通过 API 下载 IBKR 报表。它适合做流水同步、成交复盘、审计、税务和长期账户分析。

它不是行情接口，也不是下单接口。它读取的是 Client Portal 中配置好的 Flex Query 报表。

官方参考：Flex Web Service

核心概念

概念	中文说明
Flex Token	在 Client Portal 中启用 Flex Web Service 后生成的访问令牌。
Query ID	某个 Flex Query 的编号，决定报表内容。
Reference Code	生成报表后返回的引用码，用来下载报表。
Format	报表格式，常见为 XML。

典型流程

在 Client Portal 启用 Flex Web Service
    -> 创建 Flex Query
    -> 复制 Token 和 Query ID
    -> SendRequest 生成报表
    -> GetStatement 下载报表
    -> 解析 XML/CSV

适合读取什么

数据	说明
Trades	成交记录。
Orders	订单信息。
Cash Report	现金流水。
Positions	持仓。
Fees	手续费。
Audit Trail	审计追踪字段。

安全提醒

Flex Token 能读取报表数据，属于敏感凭据。不要放进页面展示、公开仓库、前端代码或未经脱敏的日志。服务器使用时应放在环境变量或密钥管理系统里。

文档示例使用 YOUR_FLEX_TOKEN、YOUR_QUERY_ID 等示例变量。真实调用时，把它们替换为自己在 Client Portal 中生成的 Token 和 Query ID；返回的报表内容可能包含账户、成交、现金流水和税务信息，保存与展示前应先做脱敏。