---
name: fund-portfolio-monitoring
description: "当用户需要使用咕咕数据公开 API 完成基金组合监控、业务数据组合、参数传递、接口选型或结果校验时使用；不适用于绕过接口详情页、购买规则或人工复核要求的场景。"
compatibility: "需要访问 GuGuData HTTPS API；执行接口前需开通对应服务并安全配置 AppKey。"
metadata:
  author: "GuGuData"
  version: "1.0.0"
  homepage: "https://www.gugudata.com/skills/fund-portfolio-monitoring"
---

# 基金组合与 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `pageIndex` | 否 | `integer` | 1 | 可选。分页页码，从 1 开始；第一页传 1，第二页传 2，以此类推 | 分页参数由调用方控制，用于分批读取结果 |
| `pageSize` | 否 | `integer` | 10 | 可选。每页返回条数，取值范围为 1~20；未传时默认 10 | 分页参数由调用方控制，用于分批读取结果 |

### 开放式基金业绩排行

- 业务角色：开放式基金排行
- 调用阶段：基金筛选
- 接口地址：`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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `type` | 是 | `string` | - | 无默认值，必填；全部、股票型、混合型、债券型、指数型、QDII、FOF；QDII/FOF 不区分大小写。 | 指标类型来自接口详情页中的可选指标说明 |

### 场内基金业绩排行

- 业务角色：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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `type` | 否 | `string` | - | 可选。按 FundType 精确筛选，不区分英文字母大小写；留空时不限制基金类型 | 指标类型来自接口详情页中的可选指标说明 |
| `keyword` | 否 | `string` | - | 可选。按基金代码或基金名称进行不区分大小写的模糊筛选 | 关键词由用户输入或从上一轮内容抽取结果中生成 |
| `pageIndex` | 否 | `integer` | 1 | 可选。分页页码，从 1 开始；仅传 pageSize 时默认使用第 1 页 | 分页参数由调用方控制，用于分批读取结果 |
| `pageSize` | 否 | `integer` | 100 | 可选。每页数量，取值范围 1~500；未传 pageIndex 和 pageSize 时返回全部匹配记录 | 分页参数由调用方控制，用于分批读取结果 |

### 开放式基金最新净值

- 业务角色：基金净值实时
- 调用阶段：净值跟踪
- 接口地址：`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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | 否 | `string` | - | 单个六位基金代码，保留前导零；无默认代码，留空返回全量，不支持多个代码。 | 证券或基金代码来自代码列表、基金基础信息或用户自选标的 |

### 开放式基金区间净值

- 业务角色：基金净值历史
- 调用阶段：净值跟踪
- 接口地址：`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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | 是 | `string` | - | 必填。单个 6 位开放式基金代码，保留前导零；不支持市场前缀或多个代码 | 证券或基金代码来自代码列表、基金基础信息或用户自选标的 |
| `indicator` | 是 | `string` | - | 必填。仅支持：单位净值走势、累计净值走势、累计收益率走势、同类排名走势、同类排名百分比、分红送配详情、拆分详情；必须传完整中文名称 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `beginDate` | 是 | `string` | - | 必填。查询开始日期，严格使用 yyyyMMdd 格式，例如 20260701 | 交易日期需要先结合交易日历判断是否有效 |
| `endDate` | 是 | `string` | - | 必填。查询结束日期，严格使用 yyyyMMdd 格式；不得早于 beginDate，二者间隔最大为 366 个自然日 | 交易日期需要先结合交易日历判断是否有效 |

### 开放式基金盘中净值估算

- 业务角色：基金估值
- 调用阶段：估值跟踪
- 接口地址：`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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | 否 | `string` | - | 可选。传单个 6 位开放式基金代码，或使用英文逗号分隔多个代码，最多 50 个；代码会去重并保留前导零 | 证券或基金代码来自代码列表、基金基础信息或用户自选标的 |
| `type` | 否 | `string` | 全部 | 可选。基金类型筛选值，默认“全部”；空字符串同样按“全部”处理。传入 symbol 后优先按基金代码筛选 | 指标类型来自接口详情页中的可选指标说明 |

### 场内基金实时净值

- 业务角色：场内基金实时
- 调用阶段：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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | 否 | `string` | - | 可选。传单个 6 位场内基金代码，或使用英文逗号分隔多个代码，最多 50 个；代码保留前导零。留空时返回当前可用的全部场内基金 | 证券或基金代码来自代码列表、基金基础信息或用户自选标的 |

### 场内基金历史净值

- 业务角色：场内基金历史
- 调用阶段：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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | 是 | `string` | - | 必填。单个 6 位场内基金代码，保留前导零；不支持市场前缀或多个代码 | 证券或基金代码来自代码列表、基金基础信息或用户自选标的 |
| `startDate` | 是 | `string` | - | 必填。查询开始日期，严格使用 yyyyMMdd 格式，例如 20260701 | 交易日期需要先结合交易日历判断是否有效 |
| `endDate` | 是 | `string` | - | 必填。查询结束日期，严格使用 yyyyMMdd 格式；可以与 startDate 相同，但不得早于 startDate | 交易日期需要先结合交易日历判断是否有效 |

### 场内基金分时行情

- 业务角色：基金分时
- 调用阶段：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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | 是 | `string` | - | 必填。单个 6 位场内基金代码；也兼容 sh513500 或 sz159915，服务端会去除市场前缀并按标准 6 位代码查询 | 证券或基金代码来自代码列表、基金基础信息或用户自选标的 |
| `beginDate` | 是 | `string` | - | 必填。查询开始时间，严格使用 yyyyMMdd HH:mm:ss 格式，例如 20260701 09:30:00 | 交易日期需要先结合交易日历判断是否有效 |
| `endDate` | 是 | `string` | - | 必填。查询结束时间，格式与 beginDate 相同；不得早于开始时间，二者间隔最大为 366 个自然日 | 交易日期需要先结合交易日历判断是否有效 |
| `period` | 否 | `integer` | 5 | 可选。分钟周期，仅支持 1、5、15、30、60；未传时默认 5 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `adjust` | 否 | `string` | - | 可选。复权方式：空值表示不复权，pre 表示前复权，after 表示后复权；英文值不区分大小写 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `source` | 是 | `string` | - | 必填源币种代码，如 EUR、USD。忽略首尾空白并转大写，最多 20 个字符，允许字母、数字、$、.；是否支持以指定日期来源数据为准。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `date` | 否 | `string` | latest | 默认 latest，空字符串同 latest；或 YYYY-MM-DD，如 2024-03-06。历史可用性以来源实际提供为准，历史结果必须匹配请求日期。 | 交易日期需要先结合交易日历判断是否有效 |
| `target` | 否 | `string` | - | 目标币种代码，如 CNY；不传或留空返回全部目标币种，代码规则与 source 相同。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 文本多语言 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `textContent` | 是 | `string` | N/A | 非空文本正文，支持表单与历史 JSON；不可放在 Query，参数不可重复。 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `streaming` | 否 | `boolean` | false | 默认 false；true 按 SSE 接收文本片段、完整结果和 [DONE]；失败不发送成功终态。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `lang` | 否 | `string` | zh | 有效语言代码，如 zh、en、ja；缺省或空值使用 zh。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

## 失败处理与恢复

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

## 数据校验与使用边界

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

## 输出建议

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

## 常见问题

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