基金组合跟踪如何区分净值与估值真正困难的通常不是完成一次 API 调用而是让结果可以校验、失败可以定位、后续能够回到原始证据。本文围绕“如何组织基金基础信息、排行、实时行情、净值估算和历史净值”给出一套可以直接落到任务状态和数据契约上的实现方式。问题与结果基金净值、盘中估值和 ETF 行情使用不同字段与时间口径组合报告避免错误比较。最终交付不是一段不可追溯的模型回答而是一组带来源、版本、状态和失败记录的数据。这样既方便接入后续系统也能在接口、页面或模型输出变化时定位问题。适用场景基金组合看板定投复盘基金池筛选与观察实现前先确定边界基金代码、份额类别和交易场所必须区分净值估算不能写成已确认净值排行比较必须固定周期和基准日期可验证工作流API 编排与职责步骤接口请求方式用途基础资料基金基本信息列表GET获取基金名称、代码、类型等基础信息开放式排行开放式基金实时排行GET查看开放式基金排名和表现ETF 排行场内基金业绩排行GET查看场内基金多周期收益排行实时行情场内交易基金实时数据GET查询 ETF 或场内基金实时行情净值估算开放式基金净值估算数据GET补充开放式基金估算净值历史净值开放式基金净值历史数据GET用于回测、复盘和趋势展示最小可运行实现查询基金基本信息curl -G https://api.gugudata.com/fund/basicinfo \ --data-urlencode appkeyYOUR_APPKEY \ --data-urlencode pageIndex1 \ --data-urlencode pageSize20查询开放式基金实时排行curl -G https://api.gugudata.com/fund/fund-open-ranking-list \ --data-urlencode appkeyYOUR_APPKEY \ --data-urlencode pageIndex1 \ --data-urlencode pageSize20查询场内基金实时行情curl -G https://api.gugudata.com/fund/open/etfrealtime \ --data-urlencode appkeyYOUR_APPKEY \ --data-urlencode symbol510300查询场内基金业绩排行curl -G https://api.gugudata.com/fund/fund-etf-open-ranking-list \ -H X-GUGUDATA-APPKEY: YOUR_APPKEY \ --data-urlencode keywordETF \ --data-urlencode pageIndex1 \ --data-urlencode pageSize20排行属于日度快照应以DateKey判断新鲜度。部分统计期尚未形成收益时会沿用兼容数值 0应结合EstablishingDate判断不能直接把 0 当作真实收益。业务码 901 表示数据源暂不可用调用方应稍后重试不能把失败结果写入组合排行。组合报告可以先归一化基金条目def normalize_fund_item(symbol: str, fund_type: str, payload: dict) - dict: Normalize fund data for a portfolio report. return { symbol: symbol, fund_type: fund_type, data: payload.get(Data), response_time: payload.get(DataStatus, {}).get(ResponseDateTime), }组合报告怎么组织基金组合跟踪建议拆成五个区块区块内容组合概览持仓基金、基金类型、更新时间净值表现最新净值、估算净值、历史净值变化同类对比开放式排行、ETF 排行或同类基金对比风险提示数据缺失、净值延迟、过度集中等信息复盘记录定投计划、调仓记录、观察备注报告应保持信息属性不写成“买入某基金”或“赎回某基金”。如果要做策略建议应由用户自己的投顾规则或人工顾问确认。失败分类与降级如果基金代码无法识别Agent 应提示用户检查代码和基金类型。若净值估算暂不可用应展示最近历史净值和更新时间。对于节假日或非交易时段不要把没有更新误判成接口异常。组合报告生成失败时应保留结构化数据允许稍后重新生成文本报告。数据契约与留痕建议至少保存以下字段真实项目可以继续拆分但不要删除来源、版本和状态信息。字段作用fund_id稳定业务标识用于关联记录并避免名称冲突share_class业务数据字段保存时记录来源、口径和缺失状态data_type分类或口径字段用于路由和一致性检查value业务数据字段保存时记录来源、口径和缺失状态value_date带时区的采样或生成时间判断数据新鲜度estimate_time带时区的采样或生成时间判断数据新鲜度ranking_window业务数据字段保存时记录来源、口径和缺失状态source_status显式状态或结果禁止用空值代替失败所有派生结果都应带生成时间和输入版本。发生重试时新增尝试记录不要覆盖最后一次失败以免排查时只剩“最终成功”而看不到中间问题。验收清单估值与正式净值在界面上明显区分历史收益使用一致基准数据缺失不会自动延用旧值而不提示能力边界基金估值和排行是信息参考不构成收益保证或投资建议最终净值以基金官方披露为准。示例中的YOUR_APPKEY仅为占位符。真实密钥只能放在服务端环境变量或密钥管理系统中不应进入前端、文章、日志或版本库。