兴业证券知己理财金融数据查询

概述

通过自然语言查询A股公司公告、公司财务数据、A股及上市基金行情与指数数据查询，接口返回JSON格式内容。

功能列表

• ✅ skill介绍
• ✅ 查询公司公告
• ✅ 查询公司利润表
• ✅ 查询公司资产负债表
• ✅ 查询现金流量表
• ✅ 查询财报
• ✅ 查询历史行情

配置

• API Key: 通过环境变量 XZ_APIKEY 设置（与其他兴业证券知己理财技能共享）
• Base URL: https://api.xyzq.cn

前置要求

在安装前，请先检查是否已经安装skill技能xz-finance-data，若已经安装，必须先删除旧版skill。

1. 获取兴业证券知己理财Skills页面的 API Key
2. 将 API Key 配置到环境变量 XZ_APIKEY
3. 确保网络可以访问 https://api.xyzq.cn

⚠️ 安全注意事项

• 外部请求: 本 Skill 会将查询文本发送至兴业证券官方 API 域名 (api.xyzq.cn) 以获取金融数据。
• 凭据保护: API Key 仅通过环境变量 XZ_APIKEY 在服务端或受信任的运行环境中使用，禁止在前端明文暴露。

接口结果通用释义

这些是接口最外层的通用状态响应字段。

必须遵守事项

所有请求均为 POST 方法，API Key 通过 Header apikey 传递，请求和应答均使用 UTF-8 编码。

如查询多个股票或者公司时，请拆分成多次请求。

每一个场景的返回结果必须添加以下内容：以上内容通过技能（skill）自主调用数据生成，其准确性依赖底层模型的理解与处理能力，不保证信息完全无误，仅供参考，实际数据以兴业证券app（优理宝）平台数据为准。市场有风险，投资需谨慎。

skil调用介绍

1.skill介绍

1.1.调用示例

无需请求接口，直接返回以内内容：

金融数据查询skill是 兴业证券 官方提供的金融数据查询工具，支持A股公司公告、公司财务数据、A股及上市基金行情数据查询等。

核心能力：

更多内容可前往兴业证券APP查看，点击了解详情兴业证券优理宝欢迎您！

1.2.问句示例

什么是金融数据查询

金融数据查询能干什么

如何查询金融数据

2.查询公司公告

2.1.调用示例

调用端点 announcement，必须携带 query 字段（用户原始自然语言指令）：

curl -X POST 'https://api.xyzq.cn/mid/skill/net/api/claw/finance-data/announcement' 
--header 'Content-Type: application/json' 
--header 'apikey: ${XZ_APIKEY}' 
--data '{"query": "查询贵州茅台的公告"}'

2.2.问句示例

查询贵州茅台的公告

查询茅台2026年3月1日至2026年5月1日的所有公告

查询兴业证券的定期报告

兴业证券、国泰海通今年有发过定期报告吗

601377.SH 2025年披露的公告

2.3.返回数据释义

返回的data为公告列表，数组格式，字段如下：

2.4.展示格式

建议展示格式如下，使用{}修饰的需要替换成具体值：查到了！{证券简称}({证券代码})的相关公告： {换行} {公告标题} {换行}

发布日期：{公告日期} {换行}

交易所： {交易所} {换行}

公告类型： {公告类型} {换行}

点击查看公告pdf原文：{链接地址} {换行}

3.查询公司利润表

3.1.额外的试用场景

有提及以下字段必须使用本功能：营业总收入、营业收入、营业总成本、营业成本、营业税金及附加、销售费用、管理费用、财务费用、营业利润、利润总额、净利润、母公司股东净利润、基本每股收益、利息净收入、手续费及佣金净收入、投资收益、公允价值变动收益、汇兑收益、其他业务收入、已赚保费

3.2.调用示例

调用端点 income，必须携带 query 字段（用户原始自然语言指令）：

curl -X POST 'https://api.xyzq.cn/mid/skill/net/api/claw/finance-data/income' 
--header 'Content-Type: application/json' 
--header 'apikey: ${XZ_APIKEY}' 
--data '{"query": "查询贵州茅台的利润表"}'

