Stock SDK

简体中文

English

简体中文

English

Appearance

fundFlow · 资金流向（深度） ​

sdk.fundFlow 提供个股 / 大盘 / 排名 / 板块四个维度的资金流向数据（数据源：东方财富数据中心）。返回的是历史序列、排名榜与板块汇总，区别于 sdk.quotes.fundFlow（腾讯简版、按代码批量返回单日资金流）。

命名空间区分

  • sdk.quotes.fundFlow(codes) —— 简版，按代码批量返回当日资金流快照。
  • sdk.fundFlow.* —— 深度版，本页内容，提供历史、排名与板块维度。

资金流字段统一采用「主力 / 超大单 / 大单 / 中单 / 小单」五档结构，每档同时给出净额（计价货币主单位）与净占比（百分数，如 5.2 表示 5.2%）。

方法一览 ​

方法说明
fundFlow.individual(symbol, opts?)个股资金流历史（日 / 周 / 月线）
fundFlow.market()大盘资金流历史（上证 + 深证）
fundFlow.rank(opts?)个股资金流排名（按主力净流入排序）
fundFlow.sectorRank(opts?)板块资金流排名（行业 / 概念 / 地域）
fundFlow.sectorHistory(symbol, opts?)单个板块的历史资金流

具体参数与返回字段以最终实现为准；下方字段表反映当前数据契约。

日度资金流是盘后数据

资金流的日度序列（individual / market 等）由上游在收盘后统计，盘中查询取不到当天那一条，序列最新一天通常是上一个交易日。这是数据源的正常时效，不是调用出错。

需要当天数据请在收盘当晚之后再拉；写定时任务同理。

fundFlow.individual ​

获取个股的资金流历史（日 / 周 / 月线）。

ts
import { StockSDK } from 'stock-sdk';

const sdk = new StockSDK();

const flow = await sdk.fundFlow.individual('600519', { period: 'daily' });
const latest = flow.at(-1);
console.log(`${latest?.date} 主力净流入: ${latest?.mainNetInflow} 元`);

symbol 传裸字符串（如 'sh600519' / '600519'），由 normalizeSymbol 容错解析。

参数 ​

参数类型说明
symbolstring股票代码
options.period'daily' | 'weekly' | 'monthly'周期，默认 'daily'

返回说明 ​

返回 StockFundFlowDaily[]，按日期升序排列：

ts
interface StockFundFlowDaily {
  date: string;                          // YYYY-MM-DD
  close: number | null;                  // 收盘价
  changePercent: number | null;          // 涨跌幅（百分数）
  mainNetInflow: number | null;          // 主力净流入-净额（元）
  mainNetInflowPercent: number | null;   // 主力净流入-净占比（百分数）
  superLargeNetInflow: number | null;    // 超大单净流入-净额
  superLargeNetInflowPercent: number | null;
  largeNetInflow: number | null;         // 大单净流入-净额
  largeNetInflowPercent: number | null;
  mediumNetInflow: number | null;        // 中单净流入-净额
  mediumNetInflowPercent: number | null;
  smallNetInflow: number | null;         // 小单净流入-净额
  smallNetInflowPercent: number | null;
}

fundFlow.market ​

获取大盘资金流历史，同一条记录同时包含上证指数与深证成指。

ts
const market = await sdk.fundFlow.market();
const today = market.at(-1);
console.log(`上证 ${today?.shClose} (${today?.shChangePercent}%)`);
console.log(`主力净流入 ${today?.mainNetInflow} 元`);

返回说明 ​

返回 MarketFundFlow[]：

ts
interface MarketFundFlow {
  date: string;
  shClose: number | null;          // 上证指数收盘价
  shChangePercent: number | null;  // 上证指数涨跌幅（百分数）
  szClose: number | null;          // 深证成指收盘价
  szChangePercent: number | null;  // 深证成指涨跌幅（百分数）
  mainNetInflow: number | null;
  mainNetInflowPercent: number | null;
  // 超大单 / 大单 / 中单 / 小单 同 individual 结构（净额 + 净占比）
}

fundFlow.rank ​

按主力净流入排序的个股资金流排名。changePercent 与各档净流入对应所选周期（例如 5day 即 5 日数据）。

ts
const rank = await sdk.fundFlow.rank({ indicator: '5day' });
rank.slice(0, 10).forEach((item, i) => {
  console.log(`#${i + 1} ${item.name}(${item.code}) 主力净流入 ${item.mainNetInflow} 元`);
});

// 只取主力净流入前 20 名（单次请求）
const top20 = await sdk.fundFlow.rank({ page: 1, pageSize: 20 });
// 第 21–40 名
const next20 = await sdk.fundFlow.rank({ page: 2, pageSize: 20 });

参数 ​

参数类型说明
options.indicator'today' | '3day' | '5day' | '10day'统计周期，默认 'today'
options.pagenumber页码，从 1 开始；传 page / pageSize 任一即只请求这一页
options.pageSizenumber每页条数，1–100，默认 100

分页与全量

不传 page / pageSize 时返回全市场全量（约 5600 条）：SDK 按每页 100 条自动翻页，一次调用要发出 50 多次请求。只需要榜单前段时传分页参数，一次请求即可，也更不容易触发上游限流。

返回值仍是数组，不含总条数；某页条数少于 pageSize 即为最后一页。盘中排名实时变动，逐页翻取时相邻页之间可能出现少量重复或遗漏。

返回说明 ​

返回 FundFlowRankItem[]：

ts
interface FundFlowRankItem {
  code: string;
  name: string;
  price: number | null;                  // 最新价
  changePercent: number | null;          // 对应周期涨跌幅（百分数）
  mainNetInflow: number | null;          // 主力净流入-净额（元）
  mainNetInflowPercent: number | null;
  superLargeNetInflow: number | null;
  superLargeNetInflowPercent: number | null;
  largeNetInflow: number | null;
  largeNetInflowPercent: number | null;
  mediumNetInflow: number | null;
  mediumNetInflowPercent: number | null;
  smallNetInflow: number | null;
  smallNetInflowPercent: number | null;
}

fundFlow.sectorRank ​

板块资金流排名，支持行业 / 概念 / 地域三种维度。

ts
const sectors = await sdk.fundFlow.sectorRank({
  indicator: 'today',
  sectorType: 'industry',
});
sectors.slice(0, 5).forEach(s => {
  console.log(`${s.name}: 净流入 ${s.mainNetInflow} 元，领涨 ${s.topStockName}`);
});

// 概念板块主力净流入前 10
const topConcepts = await sdk.fundFlow.sectorRank({ sectorType: 'concept', page: 1, pageSize: 10 });

参数 ​

参数类型说明
options.indicator'today' | '3day' | '5day' | '10day'统计周期，默认 'today'
options.sectorType'industry' | 'concept' | 'region'板块维度，默认 'industry'
options.pagenumber页码，从 1 开始；传 page / pageSize 任一即只请求这一页，都不传返回全部板块
options.pageSizenumber每页条数，1–100，默认 100

返回说明 ​

返回 SectorFundFlowItem[]：

ts
interface SectorFundFlowItem {
  code: string;                  // 板块代码（东方财富 BK 编号，如 BK0475）
  name: string;                  // 板块名称
  changePercent: number | null;  // 百分数
  mainNetInflow: number | null;  // 主力净流入-净额（元）
  mainNetInflowPercent: number | null;
  superLargeNetInflow: number | null;
  largeNetInflow: number | null;
  mediumNetInflow: number | null;
  smallNetInflow: number | null;
  topStockName?: string;         // 主力净流入最大股名称
  topStockCode?: string;         // 主力净流入最大股代码
}

fundFlow.sectorHistory ​

获取单个板块的历史资金流。symbol 接受 BK 编号（如 BK0475）或带前缀的东财 secid（如 90.BK0475）。

ts
const banking = await sdk.fundFlow.sectorHistory('BK0475');
console.log(`银行板块历史数据 ${banking.length} 条`);

参数 ​

参数类型说明
symbolstring板块代码（BK 编号或东财 secid）
options.period'daily' | 'weekly' | 'monthly'周期，默认 'daily'

返回说明 ​

返回 StockFundFlowDaily[]，结构与 fundFlow.individual 一致（此处 close / changePercent 对应板块本身）。