财富持仓读取

这些接口查询券商业务账户的基金、债券及结构性票据数据，不执行买入、赎回或资金移动。真实后台尚未验证，Desktop Phase 2 读取开关默认关闭。Native Bank 的独立读取合同见下文。

操作	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 请求大小限制。读取过程中会复核账户、实际调用者、连接、静态事实和成本口径，过期结果不会作为当前视图发布。返回的交易入口或链接仅是数据，不代表获得执行交易的权限。

Native Bank 读取

启用 Native Bank 来源及对应读取开关后，财富持仓、基金持仓列表和基金详情使用该来源的已验证账户。此路径仍未经过真实后台验证。债券持仓列表不适用于 Native Bank；财富持仓响应中的债券、票据数据仍按原始字段返回。

Native Bank 的三个读取都要求已认证、账户无限制的 acc:read key。header.acc_id 必须是当前已验证账户的有效非零标识，trd_market 为该账户当前开放的香港、美国或基金市场；不能通过任意数字标识取得访问权限。

财富持仓与基金列表必须提供 native_bank_selection，包含 currency 与完整 valuation_options。例如基金列表：

{
  "currency": "USD",
  "valuation_options": {
    "currency": "USD",
    "use_before_price": false,
    "use_after_price": false,
    "use_overnight_price": false,
    "use_option_combo": false
  },
  "show_zero_qty": false
}

所选银行币种使用 CNY，证券估值币种使用 CNH。银行币种接受 HKD、USD、CNY、EUR、JPY、GBP、CAD、AUD、NZD、SGD、CHF；估值币种将 CNY 换为 CNH，并接受 MYR、KRW。行情等级与实际隔夜报价权限由当前来源提供，不能通过请求覆盖。

基金列表的 display_currency 必须与所选银行币种一致（展示 CNH 对应银行 CNY）。filter_currency 单独筛选持仓原始币种；search 仅在 ISIN 与基金全名中作不区分 ASCII 大小写的子串查找。show_zero_qty 必填；设为 false 时按来源的高精度数量判断过滤，极小的非零文本也可能视为零。财富持仓返回完整基金、债券及票据持仓，必须省略 show_zero_qty。这些参数不会保存到其它客户端。

此路径通过可选 s2c.bank_positions 与 s2c.bank_assets 返回完整类型化数据，保留原始数量、金额文本与字段缺失。它们不构造界面模块、分组或汇总；Native Bank 基金列表的 module_data_list 为空，财富持仓的旧平铺字段为空。基金详情继续使用既有详情响应结构。旧券商路径省略这两个新增字段。