快速开始

启用 API · 安装 Skills · 检查连接

QPro 本地 API 将交易快照、行情与合约信息、历史绩效数据提供给本机程序。你可以先安装 QPro Skills，让 AI 根据需求选择服务并生成脚本或页面；也可以直接按接口参考开发。

先用 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` 入口。

QPro Skills 对应五类数据能力：

账户数据查询：读取账户、持仓、委托和成交快照，适合统计、排查和只读风控监控。
实时行情订阅：按合约接收最新 Quote，适合行情看板、价格或价差监控。
合约信息查询：筛选合约和期权，读取合约属性、到期信息和交易时段等元数据。
实时与历史 K 线：持续获取最新 K 线和 Tick，查询指定时间附近的历史窗口，并由调用方按需保存结果。
历史绩效数据：通过 analyse-server-settlement-data 读取结算后的历史资金、成交和日终持仓，制作权益曲线、手续费统计和复盘报表。

安装后，可以直接向 AI 描述需求，例如“按我的板块分类统计多账户盈亏”“监控可用资金并按规则提醒”“筛选未到期且有夜盘的黄金合约并展示实时行情”“查询成交前后的 1 分钟 K 线并生成复盘图”。Agent 会按照 Skills 中的规则调用本地 API，再把结果整理成所需的报表、监控脚本或可视化页面。

备注

QPro Skills 和本地 API 只提供数据访问能力，不提供下单、撤单或改单能力。交易操作仍由 QPro 自身的交易流程负责。

启用本地 API 接口

使用 QPro 本地 API 前，需要先在 QPro 中手工启用接口。进入 系统 -> 选项 -> 选项设置。

QPro 系统菜单中的选项设置入口 — 从 QPro 的 `系统` 菜单进入 `选项设置`。

在 账户持仓监控 中，把 启用本地 Api 接口 设置为 是。QPro 会提示重启；确认重启并重新登录后，五个本地服务才会生效。默认端口分别为：账户数据 8811、实时行情 8812、合约信息 8813、K 线与历史行情 8814、历史绩效数据 8815。绩效分析 API 从 1.0.2608.904 起提供。

五个端口必须在 1 至 65535 范围内并且互不重复。修改端口后也需要重启 QPro；如果端口无效或重复，QPro 会恢复为默认端口。

在账户持仓监控中启用本地 Api 接口并配置服务端口 — 在 `账户持仓监控` 中启用本地 API 接口，并查看各服务端口。不同版本的选项可能有所区别；当前版本还包括默认端口为 `8814` 的历史行情服务和默认端口为 `8815` 的 `绩效分析 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
Invoke-RestMethod http://127.0.0.1:8815/health

前四个服务可用时返回 {"ok": true}；8815 返回 {"code": 0, "message": "ok", "data": {"database": "ok"}}。如果修改过端口，请把示例中的端口替换为自己的配置。其中 8814 的健康检查还会检查上游历史行情连接；上游暂不可用时会返回 HTTP 503 和 {"ok": false}。8815 的健康检查只确认本地数据库可用，首次使用还需按同步与解析结算数据同步并解析结算数据。

接下来做什么

想用 AI 生成监控或研究页面：阅读常见应用与组合使用。
想使用结算后的历史数据：阅读历史绩效分析与导出。
想嵌入一个自己的网页：阅读制作与使用 HTML 扩展。
已经知道需要什么数据：按接口参考查接口，按字段说明查字段。

安全说明

五个服务都只监听本机 localhost，没有面向调用方的独立应用层鉴权，也不应通过端口转发、反向代理等方式暴露到不可信网络。账户、持仓、委托、成交、历史结算和行情数据可能包含敏感信息，请只允许受信任的本机程序访问。QPro 会使用当前登录身份访问上游行情与结算数据服务，并按账号功能与数据权限控制可用范围。