常见应用与组合使用
先从希望实现的结果选择场景，再进入对应接口。启用服务和安装 Skills 见 快速开始；需要把页面放进 QPro 时，继续阅读 制作与使用 HTML 扩展。
账户监控与风险提示
自定义板块级别的盈亏统计
用户可以让 Agent 按自己的业务口径定义板块，例如把多个品种归为“黑色”“有色”“贵金属”，再统计持仓盈亏、浮动盈亏、平仓盈亏和手续费。
自定义板块盈亏看板示意：把多个品种按用户自己的规则归到板块，并展示盈亏、手续费和保证金。
用户只需说明板块口径和需要的指标，Agent 就可以根据 QPro Skills 中的账户表结构和查询规则生成查询，再按用户定义汇总。
更具个性化的风控通知
用户可以让 Agent 根据自己的规则组合多个表和多个条件，再触发本地弹窗、企业微信、飞书、短信或其他通知。例如：某些账户可用资金低于阈值、某些板块保证金过高、某些合约出现未完成委托时才提醒。
个性化风控通知示意：把账户、持仓、委托和成交状态组合成用户自己的提醒规则。
规则可以细化到不同账户、品种和交易时段，并设置重复提醒间隔。账户数据服务只提供只读查询，实际查询和通知逻辑由 Agent 或本地脚本完成。
可视化程度更高的展现方案
用户可以把 QPro 本地 API 接入 Streamlit、ECharts、Grafana、Jupyter Notebook 或内部网页。Agent 可以读取账户数据、订阅实时行情，并整理成账户-板块热力图、保证金占用排行、盈亏瀑布图或持仓变化时间线。
可视化展现示意：把 QPro 实时快照接入自建看板，按用户自己的观察方式展示账户、板块、风险和持仓变化。
这类方案可以把 QPro 的实时快照变成用户自己的看板。行情历史曲线可以通过 8814 查询历史 K 线；结算后的每日账户权益和日终持仓可以通过 8815 查询。若需要盘中账户权益、持仓变化的时间序列，仍需让 Agent 或外部程序定时轮询账户数据服务并自行保存。
行情研究与交易复盘
实时行情监控与提醒
实时行情服务适合把用户关心的少量合约接入自定义监控。Agent 或脚本可以为每个合约建立 SSE 连接，接收完整行情快照，再计算价格突破、成交放量、盘口变化或跨合约价差。
实时行情监控示意：订阅自选合约，在一个页面中展示最新价、买卖盘、分时走势和自定义提醒。
实时行情接口优先保证最新状态。客户端消费过慢时，中间更新可能被覆盖，因此它更适合监控和展示，不应被当作逐笔不丢失的历史行情归档接口。
实时 K 线、历史查询与交易复盘
K 线与历史行情服务可以持续推送最新 K 线窗口，也可以围绕指定时间查询历史 K 线。持续推送适合分时图、K 线图和指标看板；历史查询适合把成交或委托时间与前后行情对齐，复盘入场环境、滑点和持仓期间的价格变化。
K 线与交易复盘示意：左侧持续更新最新 K 线，右侧围绕成交时间查看历史窗口，并标记入场、出场和复盘结论。
最新 K 线流会先发送完整窗口，随后更新当前未收盘 K 线或追加新 K 线。历史窗口查询需要当前账号具备多账户功能权限；接口参数、时间单位和示例见 行情与合约 API。
合约筛选与期权研究
合约信息服务可以按合约类型、交易所、品种、是否到期和是否有夜盘筛选合约，再查询最小变动价位、合约乘数、到期时间、涨跌停价和交易时段等属性；也可以按标的获取看涨或看跌期权列表。
合约研究示意：先筛选可交易合约，再读取合约属性和对应期权列表。
Agent 可以据此回答“未到期且有夜盘的黄金合约有哪些”“某合约的最小变动价位和乘数是多少”“某标的有哪些看涨期权”等问题。推荐先取得有效合约代码，再订阅实时行情或查询 K 线。
组合使用与历史绩效
账户、合约与行情联动
四个服务可以组合使用：先读取多账户持仓，再补充合约名称、乘数、到期日和交易时段，订阅持仓合约的最新价格，最后按需读取实时或历史 K 线。这样可以构建跨账户风险看板、临近到期提醒、持仓行情异动提醒、交易复盘，或按自定义板块汇总实时风险敞口。
联动风险看板示意：由本地 Agent 组合 8811 至 8814 的持仓、实时行情、合约信息和 K 线数据，统一展示风险敞口与交易复盘结果。
还可以结合 8815 的历史绩效数据，比较日终持仓变化和资金占用。五类服务均不提供下单、撤单或改单能力；交易操作仍由 QPro 自身的交易流程负责。
基于结算数据的历史绩效分析
绩效分析服务支持用户读取已同步、已解析的历史账户资金、成交和日终持仓，按账户、日期区间、合约或自定义板块制作权益曲线、费用统计和交易复盘报表。用户可以让 Agent 先列出可用账户，再查询某个月的客户权益、出入金、手续费和保证金占用，或导出历史成交与持仓进行进一步分析。
这类日结数据无需从现在开始积累实时快照。可查询范围取决于结算数据的实际覆盖情况；首次使用或需要最新数据时，先同步再解析。收益率和回撤等指标由调用方按明确口径计算，需处理出入金、不同币种和缺失值。
PowerShell 查询、Python 导出和 HTML 看板的完整操作见 历史绩效分析与导出；接口见 历史绩效 API，字段见 历史绩效字段。
从筛选合约到订阅行情
下面的 PowerShell 示例先查询一个当前未到期的上期所黄金期货，再读取合约属性，读取它的实时 Quote 和最新 1 分钟 K 线。先在 PowerShell 中选择合约：
$result = Invoke-RestMethod "http://127.0.0.1:8813/query_quotes?ins_class=FUTURE&exchange_id=SHFE&product_id=au&expired=false"
$symbol = $result.data.symbols[0]
Invoke-RestMethod "http://127.0.0.1:8813/query_symbol_info?symbol=$symbol"
两种 SSE 订阅都会持续占用当前终端。请分别在两个 PowerShell 窗口运行下面的命令；每个窗口先运行上面的选合约代码，取得 $symbol：
curl.exe -N "http://127.0.0.1:8812/sub_quote/$symbol"
curl.exe -N "http://127.0.0.1:8814/stream/klines/latest?instrument_id=$symbol&duration_seconds=60&count=200"
本地 Agent 可以在这个流程上继续完成合约筛选、行情监控、指标计算、历史复盘、提醒或看板生成。如果需要把行情和持仓关联，可以再读取 8811 的账户数据接口。