闲钱配置与赎回额度¶
两个接口只读,要求 acc:read、extension_version: 1 和 --enable-desktop-phase2-reads。默认关闭;真实后端未验证(UNVERIFIED)。读取不会开通、暂停或修改服务,也不执行申购、赎回。
| API / CLI | REST POST |
|---|---|
GetCashSweepConfiguration / get-cash-sweep-configuration |
/api/trd/cash-sweep-configuration |
GetCashSweepRedemptionCapacity / get-cash-sweep-redemption-capacity |
/api/trd/cash-sweep-redemption-capacity |
配置¶
请求提供非零原始 broker_id。个人/机构类型由当前会话已确认的客户事实决定,调用者不提供这个开关。配置是该券商客户范围的聚合读取:API key只要配置了 allowed_acc_ids(包括空数组)就会拒绝,且不会先请求后台数据。
响应 is_company 指明分支,personal 与 institutional 只填相应一项。分支保留可选 err_code、has_activated、subscription_notice_text_id 及完整 config_list。机构配置还包含账户所有者信息,只供已授权的聚合读取使用。
每个配置保留账户标识、申购配置列表及赎回配置。申购配置包含币种、基金描述、保留金额、状态、暂停截止时间及最大可买金额;基金描述包含名称、代码、收益类型、原始收益值和日均万元收益。金额/收益字符串原样返回,数字状态不简化为布尔值。has_activated 缺失代表没有该字段,不等于后台明确返回false。
额度¶
请求提供真实业务子账户的 header:trd_env: 1、acc_id 和 trd_market。综合账户需选择其具有基金业务能力的真实证券业务子账户;不得把综合父ID当作业务ID。不要求交易解锁。API key账户范围按原公开账户ID规则检查。
响应保留 err_code、status、supported_ccy,及每币种的 ccy、amount、redeemable_amount、pending_redeem_amount。amount 已包含在途部分,不再相加;这些数据也不会再次计入已有总资产。
资产变化会使对应内部额度快照失效;显式读取查询后台后才更新,不把旧快照作为当前成功结果。传输、业务码或解码失败会返回错误,不伪装为空配置或零额度。API不自动执行资金业务。
MCP工具:futu_get_cash_sweep_configuration、futu_get_cash_sweep_redemption_capacity;参数使用 c2s_json 和可选 api_key。Gateway、CLI、REST、MCP、gRPC共用协议与权限合同。