账户历史与期货读取¶
九个版本化账户读取接口需启用 --enable-desktop-phase2-reads（默认关闭），要求 acc:read 和所选真实业务账户的访问权限。真实后端验证状态为 UNVERIFIED。这些接口用于读取，不执行下单或交易解锁。
| API | CLI | REST POST | MCP |
|---|---|---|---|
GetOrderFillDetails |
get-order-fill-details |
/api/trd/order-fill-details |
futu_get_order_fill_details |
GetOrderDates |
get-order-dates |
/api/trd/order-dates |
futu_get_order_dates |
GetTodayFillStatistics |
get-today-fill-statistics |
/api/trd/today-fill-statistics |
futu_get_today_fill_statistics |
GetFutureSubpositions |
get-future-subpositions |
/api/trd/future-subpositions |
futu_get_future_subpositions |
GetSymbolHistoryOrders |
get-symbol-history-orders |
/api/trd/symbol-history-orders |
futu_get_symbol_history_orders |
GetSymbolHistoryFills |
get-symbol-history-fills |
/api/trd/symbol-history-fills |
futu_get_symbol_history_fills |
GetSubAccountFillQuantities |
get-sub-account-fill-quantities |
/api/trd/sub-account-fill-quantities |
futu_get_sub_account_fill_quantities |
GetSymbolTradeCounts |
get-symbol-trade-counts |
/api/trd/symbol-trade-counts |
futu_get_symbol_trade_counts |
GetFuturePositionBreakdown |
get-future-position-breakdown |
/api/trd/future-position-breakdown |
futu_get_future_position_breakdown |
所有请求必填 extension_version: 1 和 header: {trd_env: 1, acc_id: <account-id>, trd_market: <market>}。使用账户发现结果中的获授权业务账户；不支持聚合父账户和模拟账户。REST body 直接传 C2S 对象，CLI 使用 --c2s-json，MCP 的 c2s_json 参数传 JSON 字符串；Gateway 与 gRPC 使用相同合同。
| API | 其他必填字段 | 可选字段 |
|---|---|---|
GetOrderFillDetails |
order_id, exchange |
— |
GetOrderDates |
year, month (1–12) |
stock_market, jp_acc_type |
GetTodayFillStatistics |
currency |
stock_market, jp_acc_type |
GetFutureSubpositions |
position_id |
— |
GetSymbolHistoryOrders |
security, time_begin_us, time_end_us |
page_size |
GetSymbolHistoryFills |
security, time_begin_us, time_end_us |
page_size |
GetSubAccountFillQuantities |
orders: [{order_id, security_type, exchange}] |
— |
GetSymbolTradeCounts |
security, time_begin_us, time_end_us, period (1/2/3) |
— |
GetFuturePositionBreakdown |
position_id, quote_options: {before, after, overnight} |
— |
security 包含数字 market 和字符串 code；时间范围使用 Unix 微秒。三个报价布尔值必须显式给出，包括 false。period 的 ½/3 分别代表月/季/年。订单和持仓字符串标识须来自实际查询结果；订单元数据只是查询条件，不能授予其他账户的访问权限。
返回值与失败语义¶
订单明细保留完整成交字段及独立的加密资产成交列表。按证券查询的历史订单/成交同时返回实际解析的证券；连续期货在单次请求内固定解析结果。统计返回期间、交易类型元数据和逐日期笔数。订单日期返回账户时区及资产分类。当日成交统计区分请求币种、实际使用的公开币种和服务原始币种。期货子持仓与更丰富的明细是两个显式接口，互不自动替代。
十进制值保留字符串，可选字段保留缺失语义。分页收齐才返回成功：后续页失败、响应损坏或账户会话变化会使整个请求失败。丰富持仓明细要求夜盘权限配置已知。缺少前提时返回错误，不填造数据。后端支持及账户资格仍需真机验证。
currency 使用公开交易币种枚举。stock_market 是此扩展的证券市场编号（如港股 1、美股 2、日股 15），与 header.trd_market、security.market 的枚举空间不同，不能互相代填。省略时按账户已开通市场选择；存在多个日本资产类别而无法唯一选择时须明确市场。jp_acc_type 必须属于所选账户，且不得与 header 中的同名条件冲突。
统计接口对指数和加密资产标的返回空 records，不填期间/交易类型元数据，也不发送统计请求。日期结果不保证仅包含成交日。历史订单/成交的时间范围须为正值且起点早于终点；单次调用自动收齐分页，不能把页内数量当作总数。