v1.4.26 Rust · 2021 edition Proprietary Free Software

FUTU-OpenD-rs¶

富途 OpenD 行情交易网关的 Rust 实现 —— 与 C++ 线上版本零细节差异，扩展 REST / gRPC / WebSocket / CLI / MCP 五条现代接口，开箱即用的 scope + 限额 + 审计 + Prometheus 全套生产护栏。

brew install futuleaf/tap/futu-opend-rs

快速开始下载教程

为什么选它¶

Rust 原生性能

零成本抽象、无 GC、内存安全。替换 C++ OpenD 不掉性能，编译产物 11 MB 单二进制直接跑。
四条入口全线护栏

REST / gRPC / 核心 WS / MCP 四个入口共享同一套 Scope + 速率 / 日累计 / 市场白名单 + JSONL 审计 + Prometheus /metrics。
LLM 原生友好

Model Context Protocol stdio + HTTP 双 transport，19 工具，per-call API key 多租户，audit 按 key_id 分账。
生产即插即用

SIGHUP 热重载 · 软机器绑定 · fail-closed 路由 · Dockerfile + systemd 模板 · 证书 & metrics 开箱配好。

3 步上手¶

1. 安装

brew install futuleaf/tap/futu-opend-rs

macOS / Linux 一行命令。Windows 用户从下载页拿 zip。

2. 启动网关

futu-opend \
  --login-account 你的富途账号 \
  --login-pwd 你的密码 \
  --rest-port 22222

日志会刷到INFO futu-net connected。REST 服务已经在 :22222/health 等候。

3. 验证 + 第一次下单

# 查 HK 报价
futucli quote HK.00700

# 账户列表
curl http://127.0.0.1:22222/api/trd/get-acc-list

# 解锁交易后可下模拟单
futucli unlock-trade --env simulate
futucli place-order --symbol HK.00700 --side buy --qty 100 --env simulate

5 条接口一览¶

接口	默认地址	适合谁
FTAPI TCP	`:11111`	官方 futu-api SDK 原生协议
REST HTTP	`:22222/api/*`	浏览器、脚本、curl
WebSocket	`:22222/ws`	实时推送（JSON + base64 body）
gRPC	`:33333`	跨语言、流式推送
MCP	stdio / HTTP	LLM agent（Claude、GPT、等）

一眼看懂定位¶

完全协议兼容 —— 现有 futu-api Python / C++ SDK 零改代码即可换过来 单二进制部署 —— 无 JVM、无 Python 运行时、无 docker 依赖 热重载吊销 key —— SIGHUP 秒级生效，不用重启 LLM 工具箱内置 —— futu-mcp 19 工具开箱，带 scope 和限额 和 C++ OpenD 零行为差异 —— 协议 / 字段 / 错误码全对齐