REST API 完整参考¶

v1.4.85 新增. 本文件由 FutuOpenD-rs 自动生成工具产出, 跟随 daemon 每个 release 版本更新.

本页涵盖 futu-opend REST API 全部 68 个 endpoint, 按功能分 9 组. 每 endpoint 给出:

HTTP 方法 + URL
Backend proto_id
需要的 scope (auth)
参数说明 (见 proto 定义)
错误提示
curl 示例

快速导航:

组	Endpoint 数	链接
系统 / 状态	6	系统 / 状态
行情订阅	5	行情订阅
行情查询	13	行情查询
板块 / 筛选 / 元数据	8	板块 / 筛选 / 元数据
参考资料 / 衍生品	11	参考资料 / 衍生品
到价提醒	2	到价提醒
交易账户	14	交易账户
交易写入	6	交易写入
管理 (admin)	3	管理 (admin)

全局约定¶

Base URL: http://127.0.0.1:22499 (默认 REST 端口, 可通过 --rest-port 改)
Content-Type: application/json
Auth: Authorization: Bearer <API_KEY> (若配了 keys.json; 否则 legacy 模式无 auth — 但见 CLAUDE.md SEC-003 Q4)

响应结构:

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

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

字段命名: v1.4.83+ 支持 alias (SDK 风格 code / stocks / trd_env 等), canonical 是 snake_case (symbol / symbols / env). v1.4.84+ 支持 int OR string 双接 (enum 字段). 未知字段 v1.4.84 起 loud fail (unknown field error).
限额: 启动参数 --allowed-markets / --max-order-value 等控制. 详见 docs/guide/auth.md.

系统 / 状态¶

健康检查、全局状态、用户信息、延迟统计。无需 auth。

`GET /api/delay-statistics`¶

proto_id: GET_DELAY_STATISTICS (1006)

Scope: — (public)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -H 'Authorization: Bearer $FUTU_API_KEY' \
  http://127.0.0.1:22499/api/delay-statistics

`POST /api/delay-statistics`¶

proto_id: GET_DELAY_STATISTICS (1006)

Scope: — (public)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`GET /api/global-state`¶

proto_id: GET_GLOBAL_STATE (1002)

Scope: — (public)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -H 'Authorization: Bearer $FUTU_API_KEY' \
  http://127.0.0.1:22499/api/global-state

`GET /api/ping`¶

proto_id: GET_GLOBAL_STATE (1002)

Scope: — (public)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -H 'Authorization: Bearer $FUTU_API_KEY' \
  http://127.0.0.1:22499/api/ping

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

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

Scope: — (public)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`GET /api/user-info`¶

proto_id: GET_USER_INFO (1005)

Scope: — (public)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -H 'Authorization: Bearer $FUTU_API_KEY' \
  http://127.0.0.1:22499/api/user-info

行情订阅¶

订阅 / 取消订阅行情推送，查询订阅状态。WebSocket /ws 接收推送。

`POST /api/query-subscription`¶

proto_id: QOT_GET_SUB_INFO (3003)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`GET /api/sub-info`¶

proto_id: QOT_GET_SUB_INFO (3003)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -H 'Authorization: Bearer $FUTU_API_KEY' \
  http://127.0.0.1:22499/api/sub-info

`POST /api/subscribe`¶

proto_id: QOT_SUB (3001)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/unsubscribe`¶

proto_id: QOT_SUB (3001)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`GET /ws`¶

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

Scope: — (public)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -H 'Authorization: Bearer $FUTU_API_KEY' \
  http://127.0.0.1:22499/ws

行情查询¶

实时行情、K 线、摆盘、经纪队列、分时、成交明细。需 qot:read。

`POST /api/broker`¶

proto_id: QOT_GET_BROKER (3014)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/capital-distribution`¶

proto_id: QOT_GET_CAPITAL_DISTRIBUTION (3212)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/capital-flow`¶

proto_id: QOT_GET_CAPITAL_FLOW (3211)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/capital-flow

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

proto_id: QOT_REQUEST_HISTORY_KL_QUOTA (3104)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/history-kline`¶

