养基宝基金查询（完整版）

通过养基宝 API 实现完整的基金持仓管理：微信扫码登录 → 获取个人持仓 → 净值估算 → 数据分析。

体系总览

养基宝共有 两套 API 体系、三种调用方式：

⚠️ 重要: 两套 Token 体系完全独立，不互通。微信扫码 Token 只能用于 browser-plug-api，iOS Token 只能用于 app-api 认证接口。

依赖安装

脚本使用 requests 与 qrcode，首次使用前安装：

pip install -r requirements.txt
# 或： pip install requests qrcode

涨跌标识约定

本 skill 输出遵循 A股习惯：涨=红🔴 / 跌=绿🟢 / 平=⚪，与欧美惯例相反，请勿混淆。

发布/分享注意事项

• references/fund-mapping.md 是模板，含作者示例数据，使用者请替换为自己的基金。
• 微信扫码 Token 保存在 ~/.yjb_token.json，iOS Token 在 ~/.yjb_ios_token.json，均属个人凭证，勿随 skill 打包分享。
• browser-plug-api 使用 HTTP（非 HTTPS），仅在扫码登录链路使用，请勿在公共网络明文传输。

数据源 A: 公网行情（无需登录）

• Base URL: https://app-api.yangjibao.com
• 用途: 基金净值、指数行情、板块排行、历史净值
• 认证: 无需 Token（部分接口需 User-Agent 伪装）
• 脚本: scripts/yjb_market.py

数据源 B: 个人持仓（需微信扫码登录）

• Base URL: http://browser-plug-api.yangjibao.com
• 用途: 个人持仓数据、账户汇总、收益分析
• 认证: 微信扫码 → 获取 Token → 签名验证
• 脚本: scripts/yjb_login.py（登录）+ scripts/yjb_fetch.py（拉取数据）

数据源 C: app-api 认证（需 iOS Token）

• Base URL: https://app-api.yangjibao.com
• 用途: 自选基金列表、持有人数排名、基金分组
• 认证: iOS 客户端抓包获取的 Token + 签名验证
• 脚本: scripts/yjb_watchlist.py

> ⚠️ 进阶功能，需自备 iOS Token：yjb_watchlist.py 依赖从 iPhone 抓包获取的 iOS Token，普通用户难以操作（需在 iOS 设备安装 Stream 等抓包工具、从 App 请求中提取 Authorization 头）。该功能为可选增强，不影响核心的「微信扫码登录 + 持仓查询」流程，新手用户可忽略此模块。

脚本总览

iOS Token 保存方式:

// 保存到 ~/.yjb_ios_token.json
{"token": "ios:a216f599-318e-4291-a9bc-01fbe6262825-2561347"}

一、个人持仓数据（数据源 B）

1.1 认证机制

所有 authenticated API 需要 3 个自定义 Header：

签名算法:

sign = MD5("" + path + token + timestamp + SECRET)
SECRET = "YxmKSrQR4uoJ5lOoWIhcbd7SlUEh9OOc"

其中 path 为 URL 路径（不含 query string）。

注意: 不带签名 header 的请求会返回 404（而非 401），这是服务器设计行为。

1.2 QR 码登录流程

执行 scripts/yjb_login.py 或内联执行以下步骤：

1. 获取 QR 码:
   GET http://browser-plug-api.yangjibao.com/qr_code
   返回 {id: "loginQrIdxxx", url: "http://weixin.qq.com/q/xxx"}

2. 展示 QR 码给用户扫描:
   使用 qrcode 库生成 ASCII 二维码，或提供在线图片链接：
   https://api.qrserver.com/v1/create-qr-code/?size=300x300&data={qr_url}

3. 轮询登录状态:
   GET http://browser-plug-api.yangjibao.com/qr_code_state/{qr_id}
state=1 等待扫码，state=2 已扫码（含 token）

4. 保存 Token 到 ~/.yjb_token.json:
   json {"token": "xxx", "timestamp": 1234567890}

1.3 核心 API 接口（需认证）

1.4 持仓数据字段说明

1.5 使用流程

首次使用:
1. 运行 scripts/yjb_login.py 生成二维码
2. 微信扫码登录
3. Token 自动保存，后续无需重复登录

日常查询:
- 直接执行 scripts/yjb_fetch.py 获取持仓汇总
- 或使用内联 Python 代码调用 API

Token 过期时:
- 重新运行 scripts/yjb_login.py 扫码登录

1.6 数据分析与呈现

获取持仓数据后，按以下格式汇总展示：

1. 账户汇总：总资产、今日收益、收益率
2. 指数行情：A股/港股/美股 12 个主要指数
3. 持仓明细表：基金名称、代码、市值、盈亏（🔴🟢标识）、份额、成本
4. 汇总统计：总市值、总盈亏

附录：app-api 认证接口（数据源 C）

通过 iOS 客户端抓包获取的 Token，可访问 app-api 上需要认证的接口。
脚本: scripts/yjb_watchlist.py

> ⚠️ 进阶功能提醒：本模块（数据源 C）非核心功能，需用户自行从 iOS 设备抓包获取 Token，门槛较高且 Token 易失效。发布/分享时请明确告知使用者：没有 iOS Token 不影响扫码登录与持仓查询的正常使用。

iOS Token 说明

• 从 iPhone 上养基宝 App 抓包获取 app-api.yangjibao.com 请求中的 Authorization header
• 格式: ios:xxxxx-xxxx-xxxx
• 有效期: 不确定，失败时需重新抓包获取

已发现接口

二、公网行情数据（数据源 A）

2.1 批量基金净值（无需登录）

POST https://app-api.yangjibao.com/market/v1/fund/batch
Content-Type: application/json
User-Agent: YJB/2.0.4
Body: {"funds": [{"fund_id": 1359, "data_source": "1"}, ...]}

基金 ID 映射见 references/fund-mapping.md。

2.2 返回字段

nv_info: dwjz(净值), rzzl(日涨幅), jzrq(净值日), vgszzl(估值涨幅), true_valuation_date(真实估值日)
其他: short_name, code, category, year_increase_rate, sector_info.name/ratio, market_type, heavy_position_info

2.3 历史净值 & 指数

GET https://app-api.yangjibao.com/market/v1/fund-nav/fund-history-nav?fund_id=X&page=1&per_page=30
GET https://app-api.yangjibao.com/market/v1/quote/index-data
GET https://app-api.yangjibao.com/market/v1/market-ranking/list
GET https://app-api.yangjibao.com/market/v1/fund/relation-gz-data?id=X&type=4
GET https://wx.yangjibao.com/wxapi/day_info

三、净值日期规则

1. A股基金: 净值日=最近交易日，当日 19:00-22:00 发布
2. QDII 基金: 净值滞后 2-3 个交易日，以 true_valuation_date 为准
3. 估值: vgsz/vgszzl 为当日盘中估值，A股收盘后更新
4. 建议: 20:00 后查询可获取完整当日净值

四、已知问题与排错