朝阳永续-ETF智能筛选

概述

suntime-etf-screen

使用方式

需配置环境变量 SUNTIME_API_KEY（朝阳永续 API Key，去 https://open.go-goal.com?channel=qw 首页点「获取 API KEY」领取）。

运行时错误处理（调用失败时自动引导）

调用返回以下错误时，改参数无法解决，需自动为用户打开浏览器引导处理（无图形界面的云端环境改为直接把链接给用户）。按返回 JSON 的 message 关键词匹配：

打开浏览器命令：macOS open <url>；Windows start <url>；Linux xdg-open <url>。

第一步：判断问题类型

不确定时一律走「筛选」。

第二步：理解问题，调用接口

可用数据维度

一、ETF 基础数据（90% 的筛选用这组维度）

二、持仓个股维度（查"持有某股票的 ETF"时用这组）

接口调用方式

请求地址： GET https://sntp-opendata-qw.go-goal.cn/s/100008/a/search_etf

认证： Authorization: Bearer ${SUNTIME_API_KEY}

Query Parameters：

• query = 用户的问题或条件（不要改写用户问题再提问，直接原样传入，需 urlencode）

超时时间： 50 秒（接口查询时间较长）

curl -s "https://sntp-opendata-qw.go-goal.cn/s/100008/a/search_etf?query=规模大于100亿且成交额大于1亿的ETF" 
  -H "Authorization: Bearer ${SUNTIME_API_KEY}"

query 参数中的中文执行时自动 URL 编码。

调用示例

示例1 – 按条件筛选：

用户问题：规模大于100亿且成交额大于1亿的ETF
query：规模大于100亿且成交额大于1亿的ETF

示例2 – 持仓个股筛选：

用户问题：持有宁德时代的ETF有哪些
query：持有宁德时代的ETF有哪些

示例3 – 同类优选：

用户问题：沪深300ETF哪个规模最大且溢价最低
query：沪深300ETF哪个规模最大且溢价最低

构造 query 规则

第三步：执行并输出

筛选（全新 / 追加 / 清空重来 / 引用历史）

1. 如果是引用历史（用户说了"在第X次结果中"或"在刚才的结果里"）
   • 定位记录："刚才的"对应最近一条，"第X次"按序号找，"在XX结果中"按关键词匹配
   • 找不到则列出历史让用户选；多条匹配则列出候选让用户选
   • query = [那条历史的条件] + [用户新条件]
2. 其他（全新/追加/清空重来）
   • 全新或清空：query = 用户原始话
   • 追加（有活跃结果且用户说"从中"/"再加"/"并且"）：query = 原条件 + 并且 + 用户新条件
   • 不确定时按全新处理
3. 调用接口
4. 存入记录栈（时间戳、条件、数量、列表），标记为当前活跃结果
5. 按「输出格式」返回给用户

输出格式

显示多少条：

每条必须包含： ETF代码 + 名称 + 跟踪指数 + 规模 + 成交额 + 溢价率 + 涨跌幅 + 本次核心指标值 + 入选理由

排序： 相关性高的排前面，再按主指标大小排列。

开头话术：

尾部引导：

🔍 当前筛选条件：[具体条件]

• 输入"刷新"：重新执行当前条件
• 输入"清空"：重置所有条件重新筛选
• 输入"再加XX"：在当前结果基础上添加新条件
• 输入"在第X次结果中筛XX"：跳回历史筛选

记录已保存，可随时引用历史结果

铁律

1. 不编造字段名 – 只用第二步可用数据维度里列出来的内容
2. 不改写用户问题 – query里保留用户原始措辞
3. 不确定就走筛选 – 第一步判断拿不准时直接走筛选流程
4. 每次都要存结果 – 不要丢状态，每条都入栈
5. 必须验证 API Key – 调用接口前先检查 ${SUNTIME_API_KEY} 环境变量是否存在，不存在时提示用户配置
6. 同类优选单独处理 – 锁定指数→拉同指数全量→对比排序→标注推荐（规模TOP3+溢价<0.1%+误差<0.1%）
7. 排除迷你ETF – 默认排除规模<5000万的ETF
8. 货币型特殊处理 – 货币ETF无PE/PB估值，核心看7日年化收益率

关键单位说明

状态管理

• 记录栈最多10条，超出淘汰最早的
• 当前活跃结果 = 最近一条
• 清空重来只重置活跃结果，历史不删

风险提示

⚠️ 以上内容由 AI 辅助生成，仅供参考，不构成任何投资决策或投资建议。