stock-sdk 1.8.3 → 1.9.1

package/dist/index.d.cts

@@ -989,6 +989,15 @@ interface SearchResult {
      */
     category?: SearchResultType;
 }
+/**
+ * 外部财经站点链接
+ */
+interface ExternalLink {
+    /** 站点名称 */
+    name: string;
+    /** 可直接打开的 URL */
+    url: string;
+}
 /**
  * 分红派送详情
  */
@@ -1017,6 +1026,646 @@ interface DividendDetail {
     noticeDate: string | null;
 }
 
+/**
+ * 资金流向相关数据类型
+ */
+/**
+ * 个股资金流（日/周/月线）
+ */
+interface StockFundFlowDaily {
+    /** 日期 YYYY-MM-DD */
+    date: string;
+    /** 收盘价 */
+    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;
+}
+/**
+ * 个股资金流排名项（多维度统一结构，按排序周期返回相应周期数据）
+ */
+interface FundFlowRankItem {
+    /** 股票代码 */
+    code: string;
+    /** 股票名称 */
+    name: string;
+    /** 最新价 */
+    price: number | null;
+    /** 涨跌幅(%)（对应排序周期，例如 5 日则为 5 日涨跌幅） */
+    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;
+}
+/**
+ * 板块资金流排名项
+ */
+interface SectorFundFlowItem {
+    /** 板块代码（东方财富 BK 编号） */
+    code: string;
+    /** 板块名称 */
+    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;
+}
+/**
+ * 大盘资金流（按日）
+ */
+interface MarketFundFlow {
+    /** 日期 YYYY-MM-DD */
+    date: string;
+    /** 上证指数收盘价 */
+    shClose: number | null;
+    /** 上证指数涨跌幅(%) */
+    shChangePercent: number | null;
+    /** 深证指数收盘价 */
+    szClose: number | null;
+    /** 深证指数涨跌幅(%) */
+    szChangePercent: 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;
+}
+
+/**
+ * 沪深港通 / 北向资金 数据类型
+ */
+/** 资金方向 */
+type NorthboundDirection = 'north' | 'south';
+/** 北向持股市场 */
+type NorthboundMarket = 'all' | 'shanghai' | 'shenzhen';
+/** 北向持股排行查询周期 */
+type NorthboundRankPeriod = 'today' | '3day' | '5day' | '10day' | 'month' | 'quarter' | 'year';
+/**
+ * 北向 / 南向资金分时数据
+ */
+interface NorthboundMinuteItem {
+    /** 日期 YYYY-MM-DD */
+    date: string;
+    /** 时间 HH:MM */
+    time: string;
+    /** 沪股通 / 港股通(沪) 净流入(万元) */
+    shanghaiNetInflow: number | null;
+    /** 深股通 / 港股通(深) 净流入(万元) */
+    shenzhenNetInflow: number | null;
+    /** 合计净流入(万元) */
+    totalNetInflow: number | null;
+}
+/**
+ * 沪深港通市场资金流向汇总（datacenter RPT_MUTUAL_QUOTA）
+ */
+interface NorthboundFlowSummary {
+    /** 交易日 YYYY-MM-DD */
+    date: string;
+    /** 类型编号 */
+    type: string;
+    /** 板块名称（如「沪股通」「港股通(沪)」） */
+    boardName: string;
+    /** 资金方向（如「北向资金」「南向资金」） */
+    direction: string;
+    /** 交易状态 */
+    status: string;
+    /** 成交净买额(元，原始接口单位) */
+    netBuyAmount: number | null;
+    /** 资金净流入(元) */
+    netInflow: number | null;
+    /** 当日资金余额(元) */
+    remainAmount: number | null;
+    /** 上涨数 */
+    upCount: number | null;
+    /** 持平数 */
+    flatCount: number | null;
+    /** 下跌数 */
+    downCount: number | null;
+    /** 相关指数代码 */
+    indexCode: string;
+    /** 相关指数名称 */
+    indexName: string;
+    /** 指数涨跌幅(%) */
+    indexChangePercent: number | null;
+}
+/**
+ * 北向 / 沪股通 / 深股通持股个股排行项
+ */
+interface NorthboundHoldingRankItem {
+    /** 日期 YYYY-MM-DD */
+    date: string;
+    /** 股票代码 */
+    code: string;
+    /** 股票名称 */
+    name: string;
+    /** 今日收盘价 */
+    close: number | null;
+    /** 今日涨跌幅(%) */
+    changePercent: number | null;
+    /** 今日持股股数 */
+    holdShares: number | null;
+    /** 今日持股市值(元) */
+    holdMarketValue: number | null;
+    /** 持股占流通股比(%) */
+    holdRatioFloat: number | null;
+    /** 持股占总股本比(%) */
+    holdRatioTotal: number | null;
+    /** 区间增持估计股数 */
+    addShares: number | null;
+    /** 区间增持估计市值(元) */
+    addMarketValue: number | null;
+    /** 区间增持估计市值增幅(%) */
+    addMarketValuePercent: number | null;
+    /** 所属板块 */
+    sector: string;
+}
+/**
+ * 北向资金历史项（按日）
+ */
+interface NorthboundHistoryItem {
+    /** 日期 YYYY-MM-DD */
+    date: string;
+    /** 成交净买额(元) */
+    netBuyAmount: number | null;
+    /** 买入成交额(元) */
+    buyAmount: number | null;
+    /** 卖出成交额(元) */
+    sellAmount: number | null;
+    /** 历史累计净买额(元) */
+    accNetBuyAmount: number | null;
+    /** 当日资金流入(元) */
+    netInflow: number | null;
+    /** 当日资金余额(元) */
+    remainAmount: number | null;
+    /** 领涨股代码 */
+    topStockCode: string | null;
+    /** 领涨股名称 */
+    topStockName: string | null;
+    /** 领涨股涨跌幅(%) */
+    topStockChangePercent: number | null;
+}
+/**
+ * 个股北向持仓历史项
+ */
+interface NorthboundIndividualItem {
+    /** 日期 YYYY-MM-DD */
+    date: string;
+    /** 持股数量 */
+    holdShares: number | null;
+    /** 持股市值(元) */
+    holdMarketValue: number | null;
+    /** 持股占流通股比(%) */
+    holdRatioFloat: number | null;
+    /** 持股占总股本比(%) */
+    holdRatioTotal: number | null;
+    /** 收盘价 */
+    close: number | null;
+    /** 涨跌幅(%) */
+    changePercent: number | null;
+}
+
+/**
+ * 涨停板 / 盘口异动 数据类型
+ */
+/** 涨停股池类型 */
+type ZTPoolType = 'zt' | 'yesterday' | 'strong' | 'sub_new' | 'broken' | 'dt';
+/**
+ * 涨停股池项（统一字段，部分类型某些字段为空）
+ */
+interface ZTPoolItem {
+    /** 股票代码 */
+    code: string;
+    /** 股票名称 */
+    name: string;
+    /** 最新价(元) */
+    price: number | null;
+    /** 涨跌幅(%) */
+    changePercent: number | null;
+    /** 涨停价(元) - 仅部分池子返回 */
+    limitPrice: number | null;
+    /** 成交额(元) */
+    amount: number | null;
+    /** 流通市值(元) */
+    floatMarketValue: number | null;
+    /** 总市值(元) */
+    totalMarketValue: number | null;
+    /** 换手率(%) */
+    turnoverRate: number | null;
+    /** 连板数 - 仅涨停股池返回 */
+    continuousBoardCount: number | null;
+    /** 首次封板时间 HHMMSS - 涨停/炸板池 */
+    firstBoardTime: string | null;
+    /** 最后封板时间 HHMMSS - 涨停池 */
+    lastBoardTime: string | null;
+    /** 封板资金(元) - 涨停池 */
+    boardAmount: number | null;
+    /** 封单资金(元) - 跌停池 */
+    sealAmount: number | null;
+    /** 炸板次数 */
+    failedCount: number | null;
+    /** 所属行业 */
+    industry: string;
+    /** 涨停统计（如 '3/5' 表示 5 天内涨停 3 次） */
+    ztStatistics: string;
+    /** 振幅(%) - 部分池子返回 */
+    amplitude: number | null;
+    /** 涨速 - 部分池子返回 */
+    speed: number | null;
+}
+/** 盘口异动类型 */
+type StockChangeType = 'rocket_launch' | 'quick_rebound' | 'large_buy' | 'limit_up_seal' | 'limit_down_open' | 'big_buy_order' | 'auction_up' | 'high_open_5d' | 'gap_up' | 'high_60d' | 'surge_60d' | 'accelerate_down' | 'high_dive' | 'large_sell' | 'limit_down_seal' | 'limit_up_open' | 'big_sell_order' | 'auction_down' | 'low_open_5d' | 'gap_down' | 'low_60d' | 'drop_60d';
+/**
+ * 盘口异动项
+ */
+interface StockChangeItem {
+    /** 发生时间 HH:MM:SS */
+    time: string;
+    /** 股票代码 */
+    code: string;
+    /** 股票名称 */
+    name: string;
+    /** 异动类型 */
+    changeType: StockChangeType;
+    /** 异动类型对应的中文标签 */
+    changeTypeLabel: string;
+    /** 相关信息（来自原始接口） */
+    info: string;
+}
+/**
+ * 板块异动项
+ */
+interface BoardChangeItem {
+    /** 板块名称 */
+    name: string;
+    /** 涨跌幅(%) */
+    changePercent: number | null;
+    /** 主力净流入(元) */
+    mainNetInflow: number | null;
+    /** 异动总次数 */
+    totalChangeCount: number | null;
+    /** 异动最频繁个股代码 */
+    topStockCode: string;
+    /** 异动最频繁个股名称 */
+    topStockName: string;
+    /** 异动最频繁个股方向：'大笔买入' | '大笔卖出' */
+    topStockDirection: string;
+    /** 异动类型分布（key 为类型代码，value 为出现次数） */
+    changeTypeDistribution: Record<string, number>;
+}
+
+/**
+ * 龙虎榜数据类型
+ */
+/** 龙虎榜统计周期 */
+type DragonTigerPeriod = '1month' | '3month' | '6month' | '1year';
+/**
+ * 龙虎榜详情项
+ */
+interface DragonTigerDetailItem {
+    /** 股票代码 */
+    code: string;
+    /** 股票名称 */
+    name: string;
+    /** 上榜日期 YYYY-MM-DD */
+    date: string;
+    /** 收盘价 */
+    close: number | null;
+    /** 涨跌幅(%) */
+    changePercent: number | null;
+    /** 龙虎榜净买额(元) */
+    netBuyAmount: number | null;
+    /** 龙虎榜买入额(元) */
+    buyAmount: number | null;
+    /** 龙虎榜卖出额(元) */
+    sellAmount: number | null;
+    /** 龙虎榜成交额(元) */
+    dealAmount: number | null;
+    /** 市场总成交额(元) */
+    totalAmount: number | null;
+    /** 净买额占总成交比(%) */
+    netBuyRatio: number | null;
+    /** 成交额占总成交比(%) */
+    dealAmountRatio: number | null;
+    /** 换手率(%) */
+    turnoverRate: number | null;
+    /** 流通市值(元) */
+    floatMarketValue: number | null;
+    /** 上榜原因 */
+    reason: string;
+    /** 上榜后 1 日涨跌幅(%) */
+    afterChange1d: number | null;
+    /** 上榜后 2 日涨跌幅(%) */
+    afterChange2d: number | null;
+    /** 上榜后 5 日涨跌幅(%) */
+    afterChange5d: number | null;
+    /** 上榜后 10 日涨跌幅(%) */
+    afterChange10d: number | null;
+}
+/**
+ * 龙虎榜个股上榜统计项
+ */
+interface DragonTigerStockStatItem {
+    /** 股票代码 */
+    code: string;
+    /** 股票名称 */
+    name: string;
+    /** 最近上榜日 YYYY-MM-DD */
+    latestDate: string;
+    /** 收盘价 */
+    close: number | null;
+    /** 涨跌幅(%) */
+    changePercent: number | null;
+    /** 上榜次数 */
+    count: number | null;
+    /** 龙虎榜累计买入额(元) */
+    totalBuyAmount: number | null;
+    /** 龙虎榜累计卖出额(元) */
+    totalSellAmount: number | null;
+    /** 龙虎榜累计净额(元) */
+    totalNetAmount: number | null;
+    /** 龙虎榜累计成交额(元) */
+    totalDealAmount: number | null;
+    /** 累计买方机构次数 */
+    buyOrgCount: number | null;
+    /** 累计卖方机构次数 */
+    sellOrgCount: number | null;
+}
+/**
+ * 龙虎榜机构买卖项
+ */
+interface DragonTigerInstitutionItem {
+    /** 股票代码 */
+    code: string;
+    /** 股票名称 */
+    name: string;
+    /** 上榜日期 YYYY-MM-DD */
+    date: string;
+    /** 收盘价 */
+    close: number | null;
+    /** 涨跌幅(%) */
+    changePercent: number | null;
+    /** 买方机构数 */
+    buyOrgCount: number | null;
+    /** 卖方机构数 */
+    sellOrgCount: number | null;
+    /** 机构买入额(元) */
+    orgBuyAmount: number | null;
+    /** 机构卖出额(元) */
+    orgSellAmount: number | null;
+    /** 机构净额(元) */
+    orgNetAmount: number | null;
+}
+/**
+ * 龙虎榜营业部排行项
+ */
+interface DragonTigerBranchItem {
+    /** 营业部代码 */
+    code: string;
+    /** 营业部名称 */
+    name: string;
+    /** 买入总额(元) */
+    totalBuyAmount: number | null;
+    /** 卖出总额(元) */
+    totalSellAmount: number | null;
+    /** 买入次数 */
+    buyCount: number | null;
+    /** 卖出次数 */
+    sellCount: number | null;
+    /** 上榜次数 */
+    totalCount: number | null;
+}
+/**
+ * 龙虎榜个股席位明细项
+ */
+interface DragonTigerSeatItem {
+    /** 排名 */
+    rank: number | null;
+    /** 营业部名称 */
+    branchName: string;
+    /** 买入额(元) */
+    buyAmount: number | null;
+    /** 买入占总成交比(%) */
+    buyAmountRatio: number | null;
+    /** 卖出额(元) */
+    sellAmount: number | null;
+    /** 卖出占总成交比(%) */
+    sellAmountRatio: number | null;
+    /** 净额(元) */
+    netAmount: number | null;
+    /** 类型标识: 'buy' | 'sell' */
+    side: 'buy' | 'sell';
+}
+/**
+ * 龙虎榜日期范围参数
+ */
+interface DragonTigerDateOptions {
+    /** 开始日期 YYYYMMDD */
+    startDate: string;
+    /** 结束日期 YYYYMMDD */
+    endDate: string;
+}
+
+/**
+ * 大宗交易数据类型
+ */
+/**
+ * 大宗交易市场统计项（按日）
+ */
+interface BlockTradeMarketStatItem {
+    /** 交易日期 YYYY-MM-DD */
+    date: string;
+    /** 上证指数 */
+    shClose: number | null;
+    /** 上证指数涨跌幅(%) */
+    shChangePercent: number | null;
+    /** 大宗交易成交总额(元) */
+    totalAmount: number | null;
+    /** 溢价成交总额(元) */
+    premiumAmount: number | null;
+    /** 溢价成交占比(%) */
+    premiumRatio: number | null;
+    /** 折价成交总额(元) */
+    discountAmount: number | null;
+    /** 折价成交占比(%) */
+    discountRatio: number | null;
+}
+/**
+ * 大宗交易明细项
+ */
+interface BlockTradeDetailItem {
+    /** 股票代码 */
+    code: string;
+    /** 股票名称 */
+    name: string;
+    /** 交易日期 YYYY-MM-DD */
+    date: string;
+    /** 收盘价 */
+    close: number | null;
+    /** 涨跌幅(%) */
+    changePercent: number | null;
+    /** 成交价(元) */
+    dealPrice: number | null;
+    /** 成交量(股) */
+    dealVolume: number | null;
+    /** 成交额(元) */
+    dealAmount: number | null;
+    /** 溢价率(%) */
+    premiumRate: number | null;
+    /** 买方营业部 */
+    buyBranch: string;
+    /** 卖方营业部 */
+    sellBranch: string;
+}
+/**
+ * 大宗交易每日统计项（按股票汇总）
+ */
+interface BlockTradeDailyStatItem {
+    /** 股票代码 */
+    code: string;
+    /** 股票名称 */
+    name: string;
+    /** 交易日期 YYYY-MM-DD */
+    date: string;
+    /** 涨跌幅(%) */
+    changePercent: number | null;
+    /** 收盘价 */
+    close: number | null;
+    /** 成交笔数 */
+    dealCount: number | null;
+    /** 成交总额(元) */
+    dealTotalAmount: number | null;
+    /** 成交总量(股) */
+    dealTotalVolume: number | null;
+    /** 溢价成交额(元) */
+    premiumAmount: number | null;
+    /** 折价成交额(元) */
+    discountAmount: number | null;
+}
+/**
+ * 大宗交易日期范围参数
+ */
+interface BlockTradeDateOptions {
+    /** 开始日期 YYYYMMDD 或 YYYY-MM-DD */
+    startDate?: string;
+    /** 结束日期 YYYYMMDD 或 YYYY-MM-DD */
+    endDate?: string;
+}
+
+/**
+ * 融资融券数据类型
+ */
+/**
+ * 融资融券账户统计项（按日）
+ */
+interface MarginAccountItem {
+    /** 日期 YYYY-MM-DD */
+    date: string;
+    /** 融资余额(元) */
+    finBalance: number | null;
+    /** 融券余额(元) */
+    loanBalance: number | null;
+    /** 融资买入额(元) */
+    finBuyAmount: number | null;
+    /** 融券卖出额(元) */
+    loanSellAmount: number | null;
+    /** 参与交易的投资者数量 */
+    investorCount: number | null;
+    /** 有融资融券负债的投资者数量 */
+    liabilityInvestorCount: number | null;
+    /** 担保物总价值(元) */
+    totalGuarantee: number | null;
+    /** 平均维持担保比例(%) */
+    avgGuaranteeRatio: number | null;
+}
+/**
+ * 融资融券标的证券项
+ */
+interface MarginTargetItem {
+    /** 证券代码 */
+    code: string;
+    /** 证券名称 */
+    name: string;
+    /** 日期 YYYY-MM-DD */
+    date: string;
+    /** 融资余额(元) */
+    finBalance: number | null;
+    /** 融资买入额(元) */
+    finBuyAmount: number | null;
+    /** 融资偿还额(元) */
+    finRepayAmount: number | null;
+    /** 融券余量(股) */
+    loanBalance: number | null;
+    /** 融券卖出量(股) */
+    loanSellVolume: number | null;
+    /** 融券偿还量(股) */
+    loanRepayVolume: number | null;
+}
+
 /**
  * 腾讯财经 - 批量操作
  */
@@ -1254,6 +1903,110 @@ interface ComexInventoryOptions {
     pageSize?: number;
 }
 
+/**
+ * 东方财富 datacenter-web 通用请求器
+ * 统一封装分页拉取、参数构建、响应解析。
+ *
+ * 覆盖场景：北向资金、龙虎榜、融资融券、大宗交易、股东分析等所有
+ * 走 `https://datacenter-web.eastmoney.com/api/data/v1/get` 的接口。
+ */
+
+/**
+ * datacenter 查询参数
+ */
+interface DatacenterQuery {
+    /** 报表名称（如 RPT_MUTUAL_STOCK_NORTHSTA） */
+    reportName: string;
+    /** 返回字段，默认 'ALL' */
+    columns?: string;
+    /** 过滤表达式，如 (TRADE_DATE='2024-01-15') */
+    filter?: string;
+    /** 排序字段（多个用逗号分隔） */
+    sortColumns?: string;
+    /** 排序方向：'-1' 降序, '1' 升序（多个用逗号分隔） */
+    sortTypes?: string;
+    /** 每页大小，默认 500 */
+    pageSize?: number;
+    /** 起始页码，默认 1 */
+    startPage?: number;
+    /** 是否自动拉取全部分页，默认 true */
+    fetchAllPages?: boolean;
+    /**
+     * 最大拉取页数（仅作为死循环安全阀，默认 1000）。
+     *
+     * 取较大默认值是为了恢复原 dividend / futuresInventory 等接口"拉完所有页"的语义；
+     * 大多数 datacenter 接口分页远低于此上限。如果确实希望限制拉取页数，
+     * 调用方应显式传入较小的 `maxPages` 值。
+     *
+     * 命中此上限时会在 console 输出 warning 提示，避免数据被静默截断。
+     */
+    maxPages?: number;
+    /** 额外的 quoteColumns 参数（用于行情字段聚合） */
+    quoteColumns?: string;
+    /** 额外的 quoteType 参数 */
+    quoteType?: string;
+    /** 额外补充的查询参数（覆盖默认值，用于个别接口的特殊字段） */
+    extraParams?: Record<string, string>;
+}
+/**
+ * datacenter 分页响应
+ */
+interface DatacenterResult<T> {
+    /** 解析后的数据列表 */
+    data: T[];
+    /** 总记录数（来自首页） */
+    total: number;
+    /** 总页数（来自首页） */
+    pages: number;
+}
+
+/**
+ * 东方财富 - 资金流向
+ * 数据来源：
+ *   - 个股/板块资金流历史: https://push2his.eastmoney.com/api/qt/stock/fflow/daykline/get
+ *   - 资金流排名:           https://push2.eastmoney.com/api/qt/clist/get
+ */
+
+/** 资金流周期 */
+interface FundFlowOptions {
+    /** 周期: 'daily' | 'weekly' | 'monthly'，默认 'daily' */
+    period?: 'daily' | 'weekly' | 'monthly';
+}
+/** 资金流排名维度 */
+interface FundFlowRankOptions {
+    /** 排名周期: 'today' | '3day' | '5day' | '10day'，默认 'today' */
+    indicator?: 'today' | '3day' | '5day' | '10day';
+    /** 板块类型（仅 getSectorFundFlowRank 使用）: 'industry' | 'concept' | 'region' */
+    sectorType?: 'industry' | 'concept' | 'region';
+}
+
+/**
+ * 东方财富 - 沪深港通 / 北向资金
+ * 数据来源：
+ *   - 分时数据:           https://push2.eastmoney.com/api/qt/kamtbs.rtmin/get
+ *   - 资金流向汇总/排行/历史: datacenter-web RPT_MUTUAL_*
+ */
+
+/** 北向持股排行选项 */
+interface NorthboundHoldingRankOptions {
+    /** 市场: 'all' | 'shanghai' | 'shenzhen'，默认 'all' */
+    market?: NorthboundMarket;
+    /** 排名周期，默认 '5day' */
+    period?: NorthboundRankPeriod;
+    /**
+     * 指定交易日 YYYY-MM-DD（默认服务端最新交易日）。
+     * 注意：必须是有数据的交易日，否则返回空数组。
+     */
+    date?: string;
+}
+/** 北向资金历史/个股持仓选项 */
+interface NorthboundHistoryOptions {
+    /** 起始日期 YYYY-MM-DD */
+    startDate?: string;
+    /** 结束日期 YYYY-MM-DD */
+    endDate?: string;
+}
+
 interface OHLCV {
     open: number | null;
     high: number | null;
@@ -1865,6 +2618,11 @@ declare class StockSDK {
     private readonly futuresService;
     private readonly optionsService;
     private readonly indicatorService;
+    private readonly fundFlowService;
+    private readonly northboundService;
+    private readonly marketEventService;
+    private readonly dragonTigerService;
+    private readonly dataService;
     /**
      * 创建 Stock SDK 实例。
      * 旧的全局 `timeout` / `retry` / `rateLimit` / `circuitBreaker` 配置继续有效，
@@ -2147,6 +2905,119 @@ declare class StockSDK {
      * @see {@link KlineWithIndicatorsOptions}
      */
     getKlineWithIndicators(symbol: string, options?: KlineWithIndicatorsOptions): Promise<KlineWithIndicators<HistoryKline | HKUSHistoryKline>[]>;
+    /**
+     * 获取个股资金流历史（日 / 周 / 月）
+     * @param symbol 股票代码（支持带或不带 sh/sz/bj 前缀）
+     * @param options 周期选项
+     */
+    getIndividualFundFlow(symbol: string, options?: FundFlowOptions): Promise<StockFundFlowDaily[]>;
+    /** 获取大盘资金流（上证 + 深证综合） */
+    getMarketFundFlow(): Promise<MarketFundFlow[]>;
+    /**
+     * 获取个股资金流排名（沪深北 A 股全市场）
+     * @param options 排名周期：'today' | '3day' | '5day' | '10day'
+     */
+    getFundFlowRank(options?: FundFlowRankOptions): Promise<FundFlowRankItem[]>;
+    /**
+     * 获取板块资金流排名（行业 / 概念 / 地域）
+     * @param options 排名周期 + 板块类型
+     */
+    getSectorFundFlowRank(options?: FundFlowRankOptions): Promise<SectorFundFlowItem[]>;
+    /**
+     * 获取单个板块的历史资金流
+     * @param symbol 板块编号（如 'BK0438' 或全前缀 '90.BK0438'）
+     * @param options 周期选项
+     */
+    getSectorFundFlowHistory(symbol: string, options?: FundFlowOptions): Promise<StockFundFlowDaily[]>;
+    /**
+     * 获取北向 / 南向资金分时数据
+     * @param direction 方向：'north' (北向，默认) 或 'south' (南向)
+     */
+    getNorthboundMinute(direction?: NorthboundDirection): Promise<NorthboundMinuteItem[]>;
+    /** 获取沪深港通市场资金流向汇总（北向 + 南向 + 港股通拆分） */
+    getNorthboundFlowSummary(): Promise<NorthboundFlowSummary[]>;
+    /**
+     * 获取北向 / 沪股通 / 深股通持股个股排行
+     * @param options 市场（沪/深/全部） + 周期
+     */
+    getNorthboundHoldingRank(options?: NorthboundHoldingRankOptions): Promise<NorthboundHoldingRankItem[]>;
+    /**
+     * 获取北向 / 南向资金历史
+     * @param direction 方向
+     * @param options 起止日期
+     */
+    getNorthboundHistory(direction?: NorthboundDirection, options?: NorthboundHistoryOptions): Promise<NorthboundHistoryItem[]>;
+    /**
+     * 获取个股的北向持仓历史
+     * @param symbol 股票代码
+     * @param options 起止日期
+     */
+    getNorthboundIndividual(symbol: string, options?: NorthboundHistoryOptions): Promise<NorthboundIndividualItem[]>;
+    /**
+     * 获取涨停股池（涨停 / 昨日涨停 / 强势 / 次新 / 炸板 / 跌停）
+     * @param type 池子类型，默认 'zt'
+     * @param date 交易日 YYYYMMDD 或 YYYY-MM-DD（默认今天）
+     */
+    getZTPool(type?: ZTPoolType, date?: string): Promise<ZTPoolItem[]>;
+    /**
+     * 获取个股盘口异动（共 22 种异动类型）
+     * @param type 异动类型，默认 'large_buy'
+     */
+    getStockChanges(type?: StockChangeType): Promise<StockChangeItem[]>;
+    /** 获取板块异动详情（当日板块异动汇总） */
+    getBoardChanges(): Promise<BoardChangeItem[]>;
+    /**
+     * 获取龙虎榜详情
+     * @param options 起止日期 YYYYMMDD
+     */
+    getDragonTigerDetail(options: DragonTigerDateOptions): Promise<DragonTigerDetailItem[]>;
+    /**
+     * 获取个股上榜统计
+     * @param period 统计周期（默认近一月）
+     */
+    getDragonTigerStockStats(period?: DragonTigerPeriod): Promise<DragonTigerStockStatItem[]>;
+    /**
+     * 获取机构买卖统计
+     * @param options 起止日期 YYYYMMDD
+     */
+    getDragonTigerInstitution(options: DragonTigerDateOptions): Promise<DragonTigerInstitutionItem[]>;
+    /**
+     * 获取营业部排行
+     * @param period 统计周期
+     */
+    getDragonTigerBranchRank(period?: DragonTigerPeriod): Promise<DragonTigerBranchItem[]>;
+    /**
+     * 获取个股某日上榜席位明细（买入榜 + 卖出榜合并）
+     * @param symbol 股票代码
+     * @param date 上榜日期 YYYYMMDD 或 YYYY-MM-DD
+     */
+    getDragonTigerStockSeatDetail(symbol: string, date: string): Promise<DragonTigerSeatItem[]>;
+    /** 获取大宗交易市场每日统计 */
+    getBlockTradeMarketStat(): Promise<BlockTradeMarketStatItem[]>;
+    /**
+     * 获取大宗交易明细
+     * @param options 起止日期
+     */
+    getBlockTradeDetail(options?: BlockTradeDateOptions): Promise<BlockTradeDetailItem[]>;
+    /**
+     * 获取大宗交易每日统计（按股票汇总）
+     * @param options 起止日期
+     */
+    getBlockTradeDailyStat(options?: BlockTradeDateOptions): Promise<BlockTradeDailyStatItem[]>;
+    /** 获取融资融券账户统计 */
+    getMarginAccountInfo(): Promise<MarginAccountItem[]>;
+    /**
+     * 获取融资融券标的明细
+     * @param date 指定交易日 YYYY-MM-DD（默认服务端最新交易日）
+     */
+    getMarginTargetList(date?: string): Promise<MarginTargetItem[]>;
 }
 
-export { type AShareMarket, type ATROptions, type BIASOptions, type BOLLOptions, type CCIOptions, type CFFEXOptionQuote, type CFFEXOptionQuotesOptions, type ComexInventory, type ComexInventoryOptions, type ConceptBoard, type ConceptBoardConstituent, type ConceptBoardKline, type ConceptBoardKlineOptions, type ConceptBoardMinuteKline, type ConceptBoardMinuteKlineOptions, type ConceptBoardMinuteTimeline, type ConceptBoardSpot, type DMIOptions$1 as DMIOptions, type DMIResult$1 as DMIResult, type DividendDetail, type ETFOptionCate, type ETFOptionExpireDay, type ETFOptionMonth, type FullQuote, type FundFlow, type FundQuote, type FuturesExchange, type FuturesInventory, type FuturesInventoryOptions, type FuturesInventorySymbol, type FuturesKline, type FuturesKlineOptions, type GetAShareCodeListOptions, type GetAllAShareQuotesOptions, type GlobalFuturesKlineOptions, type GlobalFuturesQuote, type GlobalFuturesSpotOptions, type HKQuote, type HKUSHistoryKline, type HistoryKline, HttpError, INDICATOR_REGISTRY, type IndexOptionProduct, type IndicatorKey, type IndicatorOptions, type IndustryBoard, type IndustryBoardConstituent, type IndustryBoardKline, type IndustryBoardKlineOptions, type IndustryBoardMinuteKline, type IndustryBoardMinuteKlineOptions, type IndustryBoardMinuteTimeline, type IndustryBoardSpot, type JsonpOptions, type KCOptions$1 as KCOptions, type KCResult$1 as KCResult, type KDJOptions, type KlineWithIndicators, type MACDOptions, type MAOptions, type MarketType, type MinuteKline, type MinuteTimeline, type OBVOptions$1 as OBVOptions, type OBVResult$1 as OBVResult, type OptionKline, type OptionLHBItem, type OptionMinute, type OptionTQuote, type OptionTQuoteResult, type PanelLargeOrder, type ProviderName, type ProviderRequestPolicy, type ROCOptions$1 as ROCOptions, type ROCResult$1 as ROCResult, type RSIOptions, type RequestClientOptions, type RequestError, type RetryOptions, type SAROptions$1 as SAROptions, type SARResult$1 as SARResult, SdkError, type SearchResult, type SearchResultType, type SimpleQuote, StockSDK, type TodayTimeline, type TodayTimelineResponse, type USQuote, type WROptions, addIndicators, asyncPool, buildIndicatorContext, calcATR, calcBIAS, calcBOLL, calcCCI, calcDMI, calcEMA, calcKC, calcKDJ, calcMA, calcMACD, calcOBV, calcROC, calcRSI, calcSAR, calcSMA, calcWMA, calcWR, chunkArray, decodeGBK, StockSDK as default, estimateIndicatorLookback, extractJsonFromJsonp, getEnabledIndicatorKeys, getSdkErrorCode, jsonpRequest, parseResponse, safeNumber, safeNumberOrNull };
+/**
+ * 根据搜索结果生成外部财经站点链接。
+ * @param result 搜索结果
+ * @returns 东方财富、雪球链接列表；未知市场退回站内搜索链接
+ */
+declare function generateSearchExternalLinks(result: SearchResult): ExternalLink[];
+
+export { type AShareMarket, type ATROptions, type BIASOptions, type BOLLOptions, type BlockTradeDailyStatItem, type BlockTradeDateOptions, type BlockTradeDetailItem, type BlockTradeMarketStatItem, type BoardChangeItem, type CCIOptions, type CFFEXOptionQuote, type CFFEXOptionQuotesOptions, type ComexInventory, type ComexInventoryOptions, type ConceptBoard, type ConceptBoardConstituent, type ConceptBoardKline, type ConceptBoardKlineOptions, type ConceptBoardMinuteKline, type ConceptBoardMinuteKlineOptions, type ConceptBoardMinuteTimeline, type ConceptBoardSpot, type DMIOptions$1 as DMIOptions, type DMIResult$1 as DMIResult, type DatacenterQuery, type DatacenterResult, type DividendDetail, type DragonTigerBranchItem, type DragonTigerDateOptions, type DragonTigerDetailItem, type DragonTigerInstitutionItem, type DragonTigerPeriod, type DragonTigerSeatItem, type DragonTigerStockStatItem, type ETFOptionCate, type ETFOptionExpireDay, type ETFOptionMonth, type ExternalLink, type FullQuote, type FundFlow, type FundFlowOptions, type FundFlowRankItem, type FundFlowRankOptions, type FundQuote, type FuturesExchange, type FuturesInventory, type FuturesInventoryOptions, type FuturesInventorySymbol, type FuturesKline, type FuturesKlineOptions, type GetAShareCodeListOptions, type GetAllAShareQuotesOptions, type GlobalFuturesKlineOptions, type GlobalFuturesQuote, type GlobalFuturesSpotOptions, type HKQuote, type HKUSHistoryKline, type HistoryKline, HttpError, INDICATOR_REGISTRY, type IndexOptionProduct, type IndicatorKey, type IndicatorOptions, type IndustryBoard, type IndustryBoardConstituent, type IndustryBoardKline, type IndustryBoardKlineOptions, type IndustryBoardMinuteKline, type IndustryBoardMinuteKlineOptions, type IndustryBoardMinuteTimeline, type IndustryBoardSpot, type JsonpOptions, type KCOptions$1 as KCOptions, type KCResult$1 as KCResult, type KDJOptions, type KlineWithIndicators, type MACDOptions, type MAOptions, type MarginAccountItem, type MarginTargetItem, type MarketFundFlow, type MarketType, type MinuteKline, type MinuteTimeline, type NorthboundDirection, type NorthboundFlowSummary, type NorthboundHistoryItem, type NorthboundHistoryOptions, type NorthboundHoldingRankItem, type NorthboundHoldingRankOptions, type NorthboundIndividualItem, type NorthboundMarket, type NorthboundMinuteItem, type NorthboundRankPeriod, type OBVOptions$1 as OBVOptions, type OBVResult$1 as OBVResult, type OptionKline, type OptionLHBItem, type OptionMinute, type OptionTQuote, type OptionTQuoteResult, type PanelLargeOrder, type ProviderName, type ProviderRequestPolicy, type ROCOptions$1 as ROCOptions, type ROCResult$1 as ROCResult, type RSIOptions, type RequestClientOptions, type RequestError, type RetryOptions, type SAROptions$1 as SAROptions, type SARResult$1 as SARResult, SdkError, type SearchResult, type SearchResultType, type SectorFundFlowItem, type SimpleQuote, type StockChangeItem, type StockChangeType, type StockFundFlowDaily, StockSDK, type TodayTimeline, type TodayTimelineResponse, type USQuote, type WROptions, type ZTPoolItem, type ZTPoolType, addIndicators, asyncPool, buildIndicatorContext, calcATR, calcBIAS, calcBOLL, calcCCI, calcDMI, calcEMA, calcKC, calcKDJ, calcMA, calcMACD, calcOBV, calcROC, calcRSI, calcSAR, calcSMA, calcWMA, calcWR, chunkArray, decodeGBK, StockSDK as default, estimateIndicatorLookback, extractJsonFromJsonp, generateSearchExternalLinks, getEnabledIndicatorKeys, getSdkErrorCode, jsonpRequest, parseResponse, safeNumber, safeNumberOrNull };