fund · 公募基金扩展

公募基金深度数据：分红送配、历史净值、实时估值、同类排名走势、主题基金。

基金的实时行情请走 sdk.quotes.fund()，本命名空间是它的扩展。所有方法挂在 sdk.fund 命名空间下，由内部 FundService 承载，数据来源为东方财富 / 天天基金。

方法一览

方法	说明
`sdk.fund.dividendList(options?)`	按年份分页查询全市场基金分红送配明细
`sdk.fund.navHistory(code)`	单只基金完整历史净值（单位净值 + 累计净值）
`sdk.fund.estimate(code)`	当日盘中实时估值 + 最新已结算净值
`sdk.fund.rankHistory(code)`	同类排名走势（近三月排名 + 百分位）
`sdk.fund.profile(code)`	基金深度资料（重仓股 / 资产配置 / 基金经理 / 业绩评价等，一次返回）
`sdk.fund.theme.*`	主题基金：主题列表、热门排行、主题下基金排行

符号入参遵循 v2 统一约定：基金代码为纯数字字符串（如 '110011'）。具体字段以实现为准。

sdk.fund.dividendList

按年份查询基金分红送配明细（数据来自天天基金分红送配频道）。

上游接口本身只支持「年份 + 全市场 + 翻页」查询，不支持服务端按基金代码精确查；要拿单只基金该年完整分红记录，请同时设置 page: 'all' 与 code（客户端过滤）。

参数

interface FundDividendListOptions {
  /** 查询年份，默认当前年（Asia/Shanghai） */
  year?: number | string;
  /** 页码（从 1 开始，默认 1）；设为 'all' 时自动翻完该年所有页并聚合 */
  page?: number | 'all';
  /** 基金类型筛选（例：'股票型' / '指数型-股票' / 'REITs'），空表示全部 */
  fundType?: string;
  /** 排序字段，默认 'FSRQ'（除息日期） */
  rank?: 'BZDM' | 'ABBNAME' | 'DJR' | 'FSRQ' | 'FHFCZ' | 'FFR';
  /** 排序方向，默认 'desc' */
  sort?: 'asc' | 'desc';
  /** 按基金代码客户端过滤；一般搭配 page: 'all' 使用 */
  code?: string;
}

rank 取值对应字段：

取值	含义
`BZDM`	基金代码
`ABBNAME`	基金简称
`DJR`	权益登记日
`FSRQ`	除息日期（默认）
`FHFCZ`	分红（元/份）
`FFR`	分红发放日

调用示例

import { StockSDK } from 'stock-sdk';

const sdk = new StockSDK();

// 拉 2024 年第 1 页（默认按除息日倒序）
const r1 = await sdk.fund.dividendList({ year: 2024 });
console.log(r1.totalPages, r1.pageSize, r1.items.length);

// 拉 2024 年某只基金的完整分红
const r2 = await sdk.fund.dividendList({
  year: 2024,
  page: 'all',
  code: '110011',
});
r2.items.forEach((d) => {
  console.log(`${d.exDividendDate}  分红 ${d.dividendPerShare} 元/份`);
});

返回说明

返回 FundDividendListResult，含分页元信息与分红条目数组：

interface FundDividendListResult {
  items: FundDividend[];
  totalPages: number;   // 数据源汇报的总页数
  pageSize: number;     // 每页条数
  currentPage: number;  // 当前页码；page: 'all' 时为 -1 表示已聚合
}

interface FundDividend {
  code: string;
  name: string;
  equityRecordDate: string | null;  // 权益登记日 YYYY-MM-DD
  exDividendDate: string | null;    // 除息日期 YYYY-MM-DD
  dividendPerShare: number | null;  // 分红金额（元/份）
  payDate: string | null;           // 分红发放日 YYYY-MM-DD
}

v2 已移除返回对象上的 raw 字段（调试逃生舱改为 provider 层 getXxxRaw()）。具体字段以实现为准。

sdk.fund.navHistory

获取单只基金完整历史净值（单位净值 + 累计净值，按时间对齐合并）。

一次请求即拿到该基金从成立日到最新交易日的全部净值（数千条），无需翻页。开放式 / ETF / LOF / 货币 / QDII 均通用。

参数

参数	类型	必填	说明
`code`	`string`	是	基金代码（纯数字，如 `'110011'`）

调用示例

const h = await sdk.fund.navHistory('110011');

console.log(h.name, '共', h.items.length, '条净值');
const latest = h.items[h.items.length - 1];
console.log(`最新: ${latest.date}  单位 ${latest.nav}  累计 ${latest.accNav}`);

// 拿最近 5 个交易日
console.log(h.items.slice(-5));

返回说明

