{"id":47725,"library":"futu-api","title":"futu-api","description":"富途证券官方 Websocket API 的 Node.js 封装，版本 10.7.6708（2024年）。提供行情订阅、交易下单、账户查询等接口，支持港股、美股、A股市场。与利弗莫尔证券或其他第三方 API 不同，这是富途官方维护的包，更新频繁（每月多个版本），使用 Protobuf 协议，需搭配 FutuOpenD 桌面端使用。自 2021 年 4 月起由富途官方维护，版本号自成体系（非语义化）。","status":"active","version":"10.7.6708","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","futu","api","futu-api","futuopend"],"install":[{"cmd":"npm install futu-api","lang":"bash","label":"npm"},{"cmd":"yarn add futu-api","lang":"bash","label":"yarn"},{"cmd":"pnpm add futu-api","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"用于解析 Protobuf 协议消息","package":"protobufjs","optional":false}],"imports":[{"note":"包提供 CommonJS 和 ESM 双格式，Node.js 推荐使用 import 或 require。","wrong":"const futuApi = require('futu-api')","symbol":"FutuAPI","correct":"import { FutuAPI } from 'futu-api'"},{"note":"默认导出与命名导出均为 FutuAPI，写法等价。","wrong":"","symbol":"FutuAPI","correct":"import FutuAPI from 'futu-api'"},{"note":"CommonJS 中命名导出也可使用。","wrong":"","symbol":"FutuAPI","correct":"const { FutuAPI } = require('futu-api')"}],"quickstart":{"code":"import { FutuAPI } from 'futu-api';\n\nconst api = new FutuAPI({\n  host: process.env.FUTU_HOST ?? '127.0.0.1',\n  port: parseInt(process.env.FUTU_PORT ?? '11111'),\n  password: process.env.FUTU_PASSWORD ?? '',\n});\n\nasync function main() {\n  await api.connect();\n  // 订阅行情\n  const code = 'HK.00700';\n  const subType = 1; // 1: 逐笔\n  await api.subscribe([code], [subType]);\n  console.log(`已订阅 ${code}`);\n  // 获取基本信息\n  const stockInfo = await api.getStockBasicInfo([code]);\n  console.log(stockInfo);\n  api.close();\n}\n\nmain().catch(console.error);","lang":"typescript","description":"初始化 FutuAPI 客户端，连接本地 FutuOpenD 进程，订阅股票行情并获取基本信息。"},"warnings":[{"fix":"在 package.json 中直接锁定精确版本，不要使用 ^ 或 ~ 前缀。","message":"版本号规则与 npm 语义化版本不同，10.7.6708 不能视为 major.minor.patch","severity":"breaking","affected_versions":">1.0"},{"fix":"升级到 v10 后改用 import { FutuAPI } from 'futu-api' 或 const { FutuAPI } = require('futu-api')。","message":"旧版 require('futu-api') 默认导出行为可能不同，建议检查文档","severity":"deprecated","affected_versions":"<10.0"},{"fix":"从富途官网下载最新版 FutuOpenD 并保持运行。","message":"必须本地运行 FutuOpenD 进程，且版本需与 api 版本匹配","severity":"gotcha","affected_versions":">=1.0"},{"fix":"控制订阅频率，建议使用队列机制，参考官方示例。","message":"行情订阅有频率限制，超过阈值会被断开连接","severity":"gotcha","affected_versions":">=1.0"}],"env_vars":null,"search_vec":"'10.7.6708':11 '2021':32 '2024年':12 '4':34 'api':3,6,20,40,43 'a股市场':18 'futu':2,39,42 'futu-api':1,41 'futuopend':29,44 'javascript':38 'node.js':8 'protobuf':26 'websocket':5 '不同':21 '与利弗莫尔证券或其他第三方':19 '交易下单':14 '使用':25 '协议':27 '富途证券官方':4 '封装':9 '年':33 '提供行情订阅':13 '支持港股':16 '更新频繁':23 '月起由富途官方维护':35 '桌面端使用':30 '每月多个版本':24 '版本':10 '版本号自成体系':36 '的':7 '美股':17 '自':31 '账户查询等接口':15 '这是富途官方维护的包':22 '需搭配':28 '非语义化':37","created_at":"2026-06-07T16:52:58.905190+00:00","updated_at":"2026-06-07T16:52:58.905190+00:00","problems":[{"fix":"启动 FutuOpenD 并检查 host/port 配置。","cause":"FutuOpenD 未运行或端口错误","error":"Error: connect ECONNREFUSED 127.0.0.1:11111"},{"fix":"使用 const { FutuAPI } = require('futu-api') 或 import { FutuAPI } from 'futu-api'。","cause":"使用了错误的导入方式","error":"TypeError: FutuAPI is not a constructor"},{"fix":"确保传入正确的 login password（富途交易密码）。","cause":"密码错误或未设置","error":"Error: Auth failed, check password"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"futu-api","openapi_spec":null,"status_page":null,"smithery":null,"categories":["finance"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}