proto_id: QOT_REQUEST_HISTORY_KL (3103)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700","kl_type":"day","count":100}' \
  http://127.0.0.1:22499/api/history-kline

`POST /api/kline`¶

proto_id: QOT_GET_KL (3006)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/market-state`¶

proto_id: QOT_GET_MARKET_STATE (3223)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/market-state

`POST /api/orderbook`¶

proto_id: QOT_GET_ORDER_BOOK (3012)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/quote`¶

proto_id: QOT_GET_BASIC_QOT (3004)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/rt`¶

proto_id: QOT_GET_RT (3008)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/snapshot`¶

proto_id: QOT_GET_SECURITY_SNAPSHOT (3203)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/static-info`¶

proto_id: QOT_GET_STATIC_INFO (3202)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/ticker`¶

proto_id: QOT_GET_TICKER (3010)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

板块 / 筛选 / 元数据¶

板块列表、板块成分、股票筛选、交易日、停牌、代码变更、IPO 日历。

`POST /api/code-change`¶

proto_id: QOT_GET_CODE_CHANGE (3216)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/code-change

`POST /api/ipo-list`¶

proto_id: QOT_GET_IPO_LIST (3217)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/list-plates`¶

proto_id: QOT_GET_PLATE_SET (3204)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/plate-security`¶

proto_id: QOT_GET_PLATE_SECURITY (3205)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/plate-security

`POST /api/plate-set`¶

proto_id: QOT_GET_PLATE_SET (3204)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/stock-filter`¶

proto_id: QOT_STOCK_FILTER (3215)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/suspend`¶

proto_id: QOT_GET_SUSPEND (3201)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/suspend

`POST /api/trading-days`¶

proto_id: QOT_REQUEST_TRADE_DATE (3219)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/trading-days

参考资料 / 衍生品¶

正股关联窝轮、期权链、期权到期日、期货合约信息、复权、自选股、持股变动。

`POST /api/future-info`¶

proto_id: QOT_GET_FUTURE_INFO (3218)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/get-reference`¶

proto_id: QOT_GET_REFERENCE (3206)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/holding-change`¶

proto_id: QOT_GET_HOLDING_CHANGE_LIST (3208)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/holding-change

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

proto_id: QOT_MODIFY_USER_SECURITY (3214)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/modify-user-security

`POST /api/option-chain`¶

proto_id: QOT_GET_OPTION_CHAIN (3209)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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"}' \
  http://127.0.0.1:22499/api/option-chain

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

proto_id: QOT_GET_OPTION_EXPIRATION_DATE (3224)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/option-expiration-date

`POST /api/owner-plate`¶

proto_id: QOT_GET_OWNER_PLATE (3207)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/owner-plate

`POST /api/reference`¶

proto_id: QOT_GET_REFERENCE (3206)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/reference

`POST /api/rehab`¶

proto_id: QOT_REQUEST_REHAB (3105)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/rehab

`POST /api/user-security`¶

proto_id: QOT_GET_USER_SECURITY (3213)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/warrant`¶

proto_id: QOT_GET_WARRANT (3210)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/warrant

到价提醒¶

查询 / 设置 / 修改 / 删除到价提醒。需 qot:read。

`POST /api/price-reminder`¶

proto_id: QOT_GET_PRICE_REMINDER (3221)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

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

proto_id: QOT_SET_PRICE_REMINDER (3220)

Scope: qot:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{"symbol":"HK.00700","op":"SetAdd","reminder_type":1,"value":300.0}' \
  http://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

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/acc-cash-flow

`GET /api/accounts`¶

proto_id: TRD_GET_ACC_LIST (2001)

Scope: acc:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -H 'Authorization: Bearer $FUTU_API_KEY' \
  http://127.0.0.1:22499/api/accounts

`POST /api/flow-summary`¶

proto_id: TRD_FLOW_SUMMARY (2226)

Scope: acc:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/flow-summary

`POST /api/funds`¶

proto_id: TRD_GET_FUNDS (2101)

Scope: acc:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

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

proto_id: TRD_GET_HISTORY_ORDER_FILL_LIST (2222)

Scope: acc:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/history-orders`¶