返回 FundNavHistory，items 按日期升序：

interface FundNavHistory {
  code: string;
  name: string | null;
  items: FundNavPoint[];
}

interface FundNavPoint {
  date: string;                // 净值日期 YYYY-MM-DD
  timestamp: number | null;    // UTC 毫秒；无法解析为 null
  nav: number;                 // 单位净值
  accNav: number | null;       // 累计净值（对齐失败为 null）
  dailyReturn: number | null;  // 日增长率（百分数，如 1.23）
  unitMoney: string;           // 每万份收益（货币基金有意义；其余多为空串）
}

数据量提示

单次响应较大（约 600KB / gzip 后约 120KB）。同一基金多次使用建议借助统一缓存层或自行缓存。

sdk.fund.estimate

获取基金当日盘中实时估值（来自天天基金 fundgz 接口）。

同时返回最新已结算的单位净值（nav + navDate）和盘中实时估算（estimatedNav + estimatedChangePercent + estimateTime），适合做「当日实时表现 vs 上一收盘」对比。

QDII / 非交易日 / 部分小众基金的盘中估算字段可能为空，会返回 null。

参数

参数	类型	必填	说明
`code`	`string`	是	基金代码（纯数字，如 `'005827'`）

调用示例

const e = await sdk.fund.estimate('005827');
console.log(`${e.name}  最新净值 ${e.nav}（${e.navDate}）`);
console.log(`盘中估算 ${e.estimatedNav}  (${e.estimatedChangePercent}%)`);
console.log(`估算时间 ${e.estimateTime}`);

返回说明

interface FundEstimate {
  code: string;
  name: string | null;
  navDate: string | null;                // 已结算净值日期 YYYY-MM-DD
  nav: number | null;                    // 已结算单位净值
  estimatedNav: number | null;           // 盘中实时估值
  estimatedChangePercent: number | null; // 估算涨跌幅（百分数，如 1.23）
  estimateTime: string | null;           // 估算时间，如 "2026-05-26 15:00"
}

sdk.fund.rankHistory

获取基金同类排名走势（每日近三月排名 + 百分位）。

数据源与 navHistory 相同（同一份 pingzhongdata 文件，不同字段），适合做「该基金在同类基金里的相对表现」折线图。

参数

参数	类型	必填	说明
`code`	`string`	是	基金代码

调用示例

const r = await sdk.fund.rankHistory('110011');
const latest = r.items[r.items.length - 1];
console.log(`${r.name}  最新排名 ${latest.rank}/${latest.total}（前 ${latest.percentile}%）`);

返回说明

interface FundRankHistory {
  code: string;
  name: string | null;
  items: FundRankPoint[];
}

interface FundRankPoint {
  date: string;               // 报告日期 YYYY-MM-DD
  timestamp: number | null;   // UTC 毫秒；无法解析为 null
  rank: number | null;        // 同类近三月排名（越小越前）
  total: number | null;       // 同类基金总数
  percentile: number | null;  // 同类百分位（百分数，越小越好）
}

sdk.fund.profile

一次请求获取基金深度资料（东方财富 pingzhongdata 全量字段）：前十大重仓股、前五大债券、季度资产配置、每日股票仓位测算、基金经理、业绩评价、持有人结构、规模变动、申购赎回、阶段收益率、同类基金等。

数据源与 navHistory / rankHistory 相同（同一份 pingzhongdata 文件，不同字段）。适合搭一个「基金详情页」所需的大部分静态资料。

字段随基金类型与上游数据完整度可能为空：数组字段缺数据时为 []，对象字段（performance / sameType）缺数据时为 null，标量缺失时为 null 或 0（占比类）。

参数

参数	类型	必填	说明
`code`	`string`	是	基金代码（纯数字，如 `'000001'`）

调用示例

const p = await sdk.fund.profile('000001');

console.log(`${p.name}  重仓股 ${p.holdings.length} 只`);
// 重仓股代码可拼接东财 secid：`${marketId}.${code}`
p.holdings.forEach((h) => console.log(`${h.marketId}.${h.code}`));

// 基金经理（含星级与能力评分）
p.managers.forEach((m) => {
  console.log(`${m.name}  ★${m.star}  ${m.workTime}  ${m.fundSize}`);
  if (m.power) console.log(`  综合评分 ${m.power.overall}`);
});

// 最新一期资产配置
const a = p.assetAllocation.at(-1);
if (a) console.log(`股票 ${a.stockRatio}% / 债券 ${a.bondRatio}% / 现金 ${a.cashRatio}%`);

// 业绩评价综合分
console.log('综合评分', p.performance?.overall);

// 阶段收益率
console.log(p.stageReturns); // { oneMonth, threeMonth, sixMonth, oneYear }

