QPro 本地 API 使用说明
概述
QPro 本地 API 以只读 HTTP 方式，把账户、持仓、委托、成交快照，以及实时行情、实时与历史 K 线和合约信息提供给本机程序。配合 QPro Skills，用户可以直接让本地 AI Agent 完成个性化查询、监控、研究或可视化，不必先熟悉全部接口和字段。
先用 QPro Skills，让 AI 快速实现需求
如果使用支持 Skills 的本地 AI Agent，推荐先安装 QPro 自带的 Skills。Skills 已经整理好服务地址、数据结构、字段含义、查询限制，以及实时行情和 K 线的订阅方式，AI 可以据此选择正确的数据源，并生成查询、脚本或页面。
使用流程很简单：
按下文说明启用 QPro 本地 API，并重启、登录 QPro。
在 QPro 顶部菜单中点击
帮助->复制 skills，把复制出的安装提示发送给 AI Agent。让 Agent 按提示安装并阅读 QPro 安装目录
skills下的技能，然后直接描述希望实现的结果和业务规则。
QPro 帮助菜单中的 复制 skills 入口。
QPro Skills 对应四类数据能力：
账户数据查询：读取账户、持仓、委托和成交快照，适合统计、排查和只读风控监控。
实时行情订阅：按合约接收最新 Quote，适合行情看板、价格或价差监控。
合约信息查询：筛选合约和期权，读取合约属性、到期信息和交易时段等元数据。
实时与历史 K 线：持续获取最新 K 线，查询指定时间附近的历史窗口，或下载历史行情文件。
安装后，可以直接向 AI 描述需求，例如“按我的板块分类统计多账户盈亏”“监控可用资金并按规则提醒”“筛选未到期且有夜盘的黄金合约并展示实时行情”“查询成交前后的 1 分钟 K 线并生成复盘图”。Agent 会按照 Skills 中的规则调用本地 API，再把结果整理成所需的报表、监控脚本或可视化页面。
备注
QPro Skills 和本地 API 只提供数据访问能力，不提供下单、撤单或改单能力。交易操作仍由 QPro 自身的交易流程负责。
本地 API 概览
启用后，QPro 会提供四类本地服务：
数据类型 |
默认端口 |
主要接口 |
适用场景 |
|---|---|---|---|
账户数据 |
|
|
查询账户、持仓、委托和成交快照 |
实时行情 |
|
|
订阅单个合约的实时行情流 |
合约信息 |
|
|
筛选合约、查找期权和读取合约属性 |
K 线与历史行情 |
|
|
持续获取最新 K 线、查询历史 K 线窗口或下载历史行情 |
账户数据服务可以查询 AccountSnap、PositionSnap、OrderSnap、TradeSnap 四张快照表。实时行情、实时与历史 K 线和合约信息接口见 实时行情、K 线与合约信息 API。
启用本地 API 接口
使用 QPro 本地 API 前，需要先在 QPro 中手工启用接口。进入 系统 -> 选项 -> 选项设置。
从 QPro 的 系统 菜单进入 选项设置。
在 账户持仓监控 中，把 启用本地 Api 接口 设置为 是。QPro 会提示重启；确认重启并重新登录后，四个本地服务才会生效。默认端口分别为：账户数据 8811、实时行情 8812、合约信息 8813、K 线与历史行情 8814。
四个端口必须在 1 至 65535 范围内并且互不重复。修改端口后也需要重启 QPro；如果端口无效或重复，QPro 会恢复为默认端口。
在 账户持仓监控 中启用本地 API 接口，并查看各服务端口。新版还会显示默认端口为 8814 的历史行情 API 服务。
快速检查服务
重启并登录 QPro 后，可以在 PowerShell 中检查四个服务是否已启动：
Invoke-RestMethod http://127.0.0.1:8811/health
Invoke-RestMethod http://127.0.0.1:8812/health
Invoke-RestMethod http://127.0.0.1:8813/health
Invoke-RestMethod http://127.0.0.1:8814/health
四个请求都应返回 {"ok": true}。如果修改过端口，请把示例中的端口替换为自己的配置。其中 8814 的健康检查还会检查上游历史行情连接；上游暂不可用时会返回 HTTP 503 和 {"ok": false}。
示例一：自定义板块级别的盈亏统计
用户可以让 Agent 按自己的业务口径定义板块，例如把多个品种归为“黑色”“有色”“贵金属”，再统计持仓盈亏、浮动盈亏、平仓盈亏和手续费。
自定义板块盈亏看板示意：把多个品种按用户自己的规则归到板块，并展示盈亏、手续费和保证金。
用户只需说明板块口径和需要的指标，Agent 就可以根据 QPro Skills 中的账户表结构和查询规则生成查询，再按用户定义汇总。
示例二：更具个性化的风控通知
用户可以让 Agent 根据自己的规则组合多个表和多个条件，再触发本地弹窗、企业微信、飞书、短信或其他通知。例如：某些账户可用资金低于阈值、某些板块保证金过高、某些合约出现未完成委托时才提醒。
个性化风控通知示意：把账户、持仓、委托和成交状态组合成用户自己的提醒规则。
规则可以细化到不同账户、品种和交易时段，并设置重复提醒间隔。账户数据服务只提供只读查询，实际查询和通知逻辑由 Agent 或本地脚本完成。
示例三：可视化程度更高的展现方案
用户可以把 QPro 本地 API 接入 Streamlit、ECharts、Grafana、Jupyter Notebook 或内部网页。Agent 可以读取账户数据、订阅实时行情，并整理成账户-板块热力图、保证金占用排行、盈亏瀑布图或持仓变化时间线。
可视化展现示意：把 QPro 实时快照接入自建看板，按用户自己的观察方式展示账户、板块、风险和持仓变化。
这类方案可以把 QPro 的实时快照变成用户自己的看板。行情历史曲线可以直接通过 8814 查询历史 K 线；账户权益、持仓等私有快照的历史曲线仍需让 Agent 或外部程序定时轮询账户数据服务并自行保存。
示例四：实时行情监控与提醒
实时行情服务适合把用户关心的少量合约接入自定义监控。Agent 或脚本可以为每个合约建立 SSE 连接，接收完整行情快照，再计算价格突破、成交放量、盘口变化或跨合约价差。
实时行情监控示意：订阅自选合约，在一个页面中展示最新价、买卖盘、分时走势和自定义提醒。
实时行情接口优先保证最新状态。客户端消费过慢时，中间更新可能被覆盖，因此它更适合监控和展示，不应被当作逐笔不丢失的历史行情归档接口。
示例五：实时 K 线、历史查询与交易复盘
K 线与历史行情服务可以持续推送最新 K 线窗口，也可以围绕指定时间查询历史 K 线。持续推送适合分时图、K 线图和指标看板；历史查询适合把成交或委托时间与前后行情对齐，复盘入场环境、滑点和持仓期间的价格变化。
K 线与交易复盘示意：左侧持续更新最新 K 线，右侧围绕成交时间查看历史窗口，并标记入场、出场和复盘结论。
最新 K 线流会先发送完整窗口，随后更新当前未收盘 K 线或追加新 K 线。历史窗口查询需要当前账号具备多账户功能权限；接口参数、时间单位和示例见 实时行情、K 线与合约信息 API。
示例六：合约筛选与期权研究
合约信息服务可以按合约类型、交易所、品种、是否到期和是否有夜盘筛选合约，再查询最小变动价位、合约乘数、到期时间、涨跌停价和交易时段等属性；也可以按标的获取看涨或看跌期权列表。
合约研究示意：先筛选可交易合约，再读取合约属性和对应期权列表。
Agent 可以据此回答“未到期且有夜盘的黄金合约有哪些”“某合约的最小变动价位和乘数是多少”“某标的有哪些看涨期权”等问题。推荐先取得有效合约代码，再订阅实时行情或查询 K 线。
示例七：账户、合约与行情联动
四个服务可以组合使用：先读取多账户持仓，再补充合约名称、乘数、到期日和交易时段，订阅持仓合约的最新价格，最后按需读取实时或历史 K 线。这样可以构建跨账户风险看板、临近到期提醒、持仓行情异动提醒、交易复盘，或按自定义板块汇总实时风险敞口。
联动风险看板示意：由本地 Agent 组合 8811 至 8814 的持仓、实时行情、合约信息和 K 线数据，统一展示风险敞口与交易复盘结果。
四类服务都只提供数据，不提供下单、撤单或改单能力。交易操作仍由 QPro 自身的交易流程负责。
安全说明
四个服务都只监听本机 localhost，没有面向调用方的独立应用层鉴权，也不应通过端口转发、反向代理等方式暴露到不可信网络。账户、持仓、委托、成交和行情数据可能包含敏感信息，请只允许受信任的本机程序访问。QPro 会使用当前登录身份访问上游行情服务，并按账号功能与数据权限控制可用范围。
数据结构与字段
账户数据的四张表和字段含义见 QPro 本地 API 数据结构与字段说明，实际字段也可以随时通过 GET /tables 获取。实时行情、实时与历史 K 线和合约信息的接口、参数与返回值见 实时行情、K 线与合约信息 API。