group_xinghuo_jinrong/docs/项目框架设计/C-05-行情数据源选型对比.md

C-05 行情 / 净值数据源选型对比

场景 ID：C-05（客户查产品净值 · 「这只基金现在净值多少」）
用途：答辩 / 发群 / Phase B 外部同步拍板
关联：接口契约-代销平台API-v0.1.md · 接口契约-代销平台API-v0.2-行情扩展草案.md · Core模拟底座/01-表结构与种子说明.md · 需求拆解/用户故事/平台与行业背景.md

---

1. 需求边界（本项目）

要	不要
代销 场外公募/理财 产品 最新净值 + 日涨跌 + 净值日期	股票 实时 tick / 分时 / K 线
数据进 Core L0（core_product_nav）→ Platform API → 前端/Agent	前端/Agent 直连 第三方行情 REST
开发 Demo：静态种子 即可	毫秒级行情、自选股、全市场看盘终端
合规叙事：持牌代销平台 自有产品货架	爬虫蚂蚁/天天基金/雪球内部接口

PRD / 风控 PRD 已明确：不做真实 TA/清算/毫秒级行情。

---

2. 一句话结论

国内头部互联网代销（蚂蚁、天天基金等）没有面向第三方的官方「看盘 API」。
本项目 P0 用 Core 模拟库；Phase B 可选付费 REST 数据商做 T+1 同步进 Core；生产级走 Wind/Choice/iFinD 或 TA/登记披露对账。

---

3. 数据源对比总表

类别	代表	能否用于 C-05 净值	本项目阶段	合规/稳定	备注
Core 模拟种子	scripts/core/06-seed-nav.sql	✅ 完全匹配	P0 · 当前	✅	GET /api/products/{id}/nav 已实现
互联网代销开放 API	蚂蚁开放平台、天天基金、雪球	❌ 无官方通用净值 API	禁止	❌	内部 JS/爬虫非授权
页面爬虫 / 逆向	fundgz、pysnowball	⚠️ 能抓到但不稳定	禁止	❌	与持牌平台叙事冲突
第三方 REST 数据 API	咕咕数据、iTick、次方量化	✅ 场外基金净值	Phase B PoC	🟡 需合同+字段核对	经 sync_market_nav 落 Core
金融终端数据商	Wind、Choice、同花顺 iFinD	✅ 全品种+历史	生产方案	✅ 机构签约	Demo 阶段不必签
券商 OpenAPI	富途、长桥、华盛	🟡 偏场内/港美	不适用	✅ 开户即用	与场外公募代销主场景不对题
券商 QMT/PTrade	国内券商	🟡 本地 Python	不适用	✅ 门槛高	量化交易，非净值展示
交易所 / 基金通 B2B	上证基金通 snapshot	🟡 场内 ETF/LOF	未来扩展	✅ 需机构接入	与当前 14 只种子产品不同线
登记中心 / TA 披露	理财登记、基金公司 TA	✅ 权威净值来源	生产对账	✅ 批量日终	非实时 REST，文件/专线

图例：✅ 推荐 · 🟡 有条件 · ❌ 不推荐/禁止

---

4. 禁止清单（团队硬规则）

以下 不得 进入 scripts/sync/ 或生产代码：

1. 天天基金 fundgz.1234567.com.cn 等非官方内部 URL
2. 雪球 Cookie / Token 逆向（pysnowball 等）
3. 任何 未签约 的页面 scraping
4. 前端或 Agent Tool 携带第三方 appkey 直连 外网行情
5. 将外部 API 响应 伪造为实时 tick 展示（监管与产品口径不允许）

---

5. 分阶段推荐路径

阶段	数据源	接入方式	对外 API
P0 开发/Demo	Core 种子	reset.ps1 + 06-seed-nav.sql	GET /api/products、/nav
P0 前端	同上	web/ 产品行情页真调平台 API	页眉：静态模拟净值
Phase B 验证	咕咕 / iTick / 次方 等 择一 PoC	scripts/sync/sync_market_nav.py → UPSERT core_product_nav	新增 GET /api/products/nav-snapshot（见 v0.2 草案）
生产	Wind / Choice / iFinD + TA 披露	日终批处理 + 对账	同上；quote_mode=external_t1
Phase C（可选）	历史净值 / 场内 ETF 实时	历史表或交易所 B2B	GET .../nav/history 等待定

---

6. Phase B PoC 第三方 REST 细对比（候选，非背书）

以下为 调研摘要，签约前须自行核对最新文档、价格与授权范围。

维度	咕咕数据（示例）	iTick（示例）	次方量化（示例）
典型能力	公募基金净值 REST	场内 ETF/LOF 报价	场内基金 spot
与 C-05 匹配度	高（场外净值）	中（偏场内）	中
接入成本	appkey + 按量	API key	x-api-key
入库方式	sync 脚本	sync 脚本	sync 脚本
Demo 推荐度	优先试	有场内产品时试	备选

PoC 验收标准（4 条）：

1. 能映射到种子库 PROD-*（或配置 MARKET_NAV_PRODUCT_MAP）
2. 返回含 nav + nav_date（或等价字段）
3. 日终 T+1 延迟可接受（页眉标明，不冒充实时）
4. 商业授权允许 入库再展示

---

7. 生产级数据商（文档/答辩用）

服务商	典型用途	门槛
Wind Client API	全市场历史+实时	机构付费终端
东方财富 Choice EMQuantAPI	基金净值、基本面	机构试用/付费
同花顺 iFinD QuantAPI	多资产 REST/SDK	机构账号

与第三方小 REST 的分工：

• PoC：小 REST 验证 sync 管道与 UI
• 生产：数据商 替换 adapter 实现，Platform API 路径不变

---

8. 架构对齐（为什么不是「接代销 App API」）

┌─────────────────────────────────────────────────────────┐
│  XX 科技持牌代销平台（本项目）                              │
│  卖的是自有货架 core_product · 净值权威在 core_product_nav │
└───────────────────────────┬─────────────────────────────┘
                            │
         P0: 种子 SQL       │   Phase B+: sync_market_nav
                            ▼
              jinrong_core.core_product_nav
                            │
                            ▼
              GET /api/products/nav-snapshot
                            │
              ┌─────────────┴─────────────┐
              ▼                           ▼
         web 产品行情页              Agent / 其他 Agent

行业常态： 代销平台 采购 数据或接 TA/登记披露，而不是调用竞品 App 的接口。

---

9. 与场景 / 矩阵映射

场景	数据需求	当前状态	数据源
C-05	最新净值	API v0.1 已有；Agent T-40 未做	Core 种子
C-01	持仓市值	core_holding.market_value 种子	Core（非实时重算）
前端「产品行情」	全产品净值表	P0 设计已定	Platform API
R-02 / 适当性	产品 R 等级	Core	与净值源独立

---

10. 决策记录（建议拍板）

#	决策	建议
1	P0 是否接外部 API	否，Core 种子 + 静态页眉
2	Phase B 是否做 sync	是，选一个 REST PoC + sync_market_nav.py
3	是否做实时看盘	否（Phase C 再评估场内 ETF）
4	生产数据商	文档登记 Wind/Choice/iFinD，实施时再签
5	禁止爬虫	是，写入开发规范

---

11. 修订记录

日期	说明
2026-09-09	首版：互联网代销/API 调研结论 + 分阶段选型 + Phase B PoC 对比