proto_id: TRD_GET_HISTORY_ORDER_LIST (2221)

Scope: acc:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`GET /api/list-accounts`¶

proto_id: TRD_GET_ACC_LIST (2001)

Scope: acc:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -H 'Authorization: Bearer $FUTU_API_KEY' \
  http://127.0.0.1:22499/api/list-accounts

`POST /api/margin-ratio`¶

proto_id: TRD_GET_MARGIN_RATIO (2223)

Scope: acc:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

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

proto_id: TRD_GET_MAX_TRD_QTYS (2111)

Scope: acc:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/max-trd-qtys

`POST /api/order-fee`¶

proto_id: TRD_GET_ORDER_FEE (2225)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/order-fills`¶

proto_id: TRD_GET_ORDER_FILL_LIST (2211)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/orders`¶

proto_id: TRD_GET_ORDER_LIST (2201)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/positions`¶

proto_id: TRD_GET_POSITION_LIST (2102)

Scope: acc:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

`POST /api/reconfirm-order`¶

proto_id: TRD_RECONFIRM_ORDER (2237)

Scope: acc:read

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

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

交易写入¶

下单、改单 / 撤单、一键撤全部、解锁交易 cipher、账户 push 订阅。需 trade:real / trade:simulate + --enable-trading。

`POST /api/cancel-all-order`¶

proto_id: TRD_MODIFY_ORDER (2205)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{"acc_id":123456,"env":"simulate","market":"HK"}' \
  http://127.0.0.1:22499/api/cancel-all-order

`POST /api/modify-order`¶

proto_id: TRD_MODIFY_ORDER (2205)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{"market":"HK","acc_id":123456,"order_id":"987","op":"CANCEL"}' \
  http://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)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{"market":"HK","acc_id":123456,"env":"simulate","side":"BUY","code":"00700","qty":100,"price":300.0}' \
  http://127.0.0.1:22499/api/order

`POST /api/sub-acc-push`¶

proto_id: TRD_SUB_ACC_PUSH (2008)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/sub-acc-push

`POST /api/unlock-trade`¶

proto_id: TRD_UNLOCK_TRADE (2005)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{"unlock":true,"pwd_md5":"<md5-of-trade-password>"}' \
  http://127.0.0.1:22499/api/unlock-trade

`POST /api/unsub-acc-push`¶

proto_id: TRD_SUB_ACC_PUSH (2008)

Scope: trade:real or trade:simulate (based on env)

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/unsub-acc-push

管理 (admin)¶

守护进程管理 endpoint。需 admin scope。

`POST /api/admin/reload`¶

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

Scope: admin

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/admin/reload

`POST /api/admin/shutdown`¶

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

Scope: admin

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -X POST -H 'Authorization: Bearer $FUTU_API_KEY' -H 'Content-Type: application/json' \
  -d '{}' \
  http://127.0.0.1:22499/api/admin/shutdown

`GET /api/admin/status`¶

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

Scope: admin

参数 / 返回: 见 proto 定义. 字段 snake_case, 支持 v1.4.83+ alias + v1.4.84+ enum int/string 双接.

示例:

curl -H 'Authorization: Bearer $FUTU_API_KEY' \
  http://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/user-info¶

行情订阅¶

POST /api/query-subscription¶

GET /api/sub-info¶

POST /api/subscribe¶

POST /api/unsubscribe¶

GET /ws¶

行情查询¶

POST /api/broker¶

POST /api/capital-distribution¶

POST /api/capital-flow¶

POST /api/history-kl-quota¶

POST /api/history-kline¶

POST /api/kline¶

POST /api/market-state¶

POST /api/orderbook¶

POST /api/quote¶

POST /api/rt¶

POST /api/snapshot¶

POST /api/static-info¶

POST /api/ticker¶

板块 / 筛选 / 元数据¶

POST /api/code-change¶

POST /api/ipo-list¶

POST /api/list-plates¶

POST /api/plate-security¶

POST /api/plate-set¶

POST /api/stock-filter¶

POST /api/suspend¶

POST /api/trading-days¶

参考资料 / 衍生品¶

POST /api/future-info¶

POST /api/get-reference¶

POST /api/holding-change¶

POST /api/modify-user-security¶

POST /api/option-chain¶

POST /api/option-expiration-date¶

POST /api/owner-plate¶

POST /api/reference¶

POST /api/rehab¶

POST /api/user-security¶

POST /api/warrant¶

到价提醒¶

POST /api/price-reminder¶

POST /api/set-price-reminder¶

交易账户¶

POST /api/acc-cash-flow¶

GET /api/accounts¶

POST /api/flow-summary¶

POST /api/funds¶

POST /api/history-order-fills¶

POST /api/history-orders¶

GET /api/list-accounts¶

POST /api/margin-ratio¶

POST /api/max-trd-qtys¶

POST /api/order-fee¶

POST /api/order-fills¶

POST /api/orders¶

POST /api/positions¶

POST /api/reconfirm-order¶

交易写入¶

POST /api/cancel-all-order¶

POST /api/modify-order¶

POST /api/order¶

POST /api/sub-acc-push¶

POST /api/unlock-trade¶

POST /api/unsub-acc-push¶

管理 (admin)¶

POST /api/admin/reload¶

POST /api/admin/shutdown¶

GET /api/admin/status¶

更多信息¶

`GET /api/delay-statistics`¶

`POST /api/delay-statistics`¶

`GET /api/global-state`¶

`GET /api/ping`¶

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

`GET /api/user-info`¶

`POST /api/query-subscription`¶

`GET /api/sub-info`¶

`POST /api/subscribe`¶

`POST /api/unsubscribe`¶

`GET /ws`¶

`POST /api/broker`¶

`POST /api/capital-distribution`¶

`POST /api/capital-flow`¶

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

`POST /api/history-kline`¶

`POST /api/kline`¶

`POST /api/market-state`¶

`POST /api/orderbook`¶

`POST /api/quote`¶

`POST /api/rt`¶

`POST /api/snapshot`¶

`POST /api/static-info`¶

`POST /api/ticker`¶

`POST /api/code-change`¶

`POST /api/ipo-list`¶

`POST /api/list-plates`¶

`POST /api/plate-security`¶

`POST /api/plate-set`¶

`POST /api/stock-filter`¶

`POST /api/suspend`¶

`POST /api/trading-days`¶

`POST /api/future-info`¶

`POST /api/get-reference`¶

`POST /api/holding-change`¶

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

`POST /api/option-chain`¶

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

`POST /api/owner-plate`¶

`POST /api/reference`¶

`POST /api/rehab`¶

`POST /api/user-security`¶

`POST /api/warrant`¶

`POST /api/price-reminder`¶

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

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

`GET /api/accounts`¶

`POST /api/flow-summary`¶

`POST /api/funds`¶

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

`POST /api/history-orders`¶

`GET /api/list-accounts`¶

`POST /api/margin-ratio`¶

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

`POST /api/order-fee`¶

`POST /api/order-fills`¶

`POST /api/orders`¶

`POST /api/positions`¶

`POST /api/reconfirm-order`¶

`POST /api/cancel-all-order`¶

`POST /api/modify-order`¶

`POST /api/order`¶

`POST /api/sub-acc-push`¶

`POST /api/unlock-trade`¶

`POST /api/unsub-acc-push`¶

`POST /api/admin/reload`¶

`POST /api/admin/shutdown`¶

`GET /api/admin/status`¶