财富持仓读取

这些接口查询券商业务账户的基金、债券及结构性票据数据，不执行买入、赎回或资金移动。真实后台尚未验证，扩展数据读取默认启用，可传 --extended-data-reads false 关闭。

操作	REST POST	MCP / CLI
财富持仓	/api/get-wealth-holdings	futu_get_wealth_holdings / get-wealth-holdings
债券持仓列表	/api/get-bond-account-positions	futu_get_bond_account_positions / get-bond-account-positions
基金持仓列表	/api/get-fund-account-positions	futu_get_fund_account_positions / get-fund-account-positions
基金持仓详情	/api/get-fund-position-details	futu_get_fund_position_details / get-fund-position-details

Gateway 与 generic gRPC 使用同名公开协议。MCP/CLI 通过 REST 转发实际调用者身份，需要配置 REST 地址。

输入与权限

普通券商路径的四个请求都需要 extension_version: 1 和完整 header：trd_env: 1、真实业务 acc_id、该账户已获授权的 trd_market。不能使用模拟账户、聚合父账户或借关联关系换成另一业务账户。账户与券商由已验证的账户记录解析，不接受额外 broker_id 或 UID。

前三个接口使用既有 acc:read 与目标账户权限规则。基金详情可能返回完整模块中的其它账户信息，因此必须使用已认证、账户无限制的 acc:read key；任何账户限制（含空列表）均在依赖请求前拒绝。

债券、基金列表限支持该列表的香港/新加坡券商，另外必填 display_currency，表示本次展示选择。可选 filter_currency 和 search 独立；筛选币种为空或缺失表示不选币种筛选，不能拿展示币种替代。支持的币种为 USD、HKD、CNH、JPY、SGD、KRW；不将 CNY 或 RMB 自动改写为 CNH。这些参数不保存或同步其它客户端的显示偏好。

基金详情必填 stock_id。系统使用同一权威静态快照中的原始基金类型与真实基金符号；不能用显示代码猜测。旧缓存尚未回填或缺少这些事实时，返回不可用。基金成本口径由用户已有配置提供，不能用请求字段覆盖；配置变化会使旧的在途结果失效。

返回值与边界

金额、数量、成本和收益等字符串保持原值；平铺持仓、币种分组和标题汇总可能是同一数据的不同展示，不应重复加总，也不会并入普通证券资金快照。接口没有分页参数，不自动翻页。

响应保留字段是否存在、未知状态值和完整模块。业务失败也可携带原始数据，需同时检查外层 ret_type 与实际 error_code。不同接口对缺失状态码的规则不同，不把缺失字段统一补成后台成功。详情缺少实际详情模块时会明确返回失败；模块类型存在而可选 payload 缺失时，保留该缺失状态。

最终后端请求必须小于 1,024,000 字节；REST 还受 JSON 请求大小限制。读取过程中会复核账户、实际调用者、连接、静态事实和成本口径，过期结果不会作为当前视图发布。返回的交易入口或链接仅是数据，不代表获得执行交易的权限。