3.3.问句示例

查询贵州茅台的利润表

茅台2025年年度净利润是多少

兴业证券最近3年的年度利润表

兴业证券、国泰海通营业总收入是多少

601377.SH 2026年一季度盈利

3.4.返回数据释义

返回的data为利润列表，数组格式，字段如下：

3.5.展示格式

通用金额转换规则（适用于所有财务数据及行情中的金额字段）：

• 绝对值 ≥ 1亿（100,000,000）时，转换为“X.XX亿元”（四舍五入保留两位小数）
• 1万（10,000） ≤ 绝对值 < 1亿时，转换为“X.XX万元”
• 绝对值 < 1万时，保留原数值并以“元”为单位，保留两位小数（如“1234.56元”）
• 日涨跌幅等百分比字段直接在数字后加“%”，保留两位小数（如“3.25%”）

使用{}修饰的需要替换成具体值，所有数值字段必须按上述规则转换后再展示。

场景1如果不是查询某些具体指标，建议格式如下：

{证券名称}（{证券代码}）利润表

场景2如果查询某些具体指标,比如营业成本、汇兑收益，必须按照以下格式展示：

{证券名称}（{证券代码}）利润表

4.查询公司负债表

4.1.额外的试用场景

有提及以下字段必须使用本功能：货币资金、应收票据、应收账款、预付款项、买入返售金融资产、存货、流动资产合计、发放贷款、可供出售金融资产、持有到期投资、长期应收款、长期股权投资、固定资产、无形资产、商誉、非流动资产合计、总资产、短期借款、应付职工薪酬、应付税费、流动负债合计、长期借款、应付债券、递延所得税负债、非流动负债合计、负债合计、实收资本、资本公积、盈余公积、未分配利润、母公司股东权益合计、少数股东权益、所有者权益、资产负债率、现金及存入中央银行款项

4.2.调用示例

调用端点 liability，必须携带 query 字段（用户原始自然语言指令）：

curl -X POST 'https://api.xyzq.cn/mid/skill/net/api/claw/finance-data/liability' 
--header 'Content-Type: application/json' 
--header 'apikey: ${XZ_APIKEY}' 
--data '{"query": "查询贵州茅台的资产负债表"}'

4.3.问句示例

查询贵州茅台的资产负债表

茅台2025年年度总资产是多少

兴业证券最近3年的年度资产负债表

兴业证券、国泰海通资产负债率是多少

601377.SH 最近2年每个季度的详细资产负债表

4.4.返回数据释义

返回的data为负债列表，数组格式，字段如下：

4.5.展示格式

通用金额转换规则（同上），所有数值字段按规则转换后再展示。资产负债率直接使用原百分比数值，保留两位小数加“%”。

场景1如果不是查询某些具体指标，建议格式如下：

{证券名称}（{证券代码}）负债表

以上信息源自第三方数据整理，仅供参考。金融数据查询Skill仅提供客观数据，调用本Skill后生成的内容，不构成投资建议。

场景2如果查询某些具体指标,比如所有者权益、负债合计，必须按照以下格式展示：

{证券名称}（{证券代码}）负债表

5.查询公司现金流量表

5.1.额外的试用场景

有提及以下字段必须使用本功能：销售商品提供劳务收到的现金、经营活动现金流入小计、购买商品接受劳务支付现金、支付职工以及为职工支付现金、支付税费、经营活动现金流出小计、经营活动产生的现金流量净额、收回投资收到的现金、取得投资收益收到的现金、处置固定资产无形资产和其他长期资产收回的现金净额、投资活动现金流入小计、购建固定资产无形资产和其他长期资产支付现金、投资支付的现金、投资活动现金流出小计、投资活动产生的现金流量净额、吸收投资收到的现金、取得借款收到的现金、筹资活动现金流入小计、偿还债务支付的现金、分配股利利润偿付利息支付现金、筹资活动现金流出小计、筹资活动产生的现金流量净额、现金及现金等价物净增加额、期末现金及现金等价物余额、客户存款同业存放款净增加、支付手续费及佣金的现金、代理买卖证券收到现金净额

5.2.调用示例

调用端点 cash-flow，必须携带 query 字段（用户原始自然语言指令）：

curl -X POST 'https://api.xyzq.cn/mid/skill/net/api/claw/finance-data/cash-flow' 
--header 'Content-Type: application/json' 
--header 'apikey: ${XZ_APIKEY}' 
--data '{"query": "查询贵州茅台的现金流量表"}'

5.3.问句示例

查询贵州茅台的现金流量表

茅台2025年年度经营活动现金流量净额是多少

兴业证券最近3年的年度现金流量表

兴业证券、国泰海通经营活动现金流量净额是多少

601377.SH 最近2年每个季度的详细现金流量表

5.4.返回数据释义

返回的data为现金流量表，数组格式，字段如下：

5.5.展示格式

通用金额转换规则（同上），所有数值字段按规则转换后再展示。

场景1如果不是查询某些具体指标，建议格式如下：

{证券名称}（{证券代码}）现金流量表

场景2 如果查询某些具体指标,比如筹资活动现金流出小计、期末现金及现金等价物余额，必须按照以下格式展示：

{证券名称}（{证券代码}）现金流量表

6.查询公司财报

6.1.额外的试用场景

有提及以下字段必须使用本功能：财报、年报、会计报表

6.2.调用示例

调用端点 annual-report，必须携带 query 字段（用户原始自然语言指令）：

curl -X POST 'https://api.xyzq.cn/mid/skill/net/api/claw/finance-data/annual-report' 
--header 'Content-Type: application/json' 
--header 'apikey: ${XZ_APIKEY}' 
--data '{"query": "查询贵州茅台的现金流量表"}'

6.3.问句示例

查询贵州茅台的财报

茅台2025年年报

兴业证券最近3年的单季度报表

兴业证券、国泰海通的财务数据

601377.SH 最近2年的财务报表

6.4.返回数据释义

返回的data为财报表，数组格式，字段如下：

6.5.展示格式

通用金额转换规则（同上），所有数值字段按规则转换后再展示。资产负债率直接使用原百分比数值，保留两位小数加“%”。

建议格式如下：

{证券名称}（{证券代码}）财报

7.查询历史行情

7.1.额外的试用场景

有提及以下字段必须使用本功能：K线数据、历史行情、股价走势、日线行情、历史收盘价、涨跌幅。

7.2.调用示例

调用端点 history-quote，必须携带 query 字段（用户原始自然语言指令）：

curl -X POST 'https://api.xyzq.cn/mid/skill/net/api/claw/finance-data/history-quote' 
--header 'Content-Type: application/json' 
--header 'apikey: ${XZ_APIKEY}' 
--data '{"query": "查询贵州茅台的K线数据"}'

7.3.问句示例

查询贵州茅台的K线数据

查一下某股票最近 60 天的日线行情

510300 近一年的收盘价

上证指数最近1个月的走势

比较这几只股票的历史收盘价：兴业证券、国泰海通、中信证券

7.4.返回数据释义

返回的data包含行情概览（overview）与行情数据列表（detailList）。

行情概览（overview）：

行情数据列表（detailList）数组格式，字段如下：

7.5.展示格式

通用金额转换规则（同上），所有数值字段按规则转换后再展示。资产负债率直接使用原百分比数值，保留两位小数加“%”。

场景1，返回行情数据列表（detailList）条数 > 0 条，使用详细表格格式：

招商银行的历史行情数据已获取到！让我整理成表格：📊 【{证券名称}（{证券代码}）最近{数据条数}个交易日行情】

关键数据摘要：

• 📈 区间涨幅：{总结区间涨跌幅}
• 🏆 最高点位：{区间最高价}（{最高价对应日期}）
• 📉 最低点位：{区间最低价}（{该区间内的最低价对应日期}）
• 💰 最高成交额：{区间最高成交额}(区间最高成交额对应的日期)

场景2:返回行情数据列表（detailList）数据条数 < 1 条，必须使用汇总卡片格式（不展示逐日明细表格）,使用行情概览（overview）数据进行展示，格式如下：

📊 【{证券名称}（{证券代码}） {查询周期}以来行情汇总】