杠杆外汇账户发现与读取¶
六项读取需要 acc:read，不额外要求 qot:read。若 API key 配置了非空市场限制，必须包含 FX。默认关闭，通过现有实验读取开关启用；真实后端尚未验证。
| REST | MCP / CLI |
|---|---|
POST /api/get-forex-accounts |
futu_get_forex_accounts / get-forex-accounts |
POST /api/get-forex-risk-control |
futu_get_forex_risk_control / get-forex-risk-control |
POST /api/get-forex-symbol-configs |
futu_get_forex_symbol_configs / get-forex-symbol-configs |
POST /api/get-forex-account-quote-context |
futu_get_forex_account_quote_context / get-forex-account-quote-context |
POST /api/get-forex-assets |
futu_get_forex_assets / get-forex-assets |
POST /api/preview-forex-margin |
futu_preview_forex_margin / preview-forex-margin |
所有请求必填 broker_id 和 extension_version: 1。当前源能力覆盖 HK（1001）和 SG（1008）；券商选择必须对应当前已连接、已认证的真实券商。它不授予账户权限。MCP 使用配置的 OpenD REST 地址转发当前 caller；CLI 使用 --rest-url 与 --api-key，JSON 放在 --c2s-json。
先调用账户发现，取得当前 caller 可访问的外汇长账户 account_id。响应区分 common_state、granted_state、known_empty 和批次 revision；不完整或刷新中的旧行仅用于展示，不能作为后续读取资格。明确刷新由 owner 有限地完成；不会自动轮询。不同 caller 的结果分别按当前账户权限过滤；空账户限制集合沿普通读取的既有不限账户语义。
风控读取另需 account_id。保证金预览另需 account_id、stock_id、volume_scaled 和至少一侧非空的 price_buy / price_sell。volume_scaled 是原始无符号整数，一手等于 100000000，零有效；缺失与零不同。价格字符串不转换为浮点数；空侧不发送。证券 symbol 来自同一份当前权威静态记录，不能由调用者填入。
响应保留原始状态、金额字符串、双侧预览和四语言文案的缺省状态。非零业务错误仍保留完整公开响应；内部错误文本不对外反射。缺失金额不补零，不猜币种。后端 Forex 市场编号不映射为公共 TrdMarket=9。
本组接口不下单、不修改 TP/SL、不平仓、不转账，也不代表整个外汇交易链路已开放。账户 metadata 只用于选择，不开放 KYC 或其他账户子项。
资产读取另需 account_id、currency、exclude_zero_positions、use_option_combo、exclude_delisted 和 quote_options。币种接受 USD、HKD、CNH、SGD、JPY、KRW；quote_options 包含 before、after、overnight。六个布尔字段均必填，false 有效。行情档位、夜盘能力与可用解锁凭据来自当前已认证连接和状态，调用者不能覆盖。请求夜盘价格但券商明确不支持时省略该选项；能力未知则拒绝读取。
资产响应包含汇总与分市场资金、现金组合、持仓组、持仓限制及标的保证金，保留字符串精度和字段缺省状态。内部诊断与兼容响应不公开。跨账户引用或请求期间资格、权限、连接变化会导致读取失败；缺少汇总资金也不会返回空成功。当前一次读取不更新普通交易账户资金或持仓缓存。
get-forex-account-quote-context 必填 broker_id、当前外汇 account_id 和 extension_version: 1。返回原始 retcode、group_name、system_mode，保留缺字段、空分组名和未知模式值。成功收到空消息时，三字段可以全为空：这表示未返回上下文，不授予报价或交易资格。读取不设置全局分组、不订阅、轮询或刷新缓存。传输及解码失败仍报错，业务错误保留安全响应数据。
get-forex-symbol-configs 只需 broker_id 和 extension_version: 1，读取已认证券商的原始设置，不触发账户发现。账户受限 key 具有 acc:read 及所需 FX 市场权限即可使用。响应保留八个品种字段、缺省、空串、原始数值、列表顺序和重复项。空成功只表示未返回配置；名单不是交易许可，digits 也不是证券价格精度字段。读取不改变缓存、订阅或配置。
显式凭证管理见 Forex 交易解锁。
共享显示行情¶
常规 Qot_Sub、Qot_GetBasicQot、Qot_GetRT、Qot_GetKL 与 Qot_RequestHistoryKL 可使用证券 market: 81 访问共享外汇行情。需要开启 desktop_phase2_reads，并具备 qot:read；非空市场白名单须包含 FX。这里沿用常规行情请求形状，不需要账户扩展读取的 broker_id、account_id 或 extension_version。
支持 Basic、RT 和现有十五种 K 线周期。Basic、RT 与当前 K 线读取保留原订阅要求；历史 K 线保留原配额规则，不填充实时 K 线缓存。前复权与后复权采用当前含息配置；ETH/ALL 在本共享外汇显示模式下归一为 RTH。当前登录会话决定共享显示上下文，不能将该数据视为账户分组交易报价。
读取、缓存更新、首次推送及连续推送会校验当前来源。需要订阅的读取与原生首次推送还会复核原订阅，防止排队期间退订或重订使旧请求继续生效。原生连接仍需对应推送注册，REST WebSocket 和 gRPC 保留原权限及市场过滤规则。功能默认关闭，真实后台尚未验证。