返回说明

返回 FundProfile，数组字段缺数据为 []、对象字段缺数据为 null：

interface FundProfile {
  code: string;
  name: string | null;
  sourceRate: number | null;        // 原申购费率（%）
  rate: number | null;              // 现申购费率（%）
  minSubscription: number | null;   // 最小申购金额（元）
  holdings: FundHolding[];          // 前十大重仓股
  bondHoldings: FundBondHolding[];  // 前五大债券持仓
  assetAllocation: FundAssetAllocation[]; // 季度资产配置
  positions: FundPositionPoint[];   // 每日股票仓位测算
  managers: FundManager[];          // 基金经理
  performance: FundPerformanceEvaluation | null; // 业绩评价
  holderStructure: FundHolderStructure[];        // 持有人结构
  scaleChanges: FundScaleChange[];  // 规模变动
  buySedemption: FundBuySedemption[]; // 申购赎回
  stageReturns: FundStageReturns;   // 阶段收益率
  sameType: FundSameType | null;    // 同类基金
}

interface FundHolding {
  code: string;      // 股票代码（纯数字，如 "600519"）
  marketId: string;  // 新市场号（"0"=深圳, "1"=上海），拼 secid 用
}

interface FundManager {
  id: string;
  name: string;
  avatarUrl: string | null;  // 头像 URL
  star: number | null;       // 星级（0–5）
  workTime: string | null;   // 任职年限描述，如 "14年又192天"（上游原文）
  fundSize: string | null;   // 在管规模描述，如 "78.91亿(4只基金)"（上游原文）
  power: FundPerformanceEvaluation | null; // 能力评分（结构同业绩评价）
}

interface FundPerformanceEvaluation {
  overall: number;        // 综合评分
  categories: string[];   // 评价维度
  scores: number[];       // 各维度得分
  descriptions: string[]; // 各维度描述
}

interface FundAssetAllocation {
  date: string;        // 报告期 YYYY-MM-DD
  timestamp: number | null; // UTC 毫秒；日期无法解析为 null
  stockRatio: number;  // 股票占净比（%）
  bondRatio: number;   // 债券占净比（%）
  cashRatio: number;   // 现金占净比（%）
  otherRatio: number;  // 其他占净比（%）；上游不提供时为 0
  netAsset: number;    // 净资产（亿元）
}

interface FundStageReturns {
  oneMonth: number | null;   // 近一月（%）
  threeMonth: number | null; // 近三月（%）
  sixMonth: number | null;   // 近六月（%）
  oneYear: number | null;    // 近一年（%）
}

// 同类基金：上游按多个维度各取一组，groups 外层为分组、内层为该组基金
interface FundSameType {
  groups: Array<Array<{ code: string; name: string; value: number | null }>>;
}

其余子类型（FundBondHolding / FundPositionPoint / FundHolderStructure / FundScaleChange / FundBuySedemption）字段含义见类型定义，结构与上表同构。

sdk.fund.theme.getThemeList

获取主题基金列表（东方财富天天基金），可按行业/概念筛选，按日涨幅/各阶段收益率排序分页。

参数

interface GetThemeListOptions {
  /** 排序字段：ZDF(日涨幅)/SYL_W(近1周)/SYL_M(近1月)/SYL_3M(近3月)/SYL_6M(近6月)/SYL_Y(近1年)/SYL_3Y(近3年)/SYL_5Y(近5年)，默认 ZDF */
  sort?: string;
  /** 排序方向：desc(降序，默认)/asc(升序) */
  order?: 'desc' | 'asc';
  /** 主题类型：'0'(行业)/'1'(概念)/'2'(全部，默认) */
  category?: '0' | '1' | '2';
  /** 每页条数，默认 20，最大 50 */
  pageSize?: number;
  /** 页码，默认 1 */
  page?: number;
}

调用示例

// 获取全部主题，按日涨幅降序
const themes = await sdk.fund.theme.getThemeList({ sort: 'ZDF', order: 'desc', pageSize: 20 });
console.log(themes.items.map(t => `${t.name} ${t.dailyChange}%`));

// 获取行业主题，按近1年收益率排序
const industryThemes = await sdk.fund.theme.getThemeList({
  category: '0',
  sort: 'SYL_Y',
  order: 'desc',
});

返回说明

返回 ThemeFundListResult，含分页元信息与主题条目：

interface ThemeFundListResult {
  items: ThemeFund[];
  totalPages: number;   // 总页数
  pageSize: number;     // 每页条数
  currentPage: number;  // 当前页码
}

interface ThemeFund {
  code: string;               // 主题代码，如 'BK0438'
  name: string;               // 主题名称，如 '食品饮料'
  dailyChange: number | null; // 日涨幅 %
  weeklyReturn: number | null;    // 近1周收益率 %
  monthlyReturn: number | null;   // 近1月收益率 %
  quarterlyReturn: number | null; // 近3月收益率 %
  halfYearReturn: number | null;  // 近6月收益率 %
  yearlyReturn: number | null;    // 近1年收益率 %
  threeYearReturn: number | null; // 近3年收益率 %
  fiveYearReturn: number | null;  // 近5年收益率 %
  type: string;               // '行业' 或 '概念'
}

sdk.fund.theme.getThemeFunds

获取指定主题下的基金排行列表。themeCode 为主题代码（如 BK0438 = 食品饮料），可通过 getThemeList 获取。

参数

interface GetThemeFundsOptions {
  /** 排序字段：SYL_Z(近1周)/SYL_Y(近1月)/SYL_3Y(近3月)/SYL_1N(近1年，默认)/RZDF(日涨幅) */
  sortColumn?: string;
  /** 排序方向：desc(降序，默认)/asc(升序) */
  sort?: 'desc' | 'asc';
  /** 每页条数，默认 10，最大 30 */
  pageSize?: number;
  /** 页码，默认 1 */
  page?: number;
  /** 基金类型筛选，如 '股票型'/'混合型'，空表示全部 */
  fundType?: string;
}

调用示例

// 获取食品饮料主题下近1年收益靠前的基金
const funds = await sdk.fund.theme.getThemeFunds('BK0438', {
  sortColumn: 'SYL_1N',
  sort: 'desc',
  pageSize: 10,
});
funds.items.forEach(f => {
  console.log(`${f.code} ${f.name}: 1Y return ${f.yearlyReturn}%`);
});

返回说明

interface ThemeFundItemList {
  items: ThemeFundItem[];
  total: number;
  pageIndex: number;
  pageSize: number;
}

interface ThemeFundItem {
  code: string;
  name: string;
  fundType: string;
  dailyChange: number | null;
  weeklyReturn: number | null;
  monthlyReturn: number | null;
  quarterlyReturn: number | null;
  yearlyReturn: number | null;
  nav: number | null;
  themeCode: string;
  themeName?: string; // 上游不返回，通常缺省
}

注意事项

数据源：分红走 fund.eastmoney.com/Data/funddataIndex_Interface.aspx；历史净值 / 同类排名 / 深度资料走 fund.eastmoney.com/pingzhongdata/{code}.js；实时估值走 fundgz.1234567.com.cn/js/{code}.js。
同基金同接口：navHistory / rankHistory / profile 实际下载同一份 pingzhongdata 文件（约 600KB），只是取不同字段。如同时需要多类数据，建议借助缓存层避免重复下载。
浏览器端串行：浏览器端这些接口通过 <script> 注入加载（数据源无 CORS 头），SDK 内部用脚本互斥锁兜底并发覆盖，因此 Promise.all([...]) 在浏览器端实际是串行的。Node 端不受此限制。
请求治理差异：Node 端这些方法已接入 RequestClient（retry / providerPolicies 生效）；浏览器端 <script> 注入路径不走 fetch，headers / rateLimit / circuitBreaker 不生效，timeout 通过内部参数生效。详见请求治理。
场内 ETF 行情：场内 ETF（如 510050、159919）的实时行情与 K 线请走 sdk.quotes.cn() / sdk.kline.cn() 等股票接口，不走本命名空间。

fund · 公募基金扩展 ​

方法一览 ​

sdk.fund.dividendList ​

参数 ​

调用示例 ​

返回说明 ​

sdk.fund.navHistory ​

参数 ​

调用示例 ​

返回说明 ​

sdk.fund.estimate ​

参数 ​

调用示例 ​

返回说明 ​

sdk.fund.rankHistory ​

参数 ​

调用示例 ​

返回说明 ​

sdk.fund.profile ​

参数 ​

调用示例 ​

返回说明 ​

sdk.fund.theme.getThemeList ​

参数 ​

调用示例 ​

返回说明 ​

sdk.fund.theme.getThemeFunds ​

参数 ​

调用示例 ​

返回说明 ​

注意事项 ​

fund · 公募基金扩展

方法一览

sdk.fund.dividendList

参数

调用示例

返回说明

sdk.fund.navHistory

参数

调用示例

返回说明

sdk.fund.estimate

参数

调用示例

返回说明

sdk.fund.rankHistory

参数

调用示例

返回说明

sdk.fund.profile

参数

调用示例

返回说明

sdk.fund.theme.getThemeList

参数

调用示例

返回说明

sdk.fund.theme.getThemeFunds

参数

调用示例

返回说明

注意事项