REST API 接口目录¶

本页由当前 REST 路由清单自动生成，按业务分类列出接口与示例。

本页涵盖 futu-opend REST API 323 个公开 endpoint, 按功能分 15 组。本页提供路由目录、部分字段说明与请求示例，不是完整字段 schema。参数与返回值以各接口字段表及链接的专页合同为准。目录包含：

HTTP 方法 + URL
Backend proto_id
需要的 scope (auth)
部分接口的字段表及合同链接
错误提示
curl 示例

快速导航:

组	Endpoint 数	链接
系统 / 状态	8	系统 / 状态
行情订阅	5	行情订阅
行情查询	36	行情查询
板块 / 筛选 / 元数据	21	板块 / 筛选 / 元数据
参考资料 / 衍生品	74	参考资料 / 衍生品
市场排行 / 情绪	13	市场排行 / 情绪
新闻 / 公告	12	新闻 / 公告
日历 / 宏观经济	11	日历 / 宏观经济
机构 / 持仓研究	11	机构 / 持仓研究
自选股 / 私有备注	6	自选股 / 私有备注
到价 / 事件提醒	12	到价 / 事件提醒
交易账户	68	交易账户
交易写入	31	交易写入
量化策略 / 云同步	12	量化策略 / 云同步
管理 (admin)	3	管理 (admin)

全局约定¶

Legacy read-only Base URL: http://127.0.0.1:22499（本页假设显式设置 --rest-port 22499；REST listener 需配置端口后才启用）。未配置 keys file 时，兼容模式的无凭据只读请求可继续使用 HTTP：
```
curl http://127.0.0.1:22499/health
```
Scope mode Base URL: https://127.0.0.1:22499。配置 rest_keys_file 会启用 REST scope mode，并要求同时配置 rest_tls_cert 与 rest_tls_key。daemon 会在 broker 登录前校验证书和私钥，拒绝在明文 HTTP 上绑定带鉴权的 REST。下方 HTTPS 示例要求证书匹配 URL 的主机名/IP，且签发 CA 已受 curl 信任；使用自有 CA 时，在 curl 命令中添加 --cacert /path/to/ca.pem。
WebSocket: scope mode 下同一 listener 的 /ws 使用 wss://127.0.0.1:22499/ws；legacy 无 key 兼容模式仍可使用 ws://。
Content-Type: application/json
Auth: Authorization: Bearer <API_KEY> (若配了 keys.json; 否则 legacy 模式无 auth — 且 v1.4.86 起为生产 fail-closed 默认)

响应结构:

{
  "ret_type": 0,
  "ret_msg": null,
  "err_code": null,
  "s2c": { ...业务数据... }
}

ret_type == 0 为成功, 其他值参见常用错误码.

字段与枚举：使用各接口说明中的字段名。别名与 enum 表示以各接口字段表及链接合同为准；整数枚举请传 JSON 数字，只有明确列出字符串取值的字段才使用字符串。例如 /api/ipo-list 的 market 接受该接口列出的整数或字符串。
限额: 启动参数 --allowed-markets / --max-order-value 等控制. 详见鉴权与限额.

系统 / 状态¶

系统状态、健康检查及认证验证。健康检查为 public；其他接口的 scope 与本地调用要求见各接口说明。

`GET /api/delay-statistics`¶

proto_id: GET_DELAY_STATISTICS (1007)

Scope: legacy/public: —; scope-mode: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/delay-statistics

`POST /api/delay-statistics`¶

proto_id: GET_DELAY_STATISTICS (1007)

Scope: legacy/public: —; scope-mode: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"type_list":[1],"qot_push_stage":1}' \
  https://127.0.0.1:22499/api/delay-statistics

`GET /api/global-state`¶

proto_id: GET_GLOBAL_STATE (1002)

Scope: legacy/public: —; scope-mode: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/global-state

`GET /api/ping`¶

proto_id: GET_GLOBAL_STATE (1002)

Scope: legacy/public: —; scope-mode: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/ping

`GET /api/push-subscriber-info`¶

proto_id: — (non-proto / 无 backend 转发)

Scope: legacy/public: —; scope-mode: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/push-subscriber-info

`GET /api/quote-rights`¶

proto_id: TEST_CMD (1008)

Scope: legacy/public: —; scope-mode: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/quote-rights

`GET /api/user-info`¶

proto_id: GET_USER_INFO (1005)

Scope: legacy/public: —; scope-mode: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/user-info

`POST /api/verification`¶

proto_id: VERIFICATION (1006)

Scope: auth:setup

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"type":1,"op":1}' \
  https://127.0.0.1:22499/api/verification

行情订阅¶

订阅 / 取消订阅行情推送，查询订阅状态。WebSocket /ws 接收推送。三个接口都归 qot:read。

`POST /api/query-subscription`¶

proto_id: QOT_GET_SUB_INFO (3003)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"is_req_all_conn":true}' \
  https://127.0.0.1:22499/api/query-subscription

`GET /api/sub-info`¶

proto_id: QOT_GET_SUB_INFO (3003)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/sub-info

`POST /api/subscribe`¶

proto_id: QOT_SUB (3001)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbols":["HK.00700"],"sub_types":[1],"is_sub_or_un_sub":true}' \
  https://127.0.0.1:22499/api/subscribe

`POST /api/unsubscribe`¶

proto_id: QOT_SUB (3001)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbols":["HK.00700"],"sub_types":[1],"is_sub_or_un_sub":false}' \
  https://127.0.0.1:22499/api/unsubscribe

`GET /ws`¶

proto_id: — (non-proto / 无 backend 转发)

Scope: legacy/public: —; scope-mode: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

未配置 keys.json 的 legacy 模式保持公开以兼容旧客户端；scope-mode 下握手需 ?token= 或 Authorization: Bearer <key>，且 key 持有 qot:read。

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/ws

行情查询¶

实时行情、K 线、摆盘、经纪队列、分时、成交明细、逐笔统计、无风险利率、摆盘步长、行情额度。行情读取通常需 qot:read；逐笔订阅维护与询价权限见各接口。

`POST /api/bond-quote-info`¶

proto_id: QOT_GET_BOND_QUOTE_INFO (2131755051)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1}' \
  https://127.0.0.1:22499/api/bond-quote-info

`POST /api/broker`¶

proto_id: QOT_GET_BROKER (3014)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700"}' \
  https://127.0.0.1:22499/api/broker

`POST /api/capital-distribution`¶

proto_id: QOT_GET_CAPITAL_DISTRIBUTION (3212)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700"}' \
  https://127.0.0.1:22499/api/capital-distribution

`POST /api/capital-flow`¶

proto_id: QOT_GET_CAPITAL_FLOW (3211)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700","period_type":1}' \
  https://127.0.0.1:22499/api/capital-flow

`POST /api/chip-distribution`¶

proto_id: QOT_GET_CHIP_DISTRIBUTION (2131755052)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/chip-distribution

`POST /api/forex-rates`¶

proto_id: QOT_GET_FOREX_RATES (2131755030)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/forex-rates

`POST /api/history-kl-quota`¶

proto_id: QOT_REQUEST_HISTORY_KL_QUOTA (3104)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

额度来源: used_quota / remain_quota 使用登录后后端请求返回的账号动态历史 K 线额度；显式设置 FUTU_HISTORY_KL_QUOTA_MAX 时才覆盖该动态额度。冷启动且动态额度尚未返回时按 C++ 默认值 100 fail-closed。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"b_get_detail":false}' \
  https://127.0.0.1:22499/api/history-kl-quota

`POST /api/history-kline`¶

proto_id: QOT_REQUEST_HISTORY_KL (3103)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

注意: REST kl_type 仅接整数；以下编号来自公开协议 Qot_Common.KLType。

`kl_type`	周期
`1`	1分钟K
`2`	日K
`3`	周K
`4`	月K
`5`	年K
`6`	5分钟K
`7`	15分钟K
`8`	30分钟K
`9`	60分钟K
`10`	3分钟K
`11`	季K
`12`	10分钟K
`13`	120分钟K
`14`	180分钟K
`15`	240分钟K

字符串 "day" 仅 MCP 层支持。字段 count 已 alias 到 proto req_num (可双接)。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"},"rehab_type":0,"kl_type":2,"max_count":100,"begin_time":"2026-01-01 00:00:00","end_time":"2026-04-01 23:59:59"}' \
  https://127.0.0.1:22499/api/history-kline

`POST /api/kline`¶

proto_id: QOT_GET_KL (3006)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

注意: 同 /api/history-kline — REST kl_type 仅接 int; proto 字段名是 req_num (canonical), count 是 v1.4.83+ alias.

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700","rehab_type":0,"kl_type":2,"req_num":100}' \
  https://127.0.0.1:22499/api/kline

`POST /api/kline-pattern`¶

proto_id: QOT_GET_KLINE_PATTERN (2131755021)

Scope: qot:read

默认启用：需 --kline-patterns。当前证据为 source-aligned + local-green；真实 backend 行为待真机验证。point/line 数值按 1e9 还原，字段 presence 原样保留。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"stock_id":7001,"kline_type":2,"extension_version":1}' \
  https://127.0.0.1:22499/api/kline-pattern

`POST /api/kline-pattern-catalog`¶

proto_id: QOT_GET_KLINE_PATTERN_CATALOG (2131755025)

Scope: qot:read

默认启用：需 --kline-patterns。count<=0 请求全部（Desktop 发送 -1）；URL/string 原样返回，不由 daemon 打开或校验。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"filter":0,"count":-1,"start_count":0,"color":0,"extension_version":1}' \
  https://127.0.0.1:22499/api/kline-pattern-catalog

`POST /api/kline-pattern-performance`¶

proto_id: QOT_GET_KLINE_PATTERN_PERFORMANCE (2131755024)

Scope: qot:read

默认启用 / UNVERIFIED：由 --kline-pattern-performance 控制。固定 Desktop SHA 只有 proto 与 registry、没有业务 caller；因此 response 必须显式含 ret_code=0，收益字段按 source 未标比例的 signed raw 值返回。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"shape":1,"duration":0,"extension_version":1}' \
  https://127.0.0.1:22499/api/kline-pattern-performance

`POST /api/kline-pattern-statistics`¶

proto_id: QOT_GET_KLINE_PATTERN_STATISTICS (2131755022)

Scope: qot:read

默认启用：需 --kline-patterns。预测与回测字段是描述性统计，不是确定性投资建议；URL/string 是 opaque metadata，daemon 不抓取、不改写。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"stock_id":7001,"kline_type":2,"shape":1,"color":0,"extension_version":1}' \
  https://127.0.0.1:22499/api/kline-pattern-statistics

`POST /api/kline-pattern-stocks`¶

proto_id: QOT_GET_KLINE_PATTERN_STOCKS (2131755023)

Scope: qot:read

默认启用：需 --kline-patterns。sort_type=-1 保留 backend 默认排序；count<=0 请求全部；自选/持仓 ID 的顺序与重复项原样上送。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"kline_type":2,"shape":1,"market":3,"sort_order":1,"sort_type":-1,"count":-1,"start_count":0,"user_stock_list_mode":0,"extension_version":1}' \
  https://127.0.0.1:22499/api/kline-pattern-stocks

`POST /api/market-state`¶

proto_id: QOT_GET_MARKET_STATE (3223)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbols":["HK.00700"]}' \
  https://127.0.0.1:22499/api/market-state

`POST /api/multi-day-volume-averages`¶

proto_id: QOT_GET_MULTI_DAY_VOLUME_AVERAGES (2131755061)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/multi-day-volume-averages

`POST /api/orderbook`¶

proto_id: QOT_GET_ORDER_BOOK (3012)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700","depth":10}' \
  https://127.0.0.1:22499/api/orderbook

`POST /api/quote`¶

proto_id: QOT_GET_BASIC_QOT (3004)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700"}' \
  https://127.0.0.1:22499/api/quote

`GET /api/quote-capability`¶

proto_id: TEST_CMD (1008)

Scope: legacy/public: —; scope-mode: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/quote-capability

`POST /api/request-hk-option-quote`¶

proto_id: QOT_REQUEST_HK_OPTION_QUOTE (2131755090)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/request-hk-option-quote

`GET /api/risk-free-rate`¶

proto_id: QOT_GET_RISK_FREE_RATE (20231)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

用途: 期权 Black-Scholes 定价必备数据 (HK / US / JP 三市场无风险利率).

字段表 (无必填字段):

字段	类型	必填	说明
`rate_time`	int64	optional	Unix ms 时间戳; 不传 = 最新利率

返回: s2c 含 hk_rate_pct / us_rate_pct / jp_rate_pct (百分比, e.g. 4.5 即 4.5%); 同时透出 raw uint64 (× 10^9) 供调用方自行 verify.

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/risk-free-rate

`POST /api/risk-free-rate`¶

proto_id: QOT_GET_RISK_FREE_RATE (20231)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

用途: 期权 Black-Scholes 定价必备数据 (HK / US / JP 三市场无风险利率).

字段表 (无必填字段):

字段	类型	必填	说明
`rate_time`	int64	optional	Unix ms 时间戳; 不传 = 最新利率

返回: s2c 含 hk_rate_pct / us_rate_pct / jp_rate_pct (百分比, e.g. 4.5 即 4.5%); 同时透出 raw uint64 (× 10^9) 供调用方自行 verify.

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/risk-free-rate

`POST /api/rt`¶

proto_id: QOT_GET_RT (3008)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700"}' \
  https://127.0.0.1:22499/api/rt

`POST /api/search-quote`¶

proto_id: QOT_GET_SEARCH_QUOTE (3262)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"keyword":"AAPL","max_count":10}' \
  https://127.0.0.1:22499/api/search-quote

`POST /api/set-tape-reading-subscription`¶

proto_id: QOT_SET_TAPE_READING_SUBSCRIPTION (2131755073)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/set-tape-reading-subscription

`POST /api/snapshot`¶

proto_id: QOT_GET_SECURITY_SNAPSHOT (3203)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700"}' \
  https://127.0.0.1:22499/api/snapshot

`GET /api/spread-table`¶

proto_id: QOT_GET_SPREAD_TABLE (6503)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

用途: 价位表用于查询不同价格区间的最小变动单位 (e.g. HK 股票 0.01~0.25 → 步长 0.001 等). 客户端做 PlaceOrder / ModifyOrder 时校验价格合法性必备.

字段表 (无业务参数):

字段	类型	必填	说明
`reserved`	int	optional	占位字段, 可不传; 总返全部价位表

返回: s2c.spread_table_list 含每张价位表 (spread_code + spread_item_list), 每条 item 含 price_from / price_to / value (f64, 已 / 1e9 还原成实际价格).

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/spread-table

`POST /api/spread-table`¶

proto_id: QOT_GET_SPREAD_TABLE (6503)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

用途: 价位表用于查询不同价格区间的最小变动单位 (e.g. HK 股票 0.01~0.25 → 步长 0.001 等). 客户端做 PlaceOrder / ModifyOrder 时校验价格合法性必备.

字段表 (无业务参数):

字段	类型	必填	说明
`reserved`	int	optional	占位字段, 可不传; 总返全部价位表

返回: s2c.spread_table_list 含每张价位表 (spread_code + spread_item_list), 每条 item 含 price_from / price_to / value (f64, 已 / 1e9 还原成实际价格).

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/spread-table

`POST /api/static-info`¶

proto_id: QOT_GET_STATIC_INFO (3202)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbols":["HK.00700","US.AAPL"]}' \
  https://127.0.0.1:22499/api/static-info

`POST /api/stock-advanced-indicators`¶

proto_id: QOT_GET_STOCK_ADVANCED_INDICATORS (2131755043)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/stock-advanced-indicators

`POST /api/tape-reading-events`¶

proto_id: QOT_GET_TAPE_READING_EVENTS (2131755071)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/tape-reading-events

`POST /api/tape-reading-statistics`¶

proto_id: QOT_GET_TAPE_READING_STATISTICS (2131755072)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/tape-reading-statistics

`POST /api/ticker`¶

proto_id: QOT_GET_TICKER (3010)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700","count":50}' \
  https://127.0.0.1:22499/api/ticker

`POST /api/ticker-statistic`¶

proto_id: QOT_GET_TICKER_STATISTIC (6365)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

用途: 逐笔统计. 按时间间隔聚合分笔成交 (累计成交量 / 成交额 / 平均价).

字段表:

字段	类型	必填	说明
`security` 或 `symbol`	object/string	✅	标的; shorthand `"HK.00700"`
`interval_type`	int	✅	聚合粒度 enum (具体值见 proto)

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700","interval_type":1}' \
  https://127.0.0.1:22499/api/ticker-statistic

`POST /api/ticker-statistic-detail`¶

proto_id: QOT_GET_TICKER_STATISTIC_DETAIL (6366)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/ticker-statistic-detail

`POST /api/used-quota`¶

proto_id: GET_USED_QUOTA (1010)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/used-quota

板块 / 筛选 / 元数据¶

板块与产业链、跨品类筛选、交易日与交易时段、停牌、代码变更、IPO 列表及指标目录。

`POST /api/bond-screen`¶

proto_id: QOT_BOND_SCREEN (2131755020)

Scope: qot:read

启用与证据边界：由 --extended-data-reads 控制，默认启用。当前证据为 source-aligned + local-green，真实 backend 行为仍待真机验证。 data_max_count 为 1..100；source_types 仅接受 1（香港）/2（新加坡）。字符串型筛选的 factor_id 是 backend 动态目录，范围型筛选只接受 intervals。单个 sort 按 source 合同优先于 sorts。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"conditions":[{"type_id":2,"intervals":[{"lower":{"value":0}}]}],"data_from":0,"data_max_count":20,"source_types":[1],"extension_version":1}' \
  https://127.0.0.1:22499/api/bond-screen

`POST /api/code-change`¶

proto_id: QOT_GET_CODE_CHANGE (3216)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"search":{"code_change_type_list":[1],"time_filter_list":[{"type":1,"begin_time":"2026-01-01","end_time":"2026-04-01"}]}}' \
  https://127.0.0.1:22499/api/code-change

`POST /api/etf-screen`¶

proto_id: QOT_ETF_SCREEN (2131755017)

Scope: qot:read

启用与证据边界：由 --extended-data-reads 控制，默认启用。当前证据为 source-aligned + local-green，真实 backend 行为仍待真机验证。 data_max_count 为 1..500；market/field/period/content/sort 的静态目录见公开 proto。发行商、地区、行业及持仓等动态子键由 backend 选择项数据定义，不应本地猜测。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"data_from":0,"data_max_count":20,"need_fields":[{"field_id":5}],"extension_version":1}' \
  https://127.0.0.1:22499/api/etf-screen

`POST /api/forex-constituents`¶

proto_id: QOT_GET_FOREX_CONSTITUENTS (2131755034)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/forex-constituents

`POST /api/fund-screen`¶

proto_id: QOT_FUND_SCREEN (2131755018)

Scope: qot:read

启用与证据边界：由 --extended-data-reads 控制，默认启用。当前证据为 source-aligned + local-green，真实 backend 行为仍待真机验证。 data_max_count 为 1..500；完整 33 字段基金筛选合同不与 ETF/期货/债券共用 DTO。基金公司、主题、集合等 ID 是 backend 动态目录。该公开协议保留完整后端能力，不复刻 Desktop 单一列表组件对 selected/no-search/地区默认值的 UI 归一化。sorts 非空时按 source 合同优先于单个 sort。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"fund_types":[1],"risk_levels":[1],"currency_units":[1],"data_from":0,"data_max_count":20,"field_ids":[3],"source_types":[1],"extension_version":1}' \
  https://127.0.0.1:22499/api/fund-screen

`POST /api/future-screen`¶

proto_id: QOT_FUTURE_SCREEN (2131755019)

Scope: qot:read

启用与证据边界：由 --extended-data-reads 控制，默认启用。当前证据为 source-aligned + local-green，真实 backend 行为仍待真机验证。 data_max_count 为 1..100；数字货币期货过滤由 daemon 的 fresh quote entitlement 推导。固定筛选类型/因子目录见公开 proto；新增因子仍以 backend 筛选项目录为准。单个 sort 按 source 合同优先于 sorts。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"conditions":[{"type_id":1,"factor_ids":[1]}],"data_from":0,"data_max_count":20,"extension_version":1}' \
  https://127.0.0.1:22499/api/future-screen

`POST /api/indicator-list`¶

proto_id: QOT_GET_INDICATOR_LIST (3259)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/indicator-list

`POST /api/industrial-chain-by-plate`¶

proto_id: QOT_GET_INDUSTRIAL_CHAIN_BY_PLATE (3429)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"plate_id":1}' \
  https://127.0.0.1:22499/api/industrial-chain-by-plate

`POST /api/industrial-chain-detail`¶

proto_id: QOT_GET_INDUSTRIAL_CHAIN_DETAIL (3428)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"chain_id":1}' \
  https://127.0.0.1:22499/api/industrial-chain-detail

`POST /api/industrial-chain-list`¶

proto_id: QOT_GET_INDUSTRIAL_CHAIN_LIST (3427)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"count":20}' \
  https://127.0.0.1:22499/api/industrial-chain-list

`POST /api/industrial-plate-info`¶

proto_id: QOT_GET_INDUSTRIAL_PLATE_INFO (3430)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"plate_id":1}' \
  https://127.0.0.1:22499/api/industrial-plate-info

`POST /api/industrial-plate-stock`¶

proto_id: QOT_GET_INDUSTRIAL_PLATE_STOCK (3431)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"plate_id":1,"count":50}' \
  https://127.0.0.1:22499/api/industrial-plate-stock

`POST /api/ipo-list`¶

proto_id: QOT_GET_IPO_LIST (3217)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

字段表:

字段	类型	必填	说明
`market`	int/string	✅	IPO endpoint-local market: `1`/`HK`, `2`/`HK_FUTURE`, `11`/`US`, `21`/`CN`/`SH`, `22`/`SZ`, `31`/`SG`, `41`/`JP`, `61`/`MY`

注意: backend 区分 HK / US / A 股 / SG / JP / MY. 传错 market 会返 无效市场.

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"c2s":{"market":1}}' \
  https://127.0.0.1:22499/api/ipo-list

`POST /api/list-plates`¶

proto_id: QOT_GET_PLATE_SET (3204)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"plate_set_type":0}' \
  https://127.0.0.1:22499/api/list-plates

`POST /api/market-trading-sessions`¶

proto_id: QOT_GET_MARKET_TRADING_SESSIONS (2131755010)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"items":[{"market_id":2,"begin_date":20261101,"num":1}],"extension_version":1}' \
  https://127.0.0.1:22499/api/market-trading-sessions

`POST /api/plate-security`¶

proto_id: QOT_GET_PLATE_SECURITY (3205)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"plate":{"market":1,"code":"BK1001"}}' \
  https://127.0.0.1:22499/api/plate-security

`POST /api/plate-set`¶

proto_id: QOT_GET_PLATE_SET (3204)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"plate_set_type":0}' \
  https://127.0.0.1:22499/api/plate-set

`POST /api/security-trading-sessions`¶

proto_id: QOT_GET_SECURITY_TRADING_SESSIONS (2131755009)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"code":"AAPL","exchange":"US","begin_date":20261101,"num":1,"extension_version":1}' \
  https://127.0.0.1:22499/api/security-trading-sessions

`POST /api/stock-filter`¶

proto_id: QOT_STOCK_FILTER (3215)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"begin":0,"num":50,"market":1,"plate":{"market":1,"code":"BK1001"}}' \
  https://127.0.0.1:22499/api/stock-filter

`POST /api/suspend`¶

proto_id: QOT_GET_SUSPEND (3201)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbols":["HK.00700"],"begin_time":"2026-01-01","end_time":"2026-04-01"}' \
  https://127.0.0.1:22499/api/suspend

`POST /api/trading-days`¶

proto_id: QOT_REQUEST_TRADE_DATE (3219)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"begin_time":"2026-01-01","end_time":"2026-04-01"}' \
  https://127.0.0.1:22499/api/trading-days

参考资料 / 衍生品¶

正股关联窝轮、期权链与期权研究、期货合约信息、复权、持股变动、F10/财报/评级/估值/公司行动/股东/内部人/筛选/异动。

`POST /api/bond-redemptions`¶

proto_id: QOT_GET_BOND_REDEMPTIONS (2131755062)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1}' \
  https://127.0.0.1:22499/api/bond-redemptions

`POST /api/calendar-future-spreads`¶

proto_id: QOT_GET_CALENDAR_FUTURE_SPREADS (2131755047)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/calendar-future-spreads

`POST /api/calendar-future-underlyings`¶

proto_id: QOT_GET_CALENDAR_FUTURE_UNDERLYINGS (2131755046)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/calendar-future-underlyings

`POST /api/cbbc-basic-info`¶

proto_id: QOT_GET_CBBC_BASIC_INFO (2131755044)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/cbbc-basic-info

`POST /api/cbbc-distribution`¶

proto_id: QOT_GET_CBBC_DISTRIBUTION (2131755045)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/cbbc-distribution

`POST /api/company-executive-background`¶

proto_id: QOT_GET_COMPANY_EXECUTIVE_BACKGROUND (3245)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"},"leader_name":"Pony Ma"}' \
  https://127.0.0.1:22499/api/company-executive-background

`POST /api/company-executives`¶

proto_id: QOT_GET_COMPANY_EXECUTIVES (3244)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/company-executives

`POST /api/company-operational-efficiency`¶

proto_id: QOT_GET_COMPANY_OPERATIONAL_EFFICIENCY (3246)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/company-operational-efficiency

`POST /api/company-profile`¶

proto_id: QOT_GET_COMPANY_PROFILE (3243)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/company-profile

`POST /api/corporate-actions-buybacks`¶

proto_id: QOT_GET_CORPORATE_ACTIONS_BUYBACKS (3235)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/corporate-actions-buybacks

`POST /api/corporate-actions-dividends`¶

proto_id: QOT_GET_CORPORATE_ACTIONS_DIVIDENDS (3234)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/corporate-actions-dividends

`POST /api/corporate-actions-stock-splits`¶

proto_id: QOT_GET_CORPORATE_ACTIONS_STOCK_SPLITS (3236)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/corporate-actions-stock-splits

`POST /api/daily-short-volume`¶

proto_id: QOT_GET_DAILY_SHORT_VOLUME (3248)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/daily-short-volume

`POST /api/derivative-unusual`¶

proto_id: QOT_GET_DERIVATIVE_UNUSUAL (3803)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"stock_symbol":"HK.00700"}' \
  https://127.0.0.1:22499/api/derivative-unusual

`POST /api/earnings-expected-move`¶

proto_id: QOT_GET_EARNINGS_EXPECTED_MOVE (2131755032)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/earnings-expected-move

`POST /api/financial-unusual`¶

proto_id: QOT_GET_FINANCIAL_UNUSUAL (3802)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"stock_symbol":"HK.00700"}' \
  https://127.0.0.1:22499/api/financial-unusual

`POST /api/financials-earnings-price-history`¶

proto_id: QOT_GET_FINANCIALS_EARNINGS_PRICE_HISTORY (3226)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/financials-earnings-price-history

`POST /api/financials-earnings-price-move`¶

proto_id: QOT_GET_FINANCIALS_EARNINGS_PRICE_MOVE (3225)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/financials-earnings-price-move

`POST /api/financials-revenue-breakdown`¶

proto_id: QOT_GET_FINANCIALS_REVENUE_BREAKDOWN (3228)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/financials-revenue-breakdown

`POST /api/financials-statements`¶

proto_id: QOT_GET_FINANCIALS_STATEMENTS (3227)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/financials-statements

`POST /api/future-info`¶

proto_id: QOT_GET_FUTURE_INFO (3218)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

字段表:

字段	类型	必填	说明
`security_list` 或 `symbols`	array	✅	期货合约; 例 `["HK.HSImain", "US.NQmain"]`

注意: 空 security_list 在 backend 返 没有指定股票 错误, 必须至少 1 个合约.

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"c2s":{"securityList":[{"market":1,"code":"HSImain"}]}}' \
  https://127.0.0.1:22499/api/future-info

`POST /api/get-reference`¶

proto_id: QOT_GET_REFERENCE (3206)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

字段表:

字段	类型	必填	说明
`security` 或 `symbol`	object/string	✅	标的股票; shorthand `"HK.00700"`
`reference_type`	int	✅	`1`=Warrant 窝轮 / `2`=Future 期货主连相关合约

Option 不支持: backend ReferenceType proto 只定义 Warrant / Future. 传 "reference_type":3 会返 unsupported reference type. MCP futu_get_reference 工具同样收紧, 仅接 warrant / future.

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700","reference_type":1}' \
  https://127.0.0.1:22499/api/get-reference

`POST /api/get-silver-bond-dividends`¶

proto_id: QOT_GET_SILVER_BOND_DIVIDENDS (2131755089)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-silver-bond-dividends

`POST /api/holding-change`¶

proto_id: QOT_GET_HOLDING_CHANGE_LIST (3208)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

⚠️ 已废弃 (Deprecated): 上游 backend 已停止维护此接口 (2020-12-21 起). 调用会返 ret_type=-1 + "will be abandoned after 2020-12-21". 不再保证可用, 不应在新代码中使用.

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700","holder_category":1,"begin_time":"2026-01-01","end_time":"2026-04-01"}' \
  https://127.0.0.1:22499/api/holding-change

`POST /api/insider-holder-list`¶

proto_id: QOT_GET_INSIDER_HOLDER_LIST (3241)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/insider-holder-list

`POST /api/insider-trade-list`¶

proto_id: QOT_GET_INSIDER_TRADE_LIST (3242)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/insider-trade-list

`POST /api/option-chain`¶

proto_id: QOT_GET_OPTION_CHAIN (3209)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

字段表:

字段	类型	必填	说明
`owner` 或 `symbol`	object/string	✅	期权标的股 (港美正股、恒指/国指/美指); shorthand `"HK.00700"`
`begin_time`	string	✅	行权日开始 (`YYYY-MM-DD`)
`end_time`	string	✅	行权日结束 (`YYYY-MM-DD`)
`condition`	object	optional	期权过滤条件 (类型 / 行权价范围 / 行情数据)

Owner shorthand: 仅支持顶层 "owner":"HK.00700" 自动展开为 Security 对象; 不支持 "security":{...} 显式 (proto 字段是 owner 不是 security).

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"owner":"HK.00700","begin_time":"2026-05-01","end_time":"2026-06-01"}' \
  https://127.0.0.1:22499/api/option-chain

`POST /api/option-chain-metadata`¶

proto_id: QOT_GET_OPTION_CHAIN_METADATA (2131755035)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/option-chain-metadata

`POST /api/option-earnings-screener`¶

proto_id: QOT_GET_OPTION_EARNINGS_SCREENER (3313)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"option_market":1,"count":50}' \
  https://127.0.0.1:22499/api/option-earnings-screener

`POST /api/option-event`¶

proto_id: QOT_GET_OPTION_EVENT (3307)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"option_market":1,"count":50}' \
  https://127.0.0.1:22499/api/option-event

`POST /api/option-event-detail`¶

proto_id: QOT_GET_OPTION_EVENT_DETAIL (2131755053)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/option-event-detail

`POST /api/option-exercise-probability`¶

proto_id: QOT_GET_OPTION_EXERCISE_PROBABILITY (3251)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":11,"code":"AAPL260116C200000"}}' \
  https://127.0.0.1:22499/api/option-exercise-probability

`POST /api/option-expiration-date`¶

proto_id: QOT_GET_OPTION_EXPIRATION_DATE (3224)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

字段表:

字段	类型	必填	说明
`owner` 或 `symbol`	object/string	✅	期权标的股; shorthand `"HK.00700"`
`index_option_type`	int	optional	仅恒指 / 国指: `IndexOptionType`

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"owner":"HK.00700"}' \
  https://127.0.0.1:22499/api/option-expiration-date

`POST /api/option-gex-by-strike`¶

proto_id: QOT_GET_OPTION_GEX_BY_STRIKE (2131755036)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/option-gex-by-strike

`POST /api/option-gex-profile`¶

proto_id: QOT_GET_OPTION_GEX_PROFILE (2131755037)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/option-gex-profile

`POST /api/option-iv-smile`¶

proto_id: QOT_GET_OPTION_IV_SMILE (2131755040)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/option-iv-smile

`POST /api/option-iv-term-structure`¶

proto_id: QOT_GET_OPTION_IV_TERM_STRUCTURE (2131755039)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/option-iv-term-structure

`POST /api/option-market-statistic`¶

proto_id: QOT_GET_OPTION_MARKET_STATISTIC (3301)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"option_market":1,"data_type":0,"begin_time":"2026-08-01","end_time":"2026-08-30"}' \
  https://127.0.0.1:22499/api/option-market-statistic

`POST /api/option-quote`¶

proto_id: QOT_GET_OPTION_QUOTE (3255)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"c2s":{"multi_legs":[{"security":{"market":11,"code":"AAPL260116C200000"},"side":1,"qty_ratio":1.0}]}}' \
  https://127.0.0.1:22499/api/option-quote

`POST /api/option-rank`¶

proto_id: QOT_GET_OPTION_RANK (3306)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"option_market":1,"sort_type":1,"count":50}' \
  https://127.0.0.1:22499/api/option-rank

`POST /api/option-screen`¶

proto_id: QOT_OPTION_SCREEN (3253)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"page_from":0,"page_count":20}' \
  https://127.0.0.1:22499/api/option-screen

`POST /api/option-seller-screener`¶

proto_id: QOT_GET_OPTION_SELLER_SCREENER (3314)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"option_market":1,"seller_type":1}' \
  https://127.0.0.1:22499/api/option-seller-screener

`POST /api/option-strategy`¶

proto_id: QOT_GET_OPTION_STRATEGY (3256)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"c2s":{"owner":{"market":11,"code":"AAPL"},"option_strategy":1}}' \
  https://127.0.0.1:22499/api/option-strategy

`POST /api/option-strategy-analysis`¶

proto_id: QOT_GET_OPTION_STRATEGY_ANALYSIS (3257)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"c2s":{"multi_legs":[{"security":{"market":11,"code":"AAPL260116C200000"},"side":1,"qty_ratio":1.0}]}}' \
  https://127.0.0.1:22499/api/option-strategy-analysis

`POST /api/option-strategy-spread`¶

proto_id: QOT_GET_OPTION_STRATEGY_SPREAD (3258)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"c2s":{"owner":{"market":11,"code":"AAPL"},"option_strategy":4}}' \
  https://127.0.0.1:22499/api/option-strategy-spread

`POST /api/option-strike-prices`¶

proto_id: QOT_GET_OPTION_STRIKE_PRICES (2131755038)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/option-strike-prices

`POST /api/option-underlying-his-statistic`¶

proto_id: QOT_GET_OPTION_UNDERLYING_HIS_STATISTIC (3302)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"owner":{"market":11,"code":"AAPL"},"begin_time":"2026-08-01","end_time":"2026-08-30"}' \
  https://127.0.0.1:22499/api/option-underlying-his-statistic

`POST /api/option-underlying-his-volatility`¶

proto_id: QOT_GET_OPTION_UNDERLYING_HIS_VOLATILITY (3304)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"owner":{"market":11,"code":"AAPL"},"begin_time":"2026-08-01","end_time":"2026-08-30"}' \
  https://127.0.0.1:22499/api/option-underlying-his-volatility

`POST /api/option-underlying-overview`¶

proto_id: QOT_GET_OPTION_UNDERLYING_OVERVIEW (3303)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"owner_list":[{"market":11,"code":"AAPL"}]}' \
  https://127.0.0.1:22499/api/option-underlying-overview

`POST /api/option-underlying-rank`¶

proto_id: QOT_GET_OPTION_UNDERLYING_RANK (3305)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"option_market":1,"sort_type":1,"count":50}' \
  https://127.0.0.1:22499/api/option-underlying-rank

`POST /api/option-volatility`¶

proto_id: QOT_GET_OPTION_VOLATILITY (3250)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":11,"code":"AAPL260116C200000"},"query_time_period":2,"hv_time_period":30}' \
  https://127.0.0.1:22499/api/option-volatility

`POST /api/option-volume-interest-distribution`¶

proto_id: QOT_GET_OPTION_VOLUME_INTEREST_DISTRIBUTION (2131755041)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/option-volume-interest-distribution

`POST /api/option-zero-dte-contract`¶

proto_id: QOT_GET_OPTION_ZERO_DTE_CONTRACT (3312)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"owner":{"market":11,"code":"AAPL"},"strike_date_timestamp":1800000000,"chain_info":{"strike_date_timestamp":1800000000,"product_code":"AAPL","multiplier":100.0,"contract_share_size":100.0,"expiration_type":1,"underlying":{"market":11,"code":"AAPL"}}}' \
  https://127.0.0.1:22499/api/option-zero-dte-contract

`POST /api/option-zero-dte-screener`¶

proto_id: QOT_GET_OPTION_ZERO_DTE_SCREENER (3311)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"option_market":1,"count":50}' \
  https://127.0.0.1:22499/api/option-zero-dte-screener

`POST /api/owner-plate`¶

proto_id: QOT_GET_OWNER_PLATE (3207)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

字段表:

字段	类型	必填	说明
`security_list` 或 `symbols`	array	✅	股票数组; shorthand `["HK.00700"]` 自动展开

注意: 空 security_list 返空板块列表, 无业务意义; 至少给 1 个 stock.

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbols":["HK.00700"]}' \
  https://127.0.0.1:22499/api/owner-plate

`POST /api/rating-change`¶

proto_id: QOT_GET_RATING_CHANGE (3426)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":11,"count":10}' \
  https://127.0.0.1:22499/api/rating-change

`POST /api/reference`¶

proto_id: QOT_GET_REFERENCE (3206)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

注: /api/reference 与 /api/get-reference 等价 (同 proto_id 3206); /api/get-reference 是 v1.4.74 加的 alias. 字段契约相同 — 见 /api/get-reference 段.

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700","reference_type":1}' \
  https://127.0.0.1:22499/api/reference

`POST /api/rehab`¶

proto_id: QOT_REQUEST_REHAB (3105)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbols":["HK.00700"]}' \
  https://127.0.0.1:22499/api/rehab

`POST /api/related-stocks`¶

proto_id: QOT_GET_RELATED_STOCKS (2131755031)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/related-stocks

`POST /api/research-analyst-consensus`¶

proto_id: QOT_GET_RESEARCH_ANALYST_CONSENSUS (3229)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/research-analyst-consensus

`POST /api/research-morningstar-report`¶

proto_id: QOT_GET_RESEARCH_MORNINGSTAR_REPORT (3231)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/research-morningstar-report

`POST /api/research-rating-summary`¶

proto_id: QOT_GET_RESEARCH_RATING_SUMMARY (3230)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/research-rating-summary

`POST /api/shareholders-holder-detail`¶

proto_id: QOT_GET_SHAREHOLDERS_HOLDER_DETAIL (3239)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/shareholders-holder-detail

`POST /api/shareholders-holding-changes`¶

proto_id: QOT_GET_SHAREHOLDERS_HOLDING_CHANGES (3238)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/shareholders-holding-changes

`POST /api/shareholders-institutional`¶

proto_id: QOT_GET_SHAREHOLDERS_INSTITUTIONAL (3240)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/shareholders-institutional

`POST /api/shareholders-overview`¶

proto_id: QOT_GET_SHAREHOLDERS_OVERVIEW (3237)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/shareholders-overview

`POST /api/short-interest`¶

proto_id: QOT_GET_SHORT_INTEREST (3249)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/short-interest

`POST /api/stock-screen`¶

proto_id: QOT_STOCK_SCREEN (3252)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"page_from":0,"page_count":20}' \
  https://127.0.0.1:22499/api/stock-screen

`POST /api/technical-unusual`¶

proto_id: QOT_GET_TECHNICAL_UNUSUAL (3801)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"stock_symbol":"HK.00700"}' \
  https://127.0.0.1:22499/api/technical-unusual

`POST /api/top-ten-buy-sell-brokers`¶

proto_id: QOT_GET_TOP_TEN_BUY_SELL_BROKERS (3247)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/top-ten-buy-sell-brokers

`POST /api/valuation-detail`¶

proto_id: QOT_GET_VALUATION_DETAIL (3232)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/valuation-detail

`POST /api/valuation-plate-stock-list`¶

proto_id: QOT_GET_VALUATION_PLATE_STOCK_LIST (3233)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":1,"code":"00700"}}' \
  https://127.0.0.1:22499/api/valuation-plate-stock-list

`POST /api/warrant`¶

proto_id: QOT_GET_WARRANT (3210)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

字段表 (核心):

字段	类型	必填	说明
`begin`	int	✅	起始行号 (分页)
`num`	int	✅	拉取数量 (≤200)
`sort_field`	int	✅	`WarrantField` 排序字段 enum
`ascend`	bool	✅	是否升序
`owner` 或 `symbol`	object/string	optional	正股; shorthand `"HK.00700"`

完整字段: 包括 type_list / issuer_list / strike-price 等多组 filter 条件; 见 proto 定义.

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"begin":0,"num":50,"sort_field":1,"ascend":false,"owner":"HK.00700"}' \
  https://127.0.0.1:22499/api/warrant

`POST /api/warrant-screen`¶

proto_id: QOT_WARRANT_SCREEN (3254)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market_type":1,"page_from":0,"page_count":20}' \
  https://127.0.0.1:22499/api/warrant-screen

市场排行 / 情绪¶

市场热力图、涨跌分布、热门榜、股息与业绩排行、卖空排行及美股分时段排行。

`POST /api/dividend-rank`¶

proto_id: QOT_GET_DIVIDEND_RANK (3407)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"rank_type":1,"count":10}' \
  https://127.0.0.1:22499/api/dividend-rank

`POST /api/earnings-beat-rank`¶

proto_id: QOT_GET_EARNINGS_BEAT_RANK (3406)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":11,"beat_type":1,"count":30}' \
  https://127.0.0.1:22499/api/earnings-beat-rank

`POST /api/heat-map-data`¶

proto_id: QOT_GET_HEAT_MAP_DATA (3432)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"count":30}' \
  https://127.0.0.1:22499/api/heat-map-data

`POST /api/high-dividend-soe-rank`¶

proto_id: QOT_GET_HIGH_DIVIDEND_SOE_RANK (3417)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"count":50}' \
  https://127.0.0.1:22499/api/high-dividend-soe-rank

`POST /api/hot-list`¶

proto_id: QOT_GET_HOT_LIST (3414)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"count":50}' \
  https://127.0.0.1:22499/api/hot-list

`POST /api/margin-ranking`¶

proto_id: QOT_GET_MARGIN_RANKING (2131755042)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/margin-ranking

`POST /api/period-change-rank`¶

proto_id: QOT_GET_PERIOD_CHANGE_RANK (3416)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"count":50}' \
  https://127.0.0.1:22499/api/period-change-rank

`POST /api/rise-fall-distribution`¶

proto_id: QOT_GET_RISE_FALL_DISTRIBUTION (3433)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1}' \
  https://127.0.0.1:22499/api/rise-fall-distribution

`POST /api/short-selling-rank`¶

proto_id: QOT_GET_SHORT_SELLING_RANK (3415)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":11,"count":10}' \
  https://127.0.0.1:22499/api/short-selling-rank

`POST /api/top-movers-rank`¶

proto_id: QOT_GET_TOP_MOVERS_RANK (3413)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"count":50}' \
  https://127.0.0.1:22499/api/top-movers-rank

`POST /api/us-after-hours-rank`¶

proto_id: QOT_GET_US_AFTER_HOURS_RANK (3411)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"count":50}' \
  https://127.0.0.1:22499/api/us-after-hours-rank

`POST /api/us-overnight-rank`¶

proto_id: QOT_GET_US_OVERNIGHT_RANK (3412)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"count":50}' \
  https://127.0.0.1:22499/api/us-overnight-rank

`POST /api/us-pre-market-rank`¶

proto_id: QOT_GET_US_PRE_MARKET_RANK (3410)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"count":50}' \
  https://127.0.0.1:22499/api/us-pre-market-rank

新闻 / 公告¶

最新与热门新闻、新闻搜索、个股新闻，以及自选股新闻、公告和评级动态，以及平台公告、新闻翻译与推送设置。

`POST /api/hot-news`¶

proto_id: QOT_GET_HOT_NEWS (2131755011)

Scope: qot:read

启用与证据边界：由 --extended-data-reads 控制，默认启用。当前证据为 source-aligned + local-green，真实 backend 行为仍待真机验证。调用方只传 page_size（1..50）与 extension_version=1。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"page_size":20,"extension_version":1}' \
  https://127.0.0.1:22499/api/hot-news

`POST /api/latest-news`¶

proto_id: QOT_GET_LATEST_NEWS (2131755012)

Scope: qot:read

启用与证据边界：由 --extended-data-reads 控制，默认启用。当前证据为 source-aligned + local-green，真实 backend 行为仍待真机验证。 page_flip=0 向旧数据翻页；page_flip=1 仅与非空最新游标配合。空游标始终按首页处理。可用 include_flash_filter / include_market_filter 加非写入型筛选 sidecar，同时必须传非负 filter_version。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"page_size":20,"seq_mark":"","page_flip":0,"tag_indexes":[0],"extension_version":1}' \
  https://127.0.0.1:22499/api/latest-news

`POST /api/news-push-settings`¶

proto_id: QOT_GET_NEWS_PUSH_SETTINGS (2131755057)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/news-push-settings

`POST /api/news-translation`¶

proto_id: QOT_GET_NEWS_TRANSLATION (2131755033)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/news-translation

`POST /api/platform-announcements`¶

proto_id: QOT_GET_PLATFORM_ANNOUNCEMENTS (2131755054)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/platform-announcements

`POST /api/platform-announcements-by-ids`¶

proto_id: QOT_GET_PLATFORM_ANNOUNCEMENTS_BY_IDS (2131755055)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/platform-announcements-by-ids

`POST /api/search-news`¶

proto_id: QOT_GET_SEARCH_NEWS (3263)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"keyword":"earnings","max_count":10,"news_sub_type":0}' \
  https://127.0.0.1:22499/api/search-news

`POST /api/set-news-push-settings`¶

proto_id: QOT_SET_NEWS_PUSH_SETTINGS (2131755058)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/set-news-push-settings

`POST /api/stock-news`¶

proto_id: QOT_GET_STOCK_NEWS (2131755016)

Scope: qot:read

启用与证据边界：由 --extended-data-reads 控制，默认启用。当前证据为 source-aligned + local-green，真实 backend 行为仍待真机验证。翻页时原样回传上一页响应中的 seq_mark、dedup_ids 和请求级 track_info；id_type 仅接受 1（标的）或 2（板块）。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"stock_id":7000700,"page_size":20,"id_type":1,"seq_mark":"","dedup_ids":[],"extension_version":1}' \
  https://127.0.0.1:22499/api/stock-news

`POST /api/watchlist-announcement`¶

proto_id: QOT_GET_WATCHLIST_ANNOUNCEMENT (2131755014)

Scope: qot:read

启用与证据边界：由 --extended-data-reads 控制，默认启用。当前证据为 source-aligned + local-green，真实 backend 行为仍待真机验证。 stock_ids 必须显式提供；notice_types 取 0..5，0 表示全部且必须单独使用。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"page_size":20,"seq_mark":"","stock_ids":[7000700],"notice_types":[0],"extension_version":1}' \
  https://127.0.0.1:22499/api/watchlist-announcement

`POST /api/watchlist-news`¶

proto_id: QOT_GET_WATCHLIST_NEWS (2131755013)

Scope: qot:read

启用与证据边界：由 --extended-data-reads 控制，默认启用。当前证据为 source-aligned + local-green，真实 backend 行为仍待真机验证。 stock_ids 必须由调用方显式提供，不能为空；不会退化为全市场查询。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"page_size":20,"seq_mark":"","stock_ids":[7000700],"extension_version":1}' \
  https://127.0.0.1:22499/api/watchlist-news

`POST /api/watchlist-rating`¶

proto_id: QOT_GET_WATCHLIST_RATING (2131755015)

Scope: qot:read

启用与证据边界：由 --extended-data-reads 控制，默认启用。当前证据为 source-aligned + local-green，真实 backend 行为仍待真机验证。 stock_ids 必须由调用方显式提供，不能为空；不会退化为全市场查询。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"page_size":20,"seq_mark":"","stock_ids":[7000700],"extension_version":1}' \
  https://127.0.0.1:22499/api/watchlist-rating

日历 / 宏观经济¶

财报、股息、IPO、财经与经济日历、宏观指标及美联储利率预期。

`POST /api/dividend-calendar`¶

proto_id: QOT_GET_DIVIDEND_CALENDAR (3408)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"date":"2026-06-24","count":20}' \
  https://127.0.0.1:22499/api/dividend-calendar

`POST /api/earnings-calendar`¶

proto_id: QOT_GET_EARNINGS_CALENDAR (3401)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":11,"begin_date":"2026-06-24","end_date":"2026-06-25"}' \
  https://127.0.0.1:22499/api/earnings-calendar

`POST /api/economic-calendar`¶

proto_id: QOT_GET_ECONOMIC_CALENDAR (3409)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"begin_date":"2026-06-24","end_date":"2026-06-24","market_list":[11],"count":50}' \
  https://127.0.0.1:22499/api/economic-calendar

`POST /api/fed-watch-dot-plot`¶

proto_id: QOT_GET_FED_WATCH_DOT_PLOT (3405)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/fed-watch-dot-plot

`POST /api/fed-watch-target-rate`¶

proto_id: QOT_GET_FED_WATCH_TARGET_RATE (3404)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/fed-watch-target-rate

`POST /api/financial-calendar`¶

proto_id: QOT_GET_FINANCIAL_CALENDAR_VIEW_INTERNAL (20025)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market_list":[1],"count":20,"begin_date":"20260624","end_date":"20260625"}' \
  https://127.0.0.1:22499/api/financial-calendar

`POST /api/financial-calendar-target`¶

proto_id: QOT_SEARCH_TARGET_FINANCIAL_CALENDAR (20426)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"stock_id":[7000700],"market_list":[1],"size":20,"start":0}' \
  https://127.0.0.1:22499/api/financial-calendar-target

`POST /api/holiday-calendar`¶

proto_id: QOT_GET_HOLIDAY_CALENDAR (2131755063)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/holiday-calendar

`POST /api/ipo-calendar`¶

proto_id: QOT_GET_IPO_LIST (3217)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"event_types":["list"],"begin_date":"20260624","end_date":"20260630"}' \
  https://127.0.0.1:22499/api/ipo-calendar

`POST /api/macro-indicator-history`¶

proto_id: QOT_GET_MACRO_INDICATOR_HISTORY (3403)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"indicator_id":88,"time":"2026-06-24","max_count":100}' \
  https://127.0.0.1:22499/api/macro-indicator-history

`POST /api/macro-indicator-list`¶

proto_id: QOT_GET_MACRO_INDICATOR_LIST (3402)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"region":2}' \
  https://127.0.0.1:22499/api/macro-indicator-list

机构 / 持仓研究¶

机构资料、持仓、持仓变动与分布，以及 ARK 基金持仓和交易动态。

`POST /api/ark-active-transaction`¶

proto_id: QOT_GET_ARK_ACTIVE_TRANSACTION (3425)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"holding_type":1,"cycle_type":1,"count":50}' \
  https://127.0.0.1:22499/api/ark-active-transaction

`POST /api/ark-fund-holding`¶

proto_id: QOT_GET_ARK_FUND_HOLDING (3423)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"holding_type":1,"count":20}' \
  https://127.0.0.1:22499/api/ark-fund-holding

`POST /api/ark-stock-dynamic`¶

proto_id: QOT_GET_ARK_STOCK_DYNAMIC (3424)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"security":{"market":11,"code":"AAPL"}}' \
  https://127.0.0.1:22499/api/ark-stock-dynamic

`POST /api/fund-investment-distribution`¶

proto_id: QOT_GET_FUND_INVESTMENT_DISTRIBUTION (2131755050)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/fund-investment-distribution

`POST /api/fund-top-holdings`¶

proto_id: QOT_GET_FUND_TOP_HOLDINGS (2131755049)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/fund-top-holdings

`POST /api/institution-distribution`¶

proto_id: QOT_GET_INSTITUTION_DISTRIBUTION (3420)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":11,"institution_id":700}' \
  https://127.0.0.1:22499/api/institution-distribution

`POST /api/institution-holding-change`¶

proto_id: QOT_GET_INSTITUTION_HOLDING_CHANGE (3421)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"institution_id":700,"count":20}' \
  https://127.0.0.1:22499/api/institution-holding-change

`POST /api/institution-holding-list`¶

proto_id: QOT_GET_INSTITUTION_HOLDING_LIST (3422)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":41,"institution_id":701,"count":20}' \
  https://127.0.0.1:22499/api/institution-holding-list

`POST /api/institution-list`¶

proto_id: QOT_GET_INSTITUTION_LIST (3418)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":11,"count":20}' \
  https://127.0.0.1:22499/api/institution-list

`POST /api/institution-profile`¶

proto_id: QOT_GET_INSTITUTION_PROFILE (3419)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":11,"institution_id":700}' \
  https://127.0.0.1:22499/api/institution-profile

`POST /api/stock-holdings`¶

proto_id: QOT_GET_STOCK_HOLDINGS (2131755048)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/stock-holdings

自选股 / 私有备注¶

自选股分组与列表维护、私有股票备注及标签。读写权限见各接口的 scope；私有备注要求配置 API Key。

`POST /api/modify-user-security`¶

proto_id: QOT_MODIFY_USER_SECURITY (3214)

Scope: qot:write (qot:read accepted for v1.8 compatibility)

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

有副作用 (stateful write): 改用户自选股. 误传字段会被 v1.4.84+ loud-fail 拒, 但成功调用后无回滚.

字段表 (REST 仅接 int enum):

字段	类型	必填	说明
`group_name`	string	✅	自选分组名; 同名取首个
`op`	int	✅	`1`=Add 新增 / `2`=Del 删除 / `3`=MoveOut 移出分组
`security_list`	array	✅	股票数组; 每项 `{market: int, code: string}`

Shorthand 不支持: 顶层 symbol / symbols 不接, 必须显式 security_list.

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"group_name":"自选","op":1,"security_list":[{"market":1,"code":"00700"}]}' \
  https://127.0.0.1:22499/api/modify-user-security

`POST /api/set-stock-note`¶

proto_id: QOT_SET_STOCK_NOTE (2131755028)

Scope: qot:write (configured API key required; no qot:read fallback)

私有写入 / 读写默认启用：同时需要 --stock-notes、--stock-note-writes、keys.json 与严格 qot:write。单次发送，不自动重发；writer admission 前被 route fence 拒绝会明确标记未发送，一旦进入 writer queue，后续连接切换或 ACK 不确定均返回 SUBMITTED_UNKNOWN。同步 0 仅表示接受。DELETE 可由产生实际状态变化的私有 push 确认；CREATE/UPDATE 因 9430 不含 detail，必须再由 9432 reconcile 校验。标题/详情永不写日志。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"operation":3,"stock_id":7001,"title":"watch","detail":"review later","is_display":1,"extension_version":1}' \
  https://127.0.0.1:22499/api/set-stock-note

`POST /api/stock-note-labels`¶

proto_id: QOT_GET_STOCK_NOTE_LABELS (2131755026)

Scope: acc:read (configured API key required)

私有数据 / 默认启用：需 --stock-notes、配置 keys.json，并持有 acc:read。FULL(1) 由 daemon 固定编码为 is_full=1 + stock_id=[0]；IDS(2) 保留调用方 ID 顺序和重复项。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"mode":1,"stock_ids":[],"extension_version":1}' \
  https://127.0.0.1:22499/api/stock-note-labels

`POST /api/stock-notes`¶

proto_id: QOT_GET_STOCK_NOTES (2131755027)

Scope: acc:read (configured API key required)

私有数据 / 默认启用：需 --stock-notes 与 acc:read。显式非零 ID 列表原样上送；普通查询不修改或持久化 authoritative basic cache。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"stock_ids":[7001],"extension_version":1}' \
  https://127.0.0.1:22499/api/stock-notes

`POST /api/user-security`¶

proto_id: QOT_GET_USER_SECURITY (3213)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"group_name":"自选"}' \
  https://127.0.0.1:22499/api/user-security

`POST /api/user-security-groups`¶

proto_id: QOT_GET_USER_SECURITY_GROUP (3222)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"group_type":3}' \
  https://127.0.0.1:22499/api/user-security-groups

到价 / 事件提醒¶

查询 / 设置 / 修改 / 删除到价提醒，以及期权事件提醒。v1.8.0 起提醒写入归 qot:write（本 major 兼容 qot:read）；查询仍是 qot:read。

`POST /api/alert-system-notify-setting`¶

proto_id: QOT_GET_ALERT_SYSTEM_NOTIFY_SETTING (2131755059)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/alert-system-notify-setting

`POST /api/common-reminder-business-info`¶

proto_id: QOT_GET_COMMON_REMINDER_BUSINESS_INFO (2131755068)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/common-reminder-business-info

`POST /api/common-reminder-items`¶

proto_id: QOT_GET_COMMON_REMINDER_ITEMS (2131755067)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/common-reminder-items

`POST /api/common-reminder-settings`¶

proto_id: QOT_GET_COMMON_REMINDER_SETTINGS (2131755066)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/common-reminder-settings

`POST /api/mutate-reminder-settings`¶

proto_id: QOT_MUTATE_REMINDER_SETTINGS (2131755065)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/mutate-reminder-settings

`POST /api/option-event-alert`¶

proto_id: QOT_GET_OPTION_EVENT_ALERT (3308)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"count":50}' \
  https://127.0.0.1:22499/api/option-event-alert

`POST /api/price-reminder`¶

proto_id: QOT_GET_PRICE_REMINDER (3221)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700"}' \
  https://127.0.0.1:22499/api/price-reminder

`POST /api/reminder-settings`¶

proto_id: QOT_GET_REMINDER_SETTINGS (2131755064)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/reminder-settings

`POST /api/set-alert-system-notify-setting`¶

proto_id: QOT_SET_ALERT_SYSTEM_NOTIFY_SETTING (2131755060)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/set-alert-system-notify-setting

`POST /api/set-common-reminders`¶

proto_id: QOT_SET_COMMON_REMINDERS (2131755069)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/set-common-reminders

`POST /api/set-option-event-alert`¶

proto_id: QOT_SET_OPTION_EVENT_ALERT (3309)

Scope: qot:write (qot:read accepted for v1.8 compatibility)

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"oper_type":1,"alert_list":[{"enable":true,"underlying":{"market":11,"code":"AAPL"}}]}' \
  https://127.0.0.1:22499/api/set-option-event-alert

`POST /api/set-price-reminder`¶

proto_id: QOT_SET_PRICE_REMINDER (3220)

Scope: qot:write (qot:read accepted for v1.8 compatibility)

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

有副作用 (stateful write): 设置 / 修改 / 删除到价提醒.

字段表 (REST 仅接 int enum; proto 字段名是 type 不是 reminder_type):

字段	类型	必填	说明
`security` 或 `symbol`	object/string	✅	股票; shorthand `"HK.00700"`
`op`	int	✅	`1`=Add / `2`=Del / `3`=Enable / `4`=Disable / `5`=Modify / `6`=DelAll
`key`	int64	修改/删除时	`GetPriceReminder` 拿到的提醒 key
`type`	int	Add	`PriceReminderType` (1=PriceUp / 2=PriceDown / ...)
`freq`	int	Add	`PriceReminderFreq` (1=Always / 2=OnceADay / 3=OnlyOnce); Modify 时 backend 保留旧值时可省
`value`	f64	Add	提醒值 (精确到小数点后 3 位); Modify 时 backend 保留旧值时可省
`note`	string	optional	标注 (≤20 中文字符)

Add (op=1) 必填字段: type + freq + value. gateway 在 Add 路径强制三者非空.

Modify (op=5) 不强制 type / freq / value: gateway 先拉旧项, 用户提供字段覆盖, 未提供则保留旧值 (覆盖式 Modify 语义).

reminder_session_list (optional, 数组): PriceReminderMarketStatus 枚举值: 1=Open / 2=USPre / 3=USAfter / 4=USOverNight. 任何非 1..4 的值会被 gateway loud reject (-1 + 错误文案). 美股留空时 daemon 默认补 [1, 2, 3]; 非美股自动清空.

注意: REST 不接 "op":"SetAdd" 字符串形态; 仅 MCP 层支持 op string→int.

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700","op":1,"type":1,"freq":1,"value":300.0}' \
  https://127.0.0.1:22499/api/set-price-reminder

交易账户¶

账户、资金、持仓、订单与成交、保证金与费用预览、资产与收益走势、订单关系、算法单日志及持仓公司行动。需 acc:read。

`POST /api/acc-cash-flow`¶

proto_id: TRD_FLOW_SUMMARY (2226)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"acc_id":123456,"env":1,"clearing_date":"2026-04-01"}' \
  https://127.0.0.1:22499/api/acc-cash-flow

`POST /api/account-flag`¶

proto_id: TRD_GET_ACCOUNT_FLAG (22705)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1}' \
  https://127.0.0.1:22499/api/account-flag

`GET /api/accounts`¶

proto_id: TRD_GET_ACC_LIST (2001)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/accounts

`POST /api/biz-group`¶

proto_id: TRD_GET_BIZ_GROUP (22703)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1,"market":1}' \
  https://127.0.0.1:22499/api/biz-group

`POST /api/bond-answer-state`¶

proto_id: TRD_GET_BOND_ANSWER_STATE (22709)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1}' \
  https://127.0.0.1:22499/api/bond-answer-state

`POST /api/bond-position-list`¶

proto_id: TRD_GET_BOND_POSITION_LIST (22708)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1}' \
  https://127.0.0.1:22499/api/bond-position-list

`POST /api/bond-single-asset`¶

proto_id: TRD_GET_BOND_SINGLE_ASSET (22707)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1}' \
  https://127.0.0.1:22499/api/bond-single-asset

`POST /api/bond-total-asset`¶

proto_id: TRD_GET_BOND_TOTAL_ASSET (22706)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1}' \
  https://127.0.0.1:22499/api/bond-total-asset

`POST /api/bond-trade-reminder`¶

proto_id: TRD_GET_BOND_TRADE_REMINDER (22710)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1}' \
  https://127.0.0.1:22499/api/bond-trade-reminder

`POST /api/cash-detail`¶

proto_id: TRD_GET_CASH_DETAIL (22702)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1,"flow_id":"<flow_id>"}' \
  https://127.0.0.1:22499/api/cash-detail

`POST /api/cash-log`¶

proto_id: TRD_GET_CASH_LOG (22701)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1,"begin_time":"2026-01-01","end_time":"2026-04-01"}' \
  https://127.0.0.1:22499/api/cash-log

`POST /api/combo-max-trd-qtys`¶

proto_id: TRD_GET_COMBO_MAX_TRD_QTYS (2112)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"c2s":{"header":{"trd_env":1,"acc_id":123456,"trd_market":2},"combo_legs":[{"security":{"market":11,"code":"AAPL260116C200000"},"side":1,"qty_ratio":1.0},{"security":{"market":11,"code":"AAPL260116C205000"},"side":2,"qty_ratio":1.0}],"qty":1.0,"price":1.0,"order_type":1}}' \
  https://127.0.0.1:22499/api/combo-max-trd-qtys

`POST /api/flow-summary`¶

proto_id: TRD_FLOW_SUMMARY (2226)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"acc_id":123456,"env":1,"clearing_date":"2026-04-01"}' \
  https://127.0.0.1:22499/api/flow-summary

`POST /api/funds`¶

proto_id: TRD_GET_FUNDS (2101)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"acc_id":123456,"env":1}' \
  https://127.0.0.1:22499/api/funds

`POST /api/get-bond-account-positions`¶

proto_id: TRD_GET_BOND_ACCOUNT_POSITIONS (2132803606)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-bond-account-positions

`POST /api/get-forex-account-quote-context`¶

proto_id: TRD_GET_FOREX_ACCOUNT_QUOTE_CONTEXT (2132803613)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-forex-account-quote-context

`POST /api/get-forex-accounts`¶

proto_id: TRD_GET_FOREX_ACCOUNTS (2132803609)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-forex-accounts

`POST /api/get-forex-assets`¶

proto_id: TRD_GET_FOREX_ASSETS (2132803612)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-forex-assets

`POST /api/get-forex-order-detail`¶

proto_id: TRD_GET_FOREX_ORDER_DETAIL (2132803628)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-forex-order-detail

`POST /api/get-forex-orders`¶

proto_id: TRD_GET_FOREX_ORDERS (2132803627)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-forex-orders

`POST /api/get-forex-risk-control`¶

proto_id: TRD_GET_FOREX_RISK_CONTROL (2132803610)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-forex-risk-control

`POST /api/get-forex-symbol-configs`¶

proto_id: TRD_GET_FOREX_SYMBOL_CONFIGS (2132803614)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-forex-symbol-configs

`POST /api/get-fund-account-positions`¶

proto_id: TRD_GET_FUND_ACCOUNT_POSITIONS (2132803607)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-fund-account-positions

`POST /api/get-fund-position-details`¶

proto_id: TRD_GET_FUND_POSITION_DETAILS (2132803608)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-fund-position-details

`POST /api/get-wealth-holdings`¶

proto_id: TRD_GET_WEALTH_HOLDINGS (2132803605)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-wealth-holdings

`POST /api/history-order-fills`¶

proto_id: TRD_GET_HISTORY_ORDER_FILL_LIST (2222)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"acc_id":123456,"env":1,"begin_time":"2026-01-01 00:00:00","end_time":"2026-04-01 23:59:59"}' \
  https://127.0.0.1:22499/api/history-order-fills

`POST /api/history-orders`¶

proto_id: TRD_GET_HISTORY_ORDER_LIST (2221)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"acc_id":123456,"env":1,"begin_time":"2026-01-01 00:00:00","end_time":"2026-04-01 23:59:59"}' \
  https://127.0.0.1:22499/api/history-orders

`GET /api/list-accounts`¶

proto_id: TRD_GET_ACC_LIST (2001)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/list-accounts

`POST /api/margin-info`¶

proto_id: TRD_GET_MARGIN_INFO (22704)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1,"market":1}' \
  https://127.0.0.1:22499/api/margin-info

`POST /api/margin-ratio`¶

proto_id: TRD_GET_MARGIN_RATIO (2223)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"acc_id":123456,"env":1,"symbols":["HK.00700"]}' \
  https://127.0.0.1:22499/api/margin-ratio

`POST /api/max-trd-qtys`¶

proto_id: TRD_GET_MAX_TRD_QTYS (2111)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"acc_id":123456,"env":1,"code":"00700","price":300.0,"order_type":1}' \
  https://127.0.0.1:22499/api/max-trd-qtys

`POST /api/order-fee`¶

proto_id: TRD_GET_ORDER_FEE (2225)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1,"order_id_ex_list":["987"]}' \
  https://127.0.0.1:22499/api/order-fee

`POST /api/order-fills`¶

proto_id: TRD_GET_ORDER_FILL_LIST (2211)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"acc_id":123456,"env":1}' \
  https://127.0.0.1:22499/api/order-fills

`POST /api/orders`¶

proto_id: TRD_GET_ORDER_LIST (2201)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"acc_id":123456,"env":1}' \
  https://127.0.0.1:22499/api/orders

`POST /api/positions`¶

proto_id: TRD_GET_POSITION_LIST (2102)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"acc_id":123456,"env":1}' \
  https://127.0.0.1:22499/api/positions

`POST /api/preview-forex-margin`¶

proto_id: TRD_PREVIEW_FOREX_MARGIN (2132803611)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/preview-forex-margin

`POST /api/preview-order-impact`¶

proto_id: TRD_PREVIEW_ORDER_IMPACT (22711)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":9001,"trd_market":2},"order":{"single":{"security":{"code":"AAPL","market_id":11,"stock_market":2,"exchange":"US","currency":"USD","security_type":1},"side":1,"order_type":2,"volume":{"quantity":"10"}}},"extension_version":1}' \
  https://127.0.0.1:22499/api/preview-order-impact

`GET /api/token-state`¶

proto_id: GET_TOKEN_STATE (1326)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/token-state

`POST /api/token-state`¶

proto_id: GET_TOKEN_STATE (1326)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456}' \
  https://127.0.0.1:22499/api/token-state

`POST /api/trd/algo-order-logs`¶

proto_id: TRD_GET_ALGO_ORDER_LOGS (22723)

Scope: acc:read

默认启用的后端读取：需 --extended-data-reads 与 acc:read。page_index 从 0 开始，page_size 为 1..50；fetch_all=true 时 daemon 只依据 total_cnt 拉取全部页，不使用不存在的 page_flag/completed。后续页失败不会返回静默 partial。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":900001,"trd_market":2},"algo_order_id":"ORDER_ID","page_index":0,"page_size":50,"fetch_all":false,"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/algo-order-logs

`POST /api/trd/asset-trend`¶

proto_id: TRD_GET_ASSET_TREND (22712)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":9001,"trd_market":2},"range":{"query_type":3,"currency":"USD","start_date":"2026-08-01 00:00:00","end_date":"2026-08-30 23:59:59","time_location":"America/New_York","price_context":{"use_pre_market":true,"use_after_hours":false,"use_overnight":true}},"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/asset-trend

`POST /api/trd/broker-option-strategies`¶

proto_id: TRD_GET_BROKER_OPTION_STRATEGIES (2132803595)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/broker-option-strategies

`POST /api/trd/broker-total-assets`¶

proto_id: TRD_GET_BROKER_TOTAL_ASSETS (2132803601)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/broker-total-assets

`POST /api/trd/cash-sweep-configuration`¶

proto_id: TRD_GET_CASH_SWEEP_CONFIGURATION (2132803603)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/cash-sweep-configuration

`POST /api/trd/cash-sweep-redemption-capacity`¶

proto_id: TRD_GET_CASH_SWEEP_REDEMPTION_CAPACITY (2132803604)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/cash-sweep-redemption-capacity

`POST /api/trd/fractional-share-whitelist`¶

proto_id: TRD_GET_FRACTIONAL_SHARE_WHITELIST (2132803600)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/fractional-share-whitelist

`POST /api/trd/future-position-breakdown`¶

proto_id: TRD_GET_FUTURE_POSITION_BREAKDOWN (2132803593)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/future-position-breakdown

`POST /api/trd/future-subpositions`¶

proto_id: TRD_GET_FUTURE_SUBPOSITIONS (2132803588)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/future-subpositions

`POST /api/trd/get-account-auto-exchange-setting`¶

proto_id: TRD_GET_ACCOUNT_AUTO_EXCHANGE_SETTING (2132803621)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/get-account-auto-exchange-setting

`POST /api/trd/get-account-financing-setting`¶

proto_id: TRD_GET_ACCOUNT_FINANCING_SETTING (2132803619)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/get-account-financing-setting

`POST /api/trd/get-account-foreign-exchange-setting`¶

proto_id: TRD_GET_ACCOUNT_FOREIGN_EXCHANGE_SETTING (2132803623)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/get-account-foreign-exchange-setting

`POST /api/trd/get-account-local-exchange-setting`¶

proto_id: TRD_GET_ACCOUNT_LOCAL_EXCHANGE_SETTING (2132803625)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/get-account-local-exchange-setting

`POST /api/trd/legacy-future-fee-config`¶

proto_id: TRD_GET_LEGACY_FUTURE_FEE_CONFIG (2132803597)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/legacy-future-fee-config

`POST /api/trd/option-combo-eligibility`¶

proto_id: TRD_GET_OPTION_COMBO_ELIGIBILITY (2132803594)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/option-combo-eligibility

`POST /api/trd/order-dates`¶

proto_id: TRD_GET_ORDER_DATES (2132803586)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/order-dates

`POST /api/trd/order-fill-details`¶

proto_id: TRD_GET_ORDER_FILL_DETAILS (2132803585)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/order-fill-details

`POST /api/trd/order-relations`¶

proto_id: TRD_GET_ORDER_RELATIONS (22715)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":9001,"trd_market":2},"order_id_ex":"ORDER_ID","extension_version":1}' \
  https://127.0.0.1:22499/api/trd/order-relations

`POST /api/trd/position-corporate-actions`¶

proto_id: TRD_GET_POSITION_CORPORATE_ACTIONS (22716)

Scope: acc:read

启用与证据边界：由 --extended-data-reads 控制，默认启用。当前证据为 source-aligned + local-green，真实 backend 行为仍待真机验证。标的集合只来自该账户的 fresh position snapshot，调用方不能传入或覆盖 position/symbol。daemon 按市场时区自动查询昨天至明天，并分别完成正股与衍生品 backend 分页；映射或单个查询失败以 partial status 明示。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":900000001,"trd_market":2},"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/position-corporate-actions

`POST /api/trd/premium-entitlements`¶

proto_id: TRD_GET_PREMIUM_ENTITLEMENTS (2132803599)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/premium-entitlements

`POST /api/trd/return-calendar`¶

proto_id: TRD_GET_RETURN_CALENDAR (22714)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":9001,"trd_market":2},"currency":"USD","query_type":1,"method":2,"time":1788112000000,"calendar_date":"2026-08-01 00:00:00","time_location":"America/New_York","price_context":{"use_pre_market":true,"use_after_hours":false,"use_overnight":true},"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/return-calendar

`POST /api/trd/sub-account-fill-quantities`¶

proto_id: TRD_GET_SUB_ACCOUNT_FILL_QUANTITIES (2132803591)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/sub-account-fill-quantities

`POST /api/trd/symbol-history-fills`¶

proto_id: TRD_GET_SYMBOL_HISTORY_FILLS (2132803590)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/symbol-history-fills

`POST /api/trd/symbol-history-orders`¶

proto_id: TRD_GET_SYMBOL_HISTORY_ORDERS (2132803589)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/symbol-history-orders

`POST /api/trd/symbol-trade-counts`¶

proto_id: TRD_GET_SYMBOL_TRADE_COUNTS (2132803592)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/symbol-trade-counts

`POST /api/trd/today-fill-statistics`¶

proto_id: TRD_GET_TODAY_FILL_STATISTICS (2132803587)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/today-fill-statistics

`POST /api/trd/trade-password-state`¶

proto_id: TRD_GET_TRADE_PASSWORD_STATE (2132803602)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/trade-password-state

`POST /api/trd/transaction-fee-plan`¶

proto_id: TRD_GET_TRANSACTION_FEE_PLAN (2132803596)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/transaction-fee-plan

`POST /api/trd/yield-trend`¶

proto_id: TRD_GET_YIELD_TREND (22713)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":9001,"trd_market":2},"range":{"query_type":3,"currency":"USD","start_date":"2026-08-01 00:00:00","end_date":"2026-08-30 23:59:59","time_location":"America/New_York","price_context":{"use_pre_market":true,"use_after_hours":false,"use_overnight":true}},"method":2,"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/yield-trend

交易写入¶

下单、改单、单笔撤单、一键撤全部、解锁交易 cipher、账户 push 订阅。下单 / 撤改单需 trade:real 或 trade:simulate (env 二次校验) + --enable-trading；解锁交易 (/api/unlock-trade) v1.4.104+ 严格要求 trade:unlock (其它 trade super-scope 不再视为兼容)。

`POST /api/cancel-all-order`¶

proto_id: TRD_MODIFY_ORDER (2205)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":1,"market":1}' \
  https://127.0.0.1:22499/api/cancel-all-order

`POST /api/cancel-forex-order`¶

proto_id: TRD_CANCEL_FOREX_ORDER (2132803629)

Scope: trade:real

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/cancel-forex-order

`POST /api/cancel-order`¶

proto_id: TRD_MODIFY_ORDER (2205)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

语义化单笔撤单入口: 底层仍发送 Trd_ModifyOrder(Cancel)，但 REST 客户端只需传交易账号、环境、市场和 order_id 或 order_id_ex，无需传低层 packet_id / modify_order_op。

友好字段: flat body 支持 env (real / simulate / sim)、market (US / HK / 官方非基金交易市场 int) 和可选 op (cancel / 2)；如果传 op，只能是撤单语义。

响应语义: ret_type=0 只表示 backend 已接受 Cancel 操作请求，不是最终撤单状态证明。Rust daemon 会在返回 ACK 前执行一次有上限的权威订单刷新，帮助后续 REST/CLI 订单查询更快收敛；不会在撤单 ACK 后隐式刷新持仓，can_sell_qty 仍以后续交易推送或显式 refresh_cache=true 持仓查询为准。最终状态仍以 push / refresh 查询为准。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":"real","market":"US","order_id_ex":"FH1C8ABB517AE56000"}' \
  https://127.0.0.1:22499/api/cancel-order

`POST /api/combo-order`¶

proto_id: TRD_PLACE_COMBO_ORDER (2227)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

注意: REST 客户端可省略 packet_id; daemon 会在转发前按当前连接自动补齐。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"c2s":{"header":{"trd_env":1,"acc_id":123456,"trd_market":2},"combo_legs":[{"security":{"market":11,"code":"AAPL260116C200000"},"side":1,"qty_ratio":1.0},{"security":{"market":11,"code":"AAPL260116C205000"},"side":2,"qty_ratio":1.0}],"qty":1.0,"price":1.0,"order_type":1}}' \
  https://127.0.0.1:22499/api/combo-order

`POST /api/confirm-forex-order`¶

proto_id: TRD_CONFIRM_FOREX_ORDER (2132803631)

Scope: trade:real

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/confirm-forex-order

`POST /api/modify-forex-order`¶

proto_id: TRD_MODIFY_FOREX_ORDER (2132803632)

Scope: trade:real

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/modify-forex-order

`POST /api/modify-order`¶

proto_id: TRD_MODIFY_ORDER (2205)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

字段表 (REST 仅接 int enum):

字段	类型	必填	说明
`c2s.header.trd_env`	int	✅	`0`=Real / `1`=Simulate
`c2s.header.acc_id`	uint64	✅	交易账号 ID
`c2s.header.trd_market`	int	✅	交易市场 enum
`order_id` / `order_id_ex`	uint64 / string	✅	要修改 / 撤销的订单；二选一
`modify_order_op`	int	✅	`1`=Normal 改单 / `2`=Cancel 撤单 / `3`=Disable / `4`=Enable / `5`=DeleteOutofdate
`qty` / `price`	float	Normal 改单时按原订单类型必填	新数量 / 新价格

单笔撤单: 推荐使用语义化入口 /api/cancel-order。本低层入口仍兼容 modify_order_op: 2 的历史撤单形态；/api/cancel-all-order 是全部撤单入口。

低层 strict 入口: /api/modify-order 不接收 /api/cancel-order 的 flat env / market / op=cancel 友好字段；使用 c2s 形态时仍应按低层 ModifyOrder 契约传字段。普通 REST 单笔撤单请直接使用 /api/cancel-order。

响应语义: ret_type=0 只表示 backend 已接受 Modify/Cancel 操作请求，不是最终成交 / 撤单状态证明。最终订单状态以交易推送、或稍后带 refresh_cache=true 的订单查询为准；可卖数量以交易推送或显式持仓刷新查询为准。这与官方 OpenD 的 ModifyOrder ACK 语义一致。Rust daemon 对单笔撤单成功会在返回 ACK 前执行一次有上限的权威订单刷新，帮助 REST/CLI 后续订单查询更快收敛；不会在撤单 ACK 后隐式刷新持仓，避免无关的 account-info 查询失败干扰撤单结果判断。刷新超时或失败不会把已被 backend 接受的撤单改写成失败，最终状态仍以 push / refresh 查询为准。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"c2s":{"header":{"trd_env":1,"acc_id":123456,"trd_market":1},"order_id":987,"modify_order_op":2}}' \
  https://127.0.0.1:22499/api/modify-order

`POST /api/order`¶

proto_id: TRD_PLACE_ORDER (2202)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"market":1,"acc_id":123456,"env":1,"side":1,"code":"00700","qty":100,"price":300.0}' \
  https://127.0.0.1:22499/api/order

`POST /api/reconfirm-order`¶

proto_id: TRD_RECONFIRM_ORDER (2237)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"order_id":"987","reconfirm_op":1}' \
  https://127.0.0.1:22499/api/reconfirm-order

`POST /api/set-forex-position-stops`¶

proto_id: TRD_SET_FOREX_POSITION_STOPS (2132803630)

Scope: trade:real

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/set-forex-position-stops

`POST /api/sub-acc-push`¶

proto_id: TRD_SUB_ACC_PUSH (2008)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id_list":[123456]}' \
  https://127.0.0.1:22499/api/sub-acc-push

`POST /api/trd/batch-close-positions`¶

proto_id: TRD_BATCH_CLOSE_POSITIONS (22727)

Scope: trade:real

真实资金写入，默认关闭：需显式启用 --enable-position-actions，只接受去重、非组合持仓，数量不得超过最新可平数量；日本券商及不支持的市场拒绝。qty 使用十进制字符串，直接保留精度，不经浮点舍入。

美股碎股另需统一账户、已确认非 DVP 结算、有效动态配置及当前券商标的白名单，最多四位小数，上限为 999999999.9999。缺少原始可平数量时请先刷新持仓。请求整数数量可以使用含小数的可平持仓，不要求碎股资格。混合批次中任何一个目标不合格，整批拒绝。

小数数量使用正常交易时段；加拿大券商保留原有不指定交易时段的处理。其他方向、订单类型和时段由最新持仓与标的资料派生。写出前账户、配置、连接或持仓失效时拒绝发送；结果未确认时不自动重发。该新增碎股路径已覆盖离线测试，真实账户行为仍待复测。KRX 保留本地市场合同 TrdMarket=18、TrdSecMarket=121、QotMarket=111。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":900001,"trd_market":2},"idempotency_key":"batch-demo-1","mode":1,"target_list":[{"position_id":9002,"qty":"10"}],"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/batch-close-positions

`POST /api/trd/begin-forex-unlock`¶

proto_id: TRD_BEGIN_FOREX_UNLOCK (2132803615)

Scope: trade:unlock

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/begin-forex-unlock

`POST /api/trd/cancel-order-group`¶

proto_id: TRD_CANCEL_ORDER_GROUP (22719)

Scope: trade:real

真实资金写入，默认关闭：只撤销当前权威订单快照中的完整服务器订单组；需 --enable-group-orders 与 trade:real。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":900001,"trd_market":2},"initial":{"idempotency_key":"group-cancel-demo-1","group_type":3,"order_id_list":["ORDER_ID"]},"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/cancel-order-group

`POST /api/trd/clear-futures-positions`¶

proto_id: TRD_CLEAR_FUTURES_POSITIONS (22726)

Scope: trade:real

真实资金写入，默认关闭：显式目标使用 custom_contract=true；支持非跨期组合的期货及期货期权。全账户清仓必须同时传 all_positions=true 并以 --allow-all-position-clear 启动；范围内出现不支持合约会整体拒绝。同步 result=0 只表示接受，最终状态按原始 req_id 的唯一 4718/push 结果确认。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":900001,"trd_market":5},"idempotency_key":"clear-demo-1","position_id_list":[9001],"price_type":1,"all_positions":false,"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/clear-futures-positions

`POST /api/trd/complete-forex-unlock`¶

proto_id: TRD_COMPLETE_FOREX_UNLOCK (2132803616)

Scope: trade:unlock

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/complete-forex-unlock

`POST /api/trd/delete-order-group`¶

proto_id: TRD_DELETE_ORDER_GROUP (22720)

Scope: trade:real

真实资金写入，默认关闭：只删除当前权威订单快照中的完整服务器订单组；需 --enable-group-orders 与 trade:real。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":900001,"trd_market":2},"initial":{"idempotency_key":"group-delete-demo-1","group_type":3,"order_id_list":["ORDER_ID"]},"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/delete-order-group

`POST /api/trd/forex-unlock-status`¶

proto_id: TRD_GET_FOREX_UNLOCK_STATUS (2132803618)

Scope: trade:unlock

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/forex-unlock-status

`POST /api/trd/lock-forex-trade`¶

proto_id: TRD_LOCK_FOREX_TRADE (2132803617)

Scope: trade:unlock

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/lock-forex-trade

`POST /api/trd/modify-algo-order`¶

proto_id: TRD_MODIFY_ALGO_ORDER (22722)

Scope: trade:real

真实资金写入，默认关闭：只修改非终态的当前权威算法单快照；产品、市场、算法类型/market-limit 形态不可改变，改单不覆盖服务器 vendor，并重新验证 static/live/customer-company facts。需 --enable-algo-orders 与 trade:real。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":900001,"trd_market":2},"initial":{"idempotency_key":"algo-modify-1","order_id":"ORDER_ID","order_version":1,"new_qty":"200","algo":{"algo_type":2,"start_time":1788138000000000,"end_time":1788141600000000,"vwap":{"participation_rate":"0.25"}}},"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/modify-algo-order

`POST /api/trd/modify-order-group`¶

proto_id: TRD_MODIFY_ORDER_GROUP (22718)

Scope: trade:real

真实资金写入，默认关闭：只接受当前权威订单快照中同一服务器订单组；需 --enable-group-orders 与 trade:real。结果未知时禁止自动重发。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":900001,"trd_market":2},"initial":{"idempotency_key":"group-modify-demo-1","group_type":3,"order_list":[{"order_id":"ORDER_ID","order_version":1,"new_price":"101"}]},"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/modify-order-group

`POST /api/trd/place-algo-order`¶

proto_id: TRD_PLACE_ALGO_ORDER (22721)

Scope: trade:real

真实资金写入，默认关闭：需显式启用 --enable-algo-orders，并通过 trade:real、source-pinned 产品/market-limit/方向/整手矩阵、live order_ability_config_v3、动态 customer-company、所需 BCAN、静态标的、broker/cipher 与 durable intent 门禁。接口提供六种算法的 typed market/limit 变体，但仅源码表允许的交集可发送（例如 US 拒绝 Slicer/Peg 与 Iceberg market，CN/HK common/HK futures 也按各自行执行）；当前为 source-aligned + local-green，真实 backend 未验证。结果未知时禁止自动重发。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":900001,"trd_market":2},"initial":{"idempotency_key":"algo-demo-1","client_order_id":"algo-client-1","code":"AAPL","sec_market":2,"trd_side":1,"qty":"100","price_mode":2,"limit_price":"100","lot_type":2,"order_trade_time_type":1,"position_open_type":1,"pdt_protection":true,"algo":{"algo_type":2,"start_time":1788138000000000,"end_time":1788141600000000,"vwap":{"participation_rate":"0.25"}}},"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/place-algo-order

`POST /api/trd/place-order-group`¶

proto_id: TRD_PLACE_ORDER_GROUP (22717)

Scope: trade:real

真实资金写入，默认关闭：需显式启用 --enable-group-orders，并通过 trade:real、账户/券商/cipher/capability 与 durable intent 门禁。当前仅有 source-aligned + local-green 证据，真实 backend 行为未验证；超时或断线返回结果未知且不会自动重发。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":900001,"trd_market":2},"initial":{"idempotency_key":"group-demo-1","group_type":3,"order_list":[{"acc_id":900001,"client_order_id":"leg-1","code":"AAPL","sec_market":2,"trd_side":1,"order_type":1,"qty":"1","price":"100","lot_type":2,"time_in_force":0,"order_trade_time_type":1,"children_relation":0,"brother_relation":0}],"pdt_protection":true},"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/place-order-group

`POST /api/trd/reverse-position`¶

proto_id: TRD_REVERSE_POSITION (22724)

Scope: trade:real

真实资金写入，默认关闭：只接受 fresh 权威持仓和完整 stock-list 普通月度期货事实；关闭腿与隐式开仓腿的 symbol/side/notional 必须原子授权。单次后端请求后，只有 fresh 当前订单快照与 order-group details 同时证明两个不同订单属于同一 relation_type=1 组，且两腿 symbol/side/qty/static identity 全部吻合才成功；未知结果不自动重发。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":900001,"trd_market":5},"initial":{"idempotency_key":"reverse-demo-1","position_id":9001,"price_type":1},"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/reverse-position

`POST /api/trd/roll-position`¶

proto_id: TRD_ROLL_POSITION (22725)

Scope: trade:real

真实资金写入，默认关闭：源/目标必须是不同的普通月度期货且共享非零 linkage_future_id；源关闭腿与目标开仓腿分别校验 symbol/side。后端请求不携带目标价格，daemon 不把行情缓存冒充交易 notional，因此配置了单笔/日金额上限的 API key 会 fail closed。单次后端请求后必须由 fresh 当前订单快照 + order-group details 完整证明两个 relation_type=2 成员。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"header":{"trd_env":1,"acc_id":900001,"trd_market":5},"initial":{"idempotency_key":"roll-demo-1","position_id":9001,"target_code":"HSI2610","target_sec_market":1},"extension_version":1}' \
  https://127.0.0.1:22499/api/trd/roll-position

`POST /api/trd/set-account-auto-exchange-setting`¶

proto_id: TRD_SET_ACCOUNT_AUTO_EXCHANGE_SETTING (2132803622)

Scope: trade:real

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/set-account-auto-exchange-setting

`POST /api/trd/set-account-financing-setting`¶

proto_id: TRD_SET_ACCOUNT_FINANCING_SETTING (2132803620)

Scope: trade:real

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/set-account-financing-setting

`POST /api/trd/set-account-foreign-exchange-setting`¶

proto_id: TRD_SET_ACCOUNT_FOREIGN_EXCHANGE_SETTING (2132803624)

Scope: trade:real

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/set-account-foreign-exchange-setting

`POST /api/trd/set-account-local-exchange-setting`¶

proto_id: TRD_SET_ACCOUNT_LOCAL_EXCHANGE_SETTING (2132803626)

Scope: trade:real

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/trd/set-account-local-exchange-setting

`POST /api/unlock-trade`¶

proto_id: TRD_UNLOCK_TRADE (2005)

Scope: trade:unlock

传输边界：支持通过 daemon 原生 HTTPS 从远程调用。配置 rest_tls_cert 和 rest_tls_key，客户端验证证书，并使用具有 trade:unlock scope 的 API Key。配置 API Key 后，即使是 loopback listener 也必须启用 TLS；反向代理的上游同样应使用 HTTPS。非 loopback 明文请求若到达该路由，会返回 403 和诊断键 rest.unlock_trade.local_transport_required；向 TLS listener 发送明文则无法完成 TLS 握手。 Forwarded / X-Forwarded-Proto 等请求头不能替代真实 TLS。账户白名单限制仍生效。

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"unlock":true,"pwd_md5":"<md5-of-trade-password>"}' \
  https://127.0.0.1:22499/api/unlock-trade

`POST /api/unsub-acc-push`¶

proto_id: — (non-proto / 无 backend 转发)

Scope: acc:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{"acc_id_list":[123456]}' \
  https://127.0.0.1:22499/api/unsub-acc-push

量化策略 / 云同步¶

量化策略与归档云同步、云端额度及运行数据维护。读写 scope 与配置要求见各接口。

`POST /api/create-quant-cloud-archives`¶

proto_id: QOT_CREATE_QUANT_CLOUD_ARCHIVES (2131755081)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/create-quant-cloud-archives

`POST /api/create-quant-cloud-strategies`¶

proto_id: QOT_CREATE_QUANT_CLOUD_STRATEGIES (2131755077)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/create-quant-cloud-strategies

`POST /api/delete-quant-cloud-archives`¶

proto_id: QOT_DELETE_QUANT_CLOUD_ARCHIVES (2131755083)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/delete-quant-cloud-archives

`POST /api/delete-quant-cloud-strategies`¶

proto_id: QOT_DELETE_QUANT_CLOUD_STRATEGIES (2131755079)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/delete-quant-cloud-strategies

`POST /api/get-quant-cloud-archives`¶

proto_id: QOT_GET_QUANT_CLOUD_ARCHIVES (2131755080)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-quant-cloud-archives

`POST /api/get-quant-cloud-quota`¶

proto_id: QOT_GET_QUANT_CLOUD_QUOTA (2131755084)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-quant-cloud-quota

`POST /api/get-quant-cloud-strategies`¶

proto_id: QOT_GET_QUANT_CLOUD_STRATEGIES (2131755076)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-quant-cloud-strategies

`POST /api/get-quant-running-data`¶

proto_id: QOT_GET_QUANT_RUNNING_DATA (2131755087)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-quant-running-data

`POST /api/get-quant-running-inventory`¶

proto_id: QOT_GET_QUANT_RUNNING_INVENTORY (2131755086)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/get-quant-running-inventory

`POST /api/update-quant-cloud-archive`¶

proto_id: QOT_UPDATE_QUANT_CLOUD_ARCHIVE (2131755082)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/update-quant-cloud-archive

`POST /api/update-quant-cloud-strategy`¶

proto_id: QOT_UPDATE_QUANT_CLOUD_STRATEGY (2131755078)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/update-quant-cloud-strategy

`POST /api/upsert-quant-running-data`¶

proto_id: QOT_UPSERT_QUANT_RUNNING_DATA (2131755088)

Scope: qot:read

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/upsert-quant-running-data

管理 (admin)¶

守护进程管理 endpoint。需 admin scope。

运行时契约: - GET /api/admin/status: 同步只读快照, 含 last_reload_refresh 字段 (never_run / running / succeeded / failed / skipped / not_applicable) 监控后台 reload 进度. - POST /api/admin/shutdown: 同步 200 后通过 daemon shutdown signal 触发守护进程退出. - POST /api/admin/reload: 同步阶段清 cipher cache 立即返响应; credentials 刷新走后台异步, 通过 /api/admin/status 的 last_reload_refresh 查终态.

Body 校验: POST /api/admin/shutdown + POST /api/admin/reload 仅接受空 body / {} / null. 任何 user-supplied 字段返 400 (handler 完全不读 body).

`POST /api/admin/reload`¶

proto_id: — (non-proto / 无 backend 转发)

Scope: admin

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/admin/reload

`POST /api/admin/shutdown`¶

proto_id: — (non-proto / 无 backend 转发)

Scope: admin

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

示例:

curl -X POST -H "Authorization: Bearer $FUTU_API_KEY" -H 'Content-Type: application/json' \
  -d '{}' \
  https://127.0.0.1:22499/api/admin/shutdown

`GET /api/admin/status`¶

proto_id: — (non-proto / 无 backend 转发)

Scope: admin

参数 / 返回：以本接口字段表及链接合同为准；示例仅展示请求形状。

platform 与每个 brokers[] 条目额外包含 lifecycle_state、 lifecycle_generation 和可选 last_lifecycle_event。Broker 的重连计数与最近 attempt/success/failure 时间戳来自同一生命周期快照，可用于判断状态是否仍在推进。

示例:

curl -H "Authorization: Bearer $FUTU_API_KEY" \
  https://127.0.0.1:22499/api/admin/status

REST API 接口目录¶

全局约定¶

系统 / 状态¶

GET /api/delay-statistics¶

POST /api/delay-statistics¶

GET /api/global-state¶

GET /api/ping¶

GET /api/push-subscriber-info¶

GET /api/quote-rights¶

GET /api/user-info¶

POST /api/verification¶

行情订阅¶

POST /api/query-subscription¶

GET /api/sub-info¶

POST /api/subscribe¶

POST /api/unsubscribe¶

GET /ws¶

行情查询¶

POST /api/bond-quote-info¶

POST /api/broker¶

POST /api/capital-distribution¶

POST /api/capital-flow¶

POST /api/chip-distribution¶

POST /api/forex-rates¶

POST /api/history-kl-quota¶

POST /api/history-kline¶

POST /api/kline¶

POST /api/kline-pattern¶

POST /api/kline-pattern-catalog¶

POST /api/kline-pattern-performance¶

POST /api/kline-pattern-statistics¶

POST /api/kline-pattern-stocks¶

POST /api/market-state¶

POST /api/multi-day-volume-averages¶

POST /api/orderbook¶

POST /api/quote¶

GET /api/quote-capability¶

POST /api/request-hk-option-quote¶

GET /api/risk-free-rate¶

POST /api/risk-free-rate¶

POST /api/rt¶

POST /api/search-quote¶

POST /api/set-tape-reading-subscription¶

POST /api/snapshot¶

GET /api/spread-table¶

POST /api/spread-table¶

POST /api/static-info¶

POST /api/stock-advanced-indicators¶

POST /api/tape-reading-events¶

POST /api/tape-reading-statistics¶

POST /api/ticker¶

POST /api/ticker-statistic¶

POST /api/ticker-statistic-detail¶

POST /api/used-quota¶

板块 / 筛选 / 元数据¶

POST /api/bond-screen¶

POST /api/code-change¶

POST /api/etf-screen¶

POST /api/forex-constituents¶

POST /api/fund-screen¶

POST /api/future-screen¶

POST /api/indicator-list¶

POST /api/industrial-chain-by-plate¶

POST /api/industrial-chain-detail¶

POST /api/industrial-chain-list¶

POST /api/industrial-plate-info¶

POST /api/industrial-plate-stock¶

POST /api/ipo-list¶

POST /api/list-plates¶

POST /api/market-trading-sessions¶

POST /api/plate-security¶

POST /api/plate-set¶

POST /api/security-trading-sessions¶

POST /api/stock-filter¶

POST /api/suspend¶

POST /api/trading-days¶

参考资料 / 衍生品¶

POST /api/bond-redemptions¶

POST /api/calendar-future-spreads¶

POST /api/calendar-future-underlyings¶

`GET /api/delay-statistics`¶

`POST /api/delay-statistics`¶

`GET /api/global-state`¶

`GET /api/ping`¶

`GET /api/push-subscriber-info`¶

`GET /api/quote-rights`¶

`GET /api/user-info`¶

`POST /api/verification`¶

`POST /api/query-subscription`¶

`GET /api/sub-info`¶

`POST /api/subscribe`¶

`POST /api/unsubscribe`¶

`GET /ws`¶

`POST /api/bond-quote-info`¶

`POST /api/broker`¶

`POST /api/capital-distribution`¶

`POST /api/capital-flow`¶

`POST /api/chip-distribution`¶

`POST /api/forex-rates`¶

`POST /api/history-kl-quota`¶

`POST /api/history-kline`¶

`POST /api/kline`¶

`POST /api/kline-pattern`¶

`POST /api/kline-pattern-catalog`¶

`POST /api/kline-pattern-performance`¶

`POST /api/kline-pattern-statistics`¶

`POST /api/kline-pattern-stocks`¶

`POST /api/market-state`¶

`POST /api/multi-day-volume-averages`¶

`POST /api/orderbook`¶

`POST /api/quote`¶

`GET /api/quote-capability`¶

`POST /api/request-hk-option-quote`¶

`GET /api/risk-free-rate`¶

`POST /api/risk-free-rate`¶

`POST /api/rt`¶

`POST /api/search-quote`¶

`POST /api/set-tape-reading-subscription`¶

`POST /api/snapshot`¶

`GET /api/spread-table`¶

`POST /api/spread-table`¶

`POST /api/static-info`¶

`POST /api/stock-advanced-indicators`¶

`POST /api/tape-reading-events`¶

`POST /api/tape-reading-statistics`¶

`POST /api/ticker`¶

`POST /api/ticker-statistic`¶

`POST /api/ticker-statistic-detail`¶

`POST /api/used-quota`¶

`POST /api/bond-screen`¶

`POST /api/code-change`¶

`POST /api/etf-screen`¶

`POST /api/forex-constituents`¶

`POST /api/fund-screen`¶

`POST /api/future-screen`¶

`POST /api/indicator-list`¶

`POST /api/industrial-chain-by-plate`¶

`POST /api/industrial-chain-detail`¶

`POST /api/industrial-chain-list`¶

`POST /api/industrial-plate-info`¶

`POST /api/industrial-plate-stock`¶

`POST /api/ipo-list`¶

`POST /api/list-plates`¶

`POST /api/market-trading-sessions`¶

`POST /api/plate-security`¶

`POST /api/plate-set`¶

`POST /api/security-trading-sessions`¶

`POST /api/stock-filter`¶

`POST /api/suspend`¶

`POST /api/trading-days`¶

`POST /api/bond-redemptions`¶

`POST /api/calendar-future-spreads`¶

`POST /api/calendar-future-underlyings`¶

`POST /api/cbbc-basic-info`¶

`POST /api/cbbc-distribution`¶

`POST /api/company-executive-background`¶

`POST /api/company-executives`¶

`POST /api/company-operational-efficiency`¶

`POST /api/company-profile`¶

`POST /api/corporate-actions-buybacks`¶