基金组合与 ETF 监控 Skill

面向基金组合监控、ETF 看板、净值跟踪、估值提醒和基金排行筛选的公开 API 组合。

业务场景

用于基金组合监控、ETF 看板、基金排行筛选、净值跟踪和估值提醒。适合把基金基础信息、实时净值、历史净值、估值、排行、ETF 行情、分时、交易日历、汇率和摘要组合成基金数据工作流。

• 数据范围：覆盖基金基础信息、开放式基金排行、ETF 排行、净值实时、净值历史、基金估值、场内基金实时、场内基金历史、基金分时、交易日历、汇率和文本摘要。
• 关键数据维度：基金维度：基金代码、简称、类型、场内/场外属性和基金分类。；时间维度：交易日、净值日期、估值时间、历史区间和分时粒度。；指标维度：单位净值、累计净值、估值、涨跌幅、排行口径和展示币种。

何时使用

• 根据基金代码列表监控实时净值、估值、历史净值和分时表现。
• 按基金类型、排行口径或 ETF 条件筛选候选基金。
• 为组合日报、周报、风险提醒和跨币种展示准备数据。

不适用场景

• 用户只需要查看某一个接口的完整参数、响应字段、价格或购买入口时，直接打开接口详情页。
• 用户希望绕过接口开通、鉴权、配额或人工复核要求时，不应使用 Skill 作为替代。
• 任务需要法律、医疗、金融投资或升学录取的最终决策时，Skill 只能提供数据辅助和复核线索。

用户需要提供的信息

• 基金代码、基金类型、组合持仓、目标日期、净值区间、排行口径、展示币种和观察频率。
• 输出目标：净值跟踪、ETF 看板、组合复盘、基金筛选或估值提醒。
• 调用接口所需的 AppKey、开通状态和接口详情页限制。

推荐工作流

1. 先用基金基础信息确认基金代码、简称和类型。
2. 再按场内、场外、净值、估值、分时和排行选择接口。
3. 需要跨币种展示时，结合汇率和交易日历标注数据时间。

参数传递关系

• 先用基金基础信息确认基金代码、简称、类型和交易属性，再选择开放式基金或场内 ETF 对应接口。
• 交易日历用于判断目标日期是否有效，净值、估值、分时和历史走势必须保留数据时间。
• 排行接口输出的基金代码可继续传给净值实时、历史净值和估值接口，形成候选基金详情。
• 跨币种展示时使用汇率接口转换展示币种，并标注汇率时间。

典型任务模板

• 组合监控：输入基金代码列表和日期；输出实时净值、估值、历史净值变化和异常提示。
• ETF 看板：输入 ETF 代码或排行条件；输出场内实时行情、历史走势和分时数据。
• 基金筛选：输入基金类型和排行口径；输出排行榜、候选基金详情和数据时效。

接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。AppKey 应从环境变量或凭据管理系统注入，不要写入 SKILL.md、代码仓库、URL、日志或对话正文。推荐在服务端通过 Header 传递 AppKey；历史 Query 参数 appkey 仍以接口详情页说明为准。

基金基本信息

• 业务角色：基金基础信息
• 调用阶段：基础数据
• 接口地址：GET https://api.gugudata.com/fund/basicinfo
• 产出用途：用于确认基金代码、简称和类型。
• 参数来源：分页参数由调用方控制，用于分批读取结果
• 接口资料：详情页 https://www.gugudata.com/api/details/fundinfolist；接口 Markdown https://www.gugudata.com/api/details/fundinfolist/llm.md

关键请求参数：

开放式基金业绩排行

• 业务角色：开放式基金排行
• 调用阶段：基金筛选
• 接口地址：GET https://api.gugudata.com/fund/fund-open-ranking-list
• 产出用途：用于查询开放式基金排行。
• 参数来源：指标类型来自接口详情页中的可选指标说明
• 接口资料：详情页 https://www.gugudata.com/api/details/fundopenrankinglist；接口 Markdown https://www.gugudata.com/api/details/fundopenrankinglist/llm.md

关键请求参数：

场内基金业绩排行

• 业务角色：ETF 排行
• 调用阶段：基金筛选
• 接口地址：GET https://api.gugudata.com/fund/fund-etf-open-ranking-list
• 产出用途：用于查询场内 ETF 排行。
• 参数来源：指标类型来自接口详情页中的可选指标说明；关键词由用户输入或从上一轮内容抽取结果中生成；分页参数由调用方控制，用于分批读取结果
• 接口资料：详情页 https://www.gugudata.com/api/details/fundetfopenrankinglist；接口 Markdown https://www.gugudata.com/api/details/fundetfopenrankinglist/llm.md

关键请求参数：

开放式基金最新净值

• 业务角色：基金净值实时
• 调用阶段：净值跟踪
• 接口地址：GET https://api.gugudata.com/fund/open-nav-realtime
• 产出用途：用于查询开放式基金实时净值。
• 参数来源：证券或基金代码来自代码列表、基金基础信息或用户自选标的
• 接口资料：详情页 https://www.gugudata.com/api/details/fundopennavrealtime；接口 Markdown https://www.gugudata.com/api/details/fundopennavrealtime/llm.md

关键请求参数：

开放式基金区间净值

• 业务角色：基金净值历史
• 调用阶段：净值跟踪
• 接口地址：GET https://api.gugudata.com/fund/open-nav-history
• 产出用途：用于查询开放式基金历史净值。
• 参数来源：证券或基金代码来自代码列表、基金基础信息或用户自选标的；交易日期需要先结合交易日历判断是否有效
• 接口资料：详情页 https://www.gugudata.com/api/details/fundopennavhistory；接口 Markdown https://www.gugudata.com/api/details/fundopennavhistory/llm.md

关键请求参数：

开放式基金盘中净值估算

• 业务角色：基金估值
• 调用阶段：估值跟踪
• 接口地址：GET https://api.gugudata.com/fund/fund-value-estimation
• 产出用途：用于查询开放式基金净值估算。
• 参数来源：证券或基金代码来自代码列表、基金基础信息或用户自选标的；指标类型来自接口详情页中的可选指标说明
• 接口资料：详情页 https://www.gugudata.com/api/details/fundvalueestimation；接口 Markdown https://www.gugudata.com/api/details/fundvalueestimation/llm.md

关键请求参数：

场内基金实时净值

• 业务角色：场内基金实时
• 调用阶段：ETF 跟踪
• 接口地址：GET https://api.gugudata.com/fund/open/etfrealtime
• 产出用途：用于查询场内基金实时数据。
• 参数来源：证券或基金代码来自代码列表、基金基础信息或用户自选标的
• 接口资料：详情页 https://www.gugudata.com/api/details/fundopenetfrealtime；接口 Markdown https://www.gugudata.com/api/details/fundopenetfrealtime/llm.md

关键请求参数：

场内基金历史净值

• 业务角色：场内基金历史
• 调用阶段：ETF 跟踪
• 接口地址：GET https://api.gugudata.com/fund/open/etfhistory
• 产出用途：用于查询场内基金历史数据。
• 参数来源：证券或基金代码来自代码列表、基金基础信息或用户自选标的；交易日期需要先结合交易日历判断是否有效
• 接口资料：详情页 https://www.gugudata.com/api/details/fundopenetfhistory；接口 Markdown https://www.gugudata.com/api/details/fundopenetfhistory/llm.md

关键请求参数：

场内基金分时行情

• 业务角色：基金分时
• 调用阶段：ETF 跟踪
• 接口地址：GET https://api.gugudata.com/fund/historyminute
• 产出用途：用于查询场内基金分时行情。
• 参数来源：证券或基金代码来自代码列表、基金基础信息或用户自选标的；交易日期需要先结合交易日历判断是否有效
• 接口资料：详情页 https://www.gugudata.com/api/details/fundhistoryminute；接口 Markdown https://www.gugudata.com/api/details/fundhistoryminute/llm.md

关键请求参数：

A 股交易日历

• 业务角色：交易日历
• 调用阶段：时间校验
• 接口地址：GET https://api.gugudata.com/stock/cn/trade_calendar
• 产出用途：用于判断有效交易日期。
• 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
• 接口资料：详情页 https://www.gugudata.com/api/details/stockcntradecalendar；接口 Markdown https://www.gugudata.com/api/details/stockcntradecalendar/llm.md

关键请求参数：无额外业务请求参数；调用前仍需按接口详情页配置鉴权和开通状态。

国际货币汇率

• 业务角色：国际汇率
• 调用阶段：汇率换算
• 接口地址：GET https://api.gugudata.com/v2/finance/currency-exchange
• 产出用途：用于跨币种展示。
• 参数来源：交易日期需要先结合交易日历判断是否有效
• 接口资料：详情页 https://www.gugudata.com/api/details/currencyexchange；接口 Markdown https://www.gugudata.com/api/details/currencyexchange/llm.md

关键请求参数：

文本多语言 AI 摘要

• 业务角色：文本摘要
• 调用阶段：报告输出
• 接口地址：POST https://api.gugudata.com/ai/text-summarize
• 产出用途：用于生成组合日报或周报摘要。
• 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
• 接口资料：详情页 https://www.gugudata.com/api/details/summarize-text；接口 Markdown https://www.gugudata.com/api/details/summarize-text/llm.md

关键请求参数：

失败处理与恢复

• 缺少必填输入或数据口径不明确时，停止调用并先向用户补齐信息。
• 收到 401 或 403 时，检查 AppKey、安全配置和服务权限；不要在输出中回显凭据。
• 收到 429 时，遵守接口返回的限流提示，降低频率后再试，不要并发放大请求。
• 遇到网络或 5xx 异常时，只对幂等请求进行有限次数重试，并记录失败接口与时间。
• 数据为空或多接口结果冲突时，返回已确认事实、证据缺口和复核建议，不要臆造结论。

数据校验与使用边界

• 基金净值、估值和排行有更新延迟，应标注数据时间。
• 不同基金类型的可用指标不同，不能强行横向比较。
• 基金数据只用于信息展示和研究辅助，不构成投资建议。

输出建议

• 输出组合结果时按基金代码、名称、净值、估值、历史变化和数据时间展示。
• 排行榜输出应说明排行口径、基金类型和更新时间。
• 跨币种展示必须说明汇率来源和换算时间。

常见问题

• 问：什么情况下应该使用这个 Skill？ 答：当用户提出的目标需要多个咕咕数据公开 API 组合完成，而不是只查询一个接口时，优先阅读这个 Skill。
• 问：这个 Skill 是否需要单独购买？ 答：不需要。Skill 文档只负责业务流程和接口选型，具体接口购买、价格和账号权益仍以接口详情页为准。
• 问：Agent 应该怎样使用这个 Skill？ 答：Agent 应先阅读 SKILL.md，确认业务场景和推荐工作流，再进入接口详情页核对参数、响应字段、价格和调用示例。
• 问：调用接口前需要先核对什么？ 答：需要核对业务对象、地区、时间范围、输入格式、必填参数、返回字段、购买状态和接口详情页中的限制说明。
• 问：基金组合与 ETF 监控 Skill 会替代接口文档吗？ 答：不会。Skill 负责说明业务组合和调用顺序，接口参数、响应结构、计费和购买入口仍以接口详情页为准。