资格、费率与账户预检¶
八个读取接口使用 --enable-desktop-phase2-reads（默认关闭），均要求 acc:read 和 extension_version: 1。真实后端验证仍为 UNVERIFIED。读取不执行解锁、下单或凭据变更。
| API | CLI | POST | MCP |
|---|---|---|---|
GetOptionComboEligibility |
get-option-combo-eligibility |
/api/trd/option-combo-eligibility |
futu_get_option_combo_eligibility |
GetBrokerOptionStrategies |
get-broker-option-strategies |
/api/trd/broker-option-strategies |
futu_get_broker_option_strategies |
GetTransactionFeePlan |
get-transaction-fee-plan |
/api/trd/transaction-fee-plan |
futu_get_transaction_fee_plan |
GetLegacyFutureFeeConfig |
get-legacy-future-fee-config |
/api/trd/legacy-future-fee-config |
futu_get_legacy_future_fee_config |
GetPremiumEntitlements |
get-premium-entitlements |
/api/trd/premium-entitlements |
futu_get_premium_entitlements |
GetFractionalShareWhitelist |
get-fractional-share-whitelist |
/api/trd/fractional-share-whitelist |
futu_get_fractional_share_whitelist |
GetBrokerTotalAssets |
get-broker-total-assets |
/api/trd/broker-total-assets |
futu_get_broker_total_assets |
GetTradePasswordState |
get-trade-password-state |
/api/trd/trade-password-state |
futu_get_trade_password_state |
REST body 直接传 C2S；CLI 使用 --c2s-json；MCP 通过字符串参数 c2s_json 传入 JSON。Gateway 与 gRPC 使用相同版本合同。未知字段与缺失必填字段会被拒绝。
| API | 除版本外的请求字段 |
|---|---|
GetOptionComboEligibility |
header |
GetBrokerOptionStrategies |
header |
GetTransactionFeePlan |
header, stock_market, security_type |
GetLegacyFutureFeeConfig |
header |
GetPremiumEntitlements |
need_all_access, premium_access (list) |
GetFractionalShareWhitelist |
header |
GetBrokerTotalAssets |
broker_id, price_options {before, after, overnight} |
GetTradePasswordState |
header |
header 选择真实业务账户，包含 trd_env: 1、非零 acc_id、trd_market；可选 jp_acc_type 必须属于已知日本子账户。所选账户必须在调用密钥的授权范围内。三个价格布尔值必须全部给出，包括显式 false。
返回与边界¶
- 账户期权资格与券商策略配置是不同结果：券商支持某策略不代表账户有资格。期权等级缺失与等级零不同。券商策略配置可在所选券商连接不可用时通过已认证平台会话读取。
- 费率方案完整保留普通、分段、特殊配置、依赖、精度、取整、生效期和金额字符串。
stock_market支持 ½/⅘/6/9，security_type支持 1–7，属于本费率接口的枚举空间。账户路由支持香港、美国、新加坡、澳大利亚；未知账户市场映射明确报错。CRM 员工身份不公开。 - 历史期货费用配置是历史数据入口：新加坡请求走新加坡，其余所选券商走香港。必须检查
requested_broker与effective_broker，不能据此认为香港费率适用于所选券商。未知佣金类型字符串、所有金额精度原样保留。 - Premium 中
need_all_access=true查全部权益（列表必须为空），false 按premium_accessID 列表选择。items是本次有效结果，session_known_items还包括本认证会话此前查过的权益。权限缺失不等于 false；UI 跳转 ID 不是 URL。该状态不授予行情或交易权限，身份/会话变更后失效。 - 碎股白名单依赖动态配置；缺券商客户身份或配置不支持时明确失败。未知证券 ID 也保留，不因本地暂未识别而丢弃。
- 券商总资产涵盖所选券商下全部业务账户。带账户白名单限制的密钥会被拒绝，即使其中一个账户已获授权。
broker_id：香港 1001、美国 1007、新加坡 1008、澳大利亚 1009、日本 1012、马来西亚 1017、加拿大 1019。返回总值、证券及币种分布；管理员属性和废弃账户分布不公开。比例字符串"0.32"表示 32%；夜盘价格要求已知券商配置及显式选择。 - 交易密码状态只报告密码是否存在及可选的六位数属性，不报告 token 状态，也不验证或修改密码。
预检附加结果¶
PreviewOrderImpact 保留原 --enable-v18-experimental-reads 开关，以及保证金、风险、费用三个 sidecar。额外启用 --enable-desktop-phase2-reads 后返回可选的 short_tips，具有独立状态、错误码和三个可选布尔值：is_naked_short、is_buy_splitting_combo、is_sell_splitting_combo。失败不抹去原三项；响应始终 estimate_only=true，不能作为下单许可。
新查询用于具备实际数量、符合条件的港美股票/期权场景。加密资产、不支持的券商/账户类型、期货期权、仅金额下单，或组合缺少唯一权威正股关系时，此项返回 Unsupported。数量字符串和改单订单标识保留原意；缺失或失败的风险结果不能当作 false。