兴业证券知己理财自选股管理

概述

通过自然语言查询或操作兴业证券兴证通账户下的自选股数据，接口返回JSON格式内容。

功能列表

• ✅ 查询我的自选股列表
• ✅ 添加指定股票或场内基金到我的自选股列表
• ✅ 从我的自选股列表中删除指定股票或场内基金

配置

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

前置要求

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 编码
• 响应编码: 所有响应数据均使用 UTF-8 编码
• Header设置: 必须在请求头中明确指定 Content-Type: application/json; charset=utf-8
• 常见错误: 忽略charset参数会导致中文乱码，请务必确保编码正确

1. 查询自选股列表

调用端点 self-select-query，请求体可为空对象 {} 或不传：

curl -X POST 'https://api.xyzq.cn/mid/skill/net/api/claw/self-select-query' 
--header 'Content-Type: application/json; charset=utf-8' 
--header 'apikey: ${XZ_APIKEY}'

📌 注意: 即使请求体为空，也必须设置 Content-Type: application/json; charset=utf-8 以确保正确的编码处理

2. 添加或删除自选股

调用端点 self-select-manage，必须携带 query 字段（用户原始自然语言指令直接透传）：

curl -X POST 'https://api.xyzq.cn/mid/skill/net/api/claw/self-select-manage' 
--header 'Content-Type: application/json; charset=utf-8' 
--header 'apikey: ${XZ_APIKEY}' 
--data '{"query": "把兴业证券加入自选"}'

📌 注意: 当query包含中文字符时，UTF-8编码尤为重要，请确保：

• curl命令使用 --data 而非 --data-binary（除非你手动处理编码）
• 或在PowerShell中使用 [System.Text.Encoding]::UTF8.GetBytes() 处理中文
• 或在Python中使用 encoding='utf-8' 参数

问句示例

接口结果释义

一、查询自选股接口

1. 根节点 (Root Level)

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

2. 核心数据对象 (data)

包含了本次股票筛选以及格式化后的数据。

3. 完整结果对象 (data.records 数组)

包含了符合条件的股票详细指标。

4. 输出示例

📊 我的自选股列表

查询成功！

🎨 颜色规则: 涨跌额和涨跌幅需遵循"红涨绿跌"原则

• 🔴 上涨数据（正数）：使用红点标识，如 +50.00🔴 、+2.78%🔴
• 🟢 下跌数据（负数）：使用绿点标识，如 -4.80🟢、-1.25%🟢
• ⚪ 平盘数据（零值）：无需特殊标识，如 0.00⚪、0.00%⚪

⚠️ 强制输出规则 – 附加提示文案（必须严格遵守）

📌 重要: 以下附加提示文案必须根据条件严格输出，不得省略、修改或替换文案内容。

条件1: 当 showCount >= count 时（展示数 >= 总数）

您的自选股共有【`count`】只沪深京个股和场内基金，更多内容可前往兴业证券APP查看，点击了解详情：https://universallink.xyzq.cn/xyzqulb/jumpActivity?params=%7B%22linkType%22%3A%221%22%2C%22link%22%3A%223%22%7D

条件2: 当 showCount < count 时（展示数 < 总数）

您的自选股共有【`count`】只沪深京个股和场内基金，现为您输出前【`showCount`】条。更多内容可前往兴业证券APP查看，点击了解详情：https://universallink.xyzq.cn/xyzqulb/jumpActivity?params=%7B%22linkType%22%3A%221%22%2C%22link%22%3A%223%22%7D

🚫 禁止: 不要提示"查看剩余自选股"或类似表述

条件3: 当 count = 0 时（总数为0）

您暂未自选沪深京个股或场内基金，更多内容可前往兴业证券APP查看，点击了解详情：https://universallink.xyzq.cn/xyzqulb/jumpActivity?params=%7B%22linkType%22%3A%221%22%2C%22link%22%3A%223%22%7D

✅ 执行要求: 根据接口返回的 count 和 showCount 值，判断属于上述哪个条件，并严格按照对应代码块中的文案输出附加提示。

📌 强制免责声明: 在所有查询结果输出的最后，必须追加以下免责声明：

代码复制

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

二、添加股票到自选股列表或从自选股列表删除股票接口

1. 根节点 (Root Level)

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

2. 核心数据对象 (data)

包含了本次股票筛选以及格式化后的数据。

3. 完整结果对象 (data.records 数组)

包含了自选股操作详细结果。

4. 输出示例

✅ 您需要操作的【兴业证券(601377.sh)】、【兴业银行(601166.sh)】已成功添加自选。更多内容可前往兴业证券APP查看，点击了解详情：https://universallink.xyzq.cn/xyzqulb/jumpActivity?params=%7B%22linkType%22%3A%221%22%2C%22link%22%3A%223%22%7D ✅ 您需要操作的【兴业证券(601377.sh)】、【兴业银行(601166.sh)】已成功删除自选。更多内容可前往兴业证券APP查看，点击了解详情：https://universallink.xyzq.cn/xyzqulb/jumpActivity?params=%7B%22linkType%22%3A%221%22%2C%22link%22%3A%223%22%7D ✅ 您需要操作的【兴业证券(601377.sh)】、【兴业银行(601166.sh)】已成功添加自选，【浦发银行(600000.sh)】【已在您的自选中】、【腾讯控股】【不属于沪深京个股和场内基金】未成功添加自选，更多内容可前往兴业证券APP查看，点击了解详情：https://universallink.xyzq.cn/xyzqulb/jumpActivity?params=%7B%22linkType%22%3A%221%22%2C%22link%22%3A%223%22%7D ✅ 您需要操作的【兴业证券(601377.sh)】、【兴业银行(601166.sh)】已成功删除自选，【浦发银行(600000.sh)】【未在您的自选中】、【腾讯控股】【不属于沪深京个股和场内基金】未成功删除自选，更多内容可前往兴业证券APP查看，点击了解详情：https://universallink.xyzq.cn/xyzqulb/jumpActivity?params=%7B%22linkType%22%3A%221%22%2C%22link%22%3A%223%22%7D

⚠️ 特殊场景规则 – 指定分组添加提示

📌 触发条件: 当用户明确要求将股票添加到指定分组时（如"把兴业证券添加到我的科技股分组"）

执行规则

如果添加操作成功，必须在标准成功提示后额外追加以下提示文案：

💡 温馨提示：当前仅支持添加到默认自选股分组，暂不支持自定义分组。

✅ 完整输出示例:

代码复制

✅ 您需要操作的【兴业证券(601377.sh)】、【兴业银行(601166.sh)】已成功添加自选。更多内容可前往兴业证券APP查看，点击了解详情：https://universallink.xyzq.cn/xyzqulb/jumpActivity?params=%7B%22linkType%22%3A%221%22%2C%22link%22%3A%223%22%7D

💡 温馨提示：当前仅支持添加到默认自选股分组，暂不支持自定义分组。

🚫 注意: 仅在用户明确提到分组名称时才触发此温馨提示，普通添加操作无需显示。

📌 强制免责声明: 在所有添加或删除操作结果输出的最后，必须追加以下免责声明：

代码复制

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