stock-sdk 1.8.2 → 1.9.0

package/dist/index.d.cts

@@ -12,46 +12,10 @@ interface RateLimiterOptions {
     maxBurst?: number;
 }
 
-/**
- * 熔断器 - 防止雪崩效应
- *
- * 状态机：
- * - CLOSED: 正常状态，允许所有请求
- * - OPEN: 熔断状态，拒绝所有请求
- * - HALF_OPEN: 半开状态，允许少量请求探测
- */
-/**
- * 熔断器状态
- */
-type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';
-/**
- * 熔断器配置
- */
-interface CircuitBreakerOptions {
-    /** 触发熔断的失败次数阈值，默认 5 */
-    failureThreshold?: number;
-    /** 熔断持续时间（毫秒），默认 30000 (30秒) */
-    resetTimeout?: number;
-    /** 半开状态允许的探测请求数，默认 1 */
-    halfOpenRequests?: number;
-    /** 状态变化回调 */
-    onStateChange?: (from: CircuitState, to: CircuitState) => void;
-}
-
 /**
  * 已知的数据源名称
  */
 type ProviderName = 'tencent' | 'eastmoney' | 'sina' | 'linkdiary' | 'unknown';
-/**
- * HTTP 错误类
- */
-declare class HttpError extends Error {
-    readonly status: number;
-    readonly statusText: string;
-    readonly url?: string | undefined;
-    readonly provider?: string | undefined;
-    constructor(status: number, statusText: string, url?: string | undefined, provider?: string | undefined);
-}
 /**
  * 重试配置选项
  */
@@ -92,6 +56,89 @@ interface ProviderRequestPolicy {
     /** 熔断器配置（连续失败时暂停请求） */
     circuitBreaker?: CircuitBreakerOptions;
 }
+
+/**
+ * SDK 统一错误码
+ */
+type SdkErrorCode = 'NETWORK_ERROR' | 'TIMEOUT' | 'HTTP_ERROR' | 'RATE_LIMITED' | 'CIRCUIT_OPEN' | 'UPSTREAM_EMPTY' | 'INVALID_SYMBOL' | 'INVALID_ARGUMENT' | 'NOT_FOUND';
+/**
+ * SDK 错误构造参数
+ */
+interface SdkErrorOptions {
+    code: SdkErrorCode;
+    message: string;
+    provider?: ProviderName;
+    url?: string;
+    status?: number;
+    details?: Record<string, unknown>;
+    cause?: unknown;
+}
+/**
+ * SDK 标准错误
+ */
+declare class SdkError extends Error {
+    readonly code: SdkErrorCode;
+    readonly provider?: ProviderName;
+    readonly url?: string;
+    readonly status?: number;
+    readonly details?: Record<string, unknown>;
+    constructor(options: SdkErrorOptions);
+}
+/**
+ * HTTP 错误类
+ */
+declare class HttpError extends SdkError {
+    readonly status: number;
+    readonly statusText: string;
+    constructor(status: number, statusText: string, url?: string, provider?: ProviderName);
+}
+/**
+ * 标准化后的请求错误元数据。
+ * 为保持兼容，网络类错误会尽量复用原始 Error 实例，并附加这些字段。
+ */
+interface RequestErrorMetadata {
+    sdkCode?: SdkErrorCode;
+    provider?: ProviderName;
+    url?: string;
+    status?: number;
+    details?: Record<string, unknown>;
+}
+/**
+ * 带标准化元数据的请求错误。
+ */
+type RequestError = Error & RequestErrorMetadata;
+/**
+ * 读取错误上的 SDK 标准错误码。
+ */
+declare function getSdkErrorCode(error: unknown): SdkErrorCode | undefined;
+
+/**
+ * 熔断器 - 防止雪崩效应
+ *
+ * 状态机：
+ * - CLOSED: 正常状态，允许所有请求
+ * - OPEN: 熔断状态，拒绝所有请求
+ * - HALF_OPEN: 半开状态，允许少量请求探测
+ */
+
+/**
+ * 熔断器状态
+ */
+type CircuitState = 'CLOSED' | 'OPEN' | 'HALF_OPEN';
+/**
+ * 熔断器配置
+ */
+interface CircuitBreakerOptions {
+    /** 触发熔断的失败次数阈值，默认 5 */
+    failureThreshold?: number;
+    /** 熔断持续时间（毫秒），默认 30000 (30秒) */
+    resetTimeout?: number;
+    /** 半开状态允许的探测请求数，默认 1 */
+    halfOpenRequests?: number;
+    /** 状态变化回调 */
+    onStateChange?: (from: CircuitState, to: CircuitState) => void;
+}
+
 /**
  * 请求客户端配置选项
  */
@@ -412,6 +459,7 @@ interface FundQuote {
     navDate: string;
     raw: string[];
 }
+
 /**
  * A 股历史 K 线（日/周/月）
  */
@@ -463,7 +511,7 @@ interface MinuteTimeline {
     avgPrice: number | null;
 }
 /**
- * A 股分钟 K 线（5/15/30/60 分钟）
+ * A 股分钟 K 线（5/15/30/60）
  */
 interface MinuteKline {
     /** 时间 YYYY-MM-DD HH:mm */
@@ -476,47 +524,53 @@ interface MinuteKline {
     high: number | null;
     /** 最低价 */
     low: number | null;
-    /** 涨跌幅% */
-    changePercent: number | null;
-    /** 涨跌额 */
-    change: number | null;
     /** 成交量 */
     volume: number | null;
     /** 成交额 */
     amount: number | null;
     /** 振幅% */
     amplitude: number | null;
+    /** 涨跌幅% */
+    changePercent: number | null;
+    /** 涨跌额 */
+    change: number | null;
     /** 换手率% */
     turnoverRate: number | null;
 }
 /**
- * 当日分时走势数据（腾讯数据源）
+ * 当日分时项
  */
 interface TodayTimeline {
     /** 时间 HH:mm */
     time: string;
-    /** 成交价 */
+    /** 当前价 */
     price: number;
-    /** 累计成交量（股） */
+    /** 均价 */
+    avgPrice: number;
+    /** 累计成交量(股) */
     volume: number;
-    /** 累计成交额（元） */
+    /** 累计成交额(元) */
     amount: number;
-    /** 当日均价（累计成交额 / 累计成交量 × 100） */
-    avgPrice: number;
 }
 /**
- * 当日分时走势响应
+ * 当日分时响应
  */
 interface TodayTimelineResponse {
     /** 股票代码 */
     code: string;
-    /** 交易日期 YYYYMMDD */
+    /** 交易日期 YYYY-MM-DD */
     date: string;
-    /** 分时数据列表 */
+    /**
+     * 昨收价
+     * - 由 SDK 解析腾讯接口的 `quoteFields[4]` 得到
+     * - 上游异常或接口未返回时可能为 `0` 或 `undefined`
+     */
+    preClose?: number;
+    /** 当日分时序列 */
     data: TodayTimeline[];
 }
 /**
- * 港股/美股历史 K 线
+ * 港股 / 美股历史 K 线
  */
 interface HKUSHistoryKline {
     /** 日期 YYYY-MM-DD */
@@ -546,15 +600,16 @@ interface HKUSHistoryKline {
     /** 换手率% */
     turnoverRate: number | null;
 }
+
 /**
- * 行业板块信息
+ * 行业板块列表项
  */
 interface IndustryBoard {
     /** 排名 */
     rank: number;
     /** 板块名称 */
     name: string;
-    /** 板块代码 */
+    /** 板块代码，如 BK1027 */
     code: string;
     /** 最新价 */
     price: number | null;
@@ -570,25 +625,23 @@ interface IndustryBoard {
     riseCount: number | null;
     /** 下跌家数 */
     fallCount: number | null;
-    /** 领涨股票名称 */
+    /** 领涨股名称 */
     leadingStock: string | null;
-    /** 领涨股票涨跌幅% */
+    /** 领涨股涨跌幅% */
     leadingStockChangePercent: number | null;
 }
 /**
- * 行业板块实时行情
+ * 行业板块实时行情指标
  */
 interface IndustryBoardSpot {
-    /** 指标名称 */
     item: string;
-    /** 指标值 */
     value: number | null;
 }
 /**
  * 行业板块成分股
  */
 interface IndustryBoardConstituent {
-    /** 序号 */
+    /** 排名 */
     rank: number;
     /** 股票代码 */
     code: string;
@@ -610,13 +663,13 @@ interface IndustryBoardConstituent {
     high: number | null;
     /** 最低价 */
     low: number | null;
-    /** 今开 */
+    /** 开盘价 */
     open: number | null;
     /** 昨收 */
     prevClose: number | null;
     /** 换手率% */
     turnoverRate: number | null;
-    /** 市盈率-动态 */
+    /** 市盈率 */
     pe: number | null;
     /** 市净率 */
     pb: number | null;
@@ -625,447 +678,983 @@ interface IndustryBoardConstituent {
  * 行业板块历史 K 线
  */
 interface IndustryBoardKline {
-    /** 日期 */
     date: string;
-    /** 开盘价 */
     open: number | null;
-    /** 收盘价 */
     close: number | null;
-    /** 最高价 */
     high: number | null;
-    /** 最低价 */
     low: number | null;
-    /** 涨跌幅% */
-    changePercent: number | null;
-    /** 涨跌额 */
-    change: number | null;
-    /** 成交量 */
     volume: number | null;
-    /** 成交额 */
     amount: number | null;
-    /** 振幅% */
     amplitude: number | null;
-    /** 换手率% */
+    changePercent: number | null;
+    change: number | null;
     turnoverRate: number | null;
 }
 /**
- * 行业板块 1 分钟分时数据
+ * 行业板块 1 分钟分时
  */
 interface IndustryBoardMinuteTimeline {
-    /** 日期时间 */
     time: string;
-    /** 开盘价 */
     open: number | null;
-    /** 收盘价 */
     close: number | null;
-    /** 最高价 */
     high: number | null;
-    /** 最低价 */
     low: number | null;
-    /** 成交量 */
     volume: number | null;
-    /** 成交额 */
     amount: number | null;
     /** 最新价 */
     price: number | null;
+    /**
+     * @deprecated 旧类型字段，请改用 `price`
+     */
+    avgPrice: number | null;
 }
 /**
- * 行业板块分钟 K 线
+ * 行业板块分钟 K 线（5/15/30/60）
  */
 interface IndustryBoardMinuteKline {
-    /** 日期时间 */
     time: string;
-    /** 开盘价 */
     open: number | null;
-    /** 收盘价 */
     close: number | null;
-    /** 最高价 */
     high: number | null;
-    /** 最低价 */
     low: number | null;
-    /** 涨跌幅% */
-    changePercent: number | null;
-    /** 涨跌额 */
-    change: number | null;
-    /** 成交量 */
     volume: number | null;
-    /** 成交额 */
     amount: number | null;
-    /** 振幅% */
     amplitude: number | null;
-    /** 换手率% */
+    changePercent: number | null;
+    change: number | null;
     turnoverRate: number | null;
 }
 /**
- * 概念板块信息（结构同行业板块）
+ * 概念板块类型复用行业板块结构
  */
 type ConceptBoard = IndustryBoard;
-/**
- * 概念板块实时行情（结构同行业板块）
- */
 type ConceptBoardSpot = IndustryBoardSpot;
-/**
- * 概念板块成分股（结构同行业板块）
- */
 type ConceptBoardConstituent = IndustryBoardConstituent;
-/**
- * 概念板块历史 K 线（结构同行业板块）
- */
 type ConceptBoardKline = IndustryBoardKline;
-/**
- * 概念板块 1 分钟分时数据（结构同行业板块）
- */
 type ConceptBoardMinuteTimeline = IndustryBoardMinuteTimeline;
-/**
- * 概念板块分钟 K 线（结构同行业板块）
- */
 type ConceptBoardMinuteKline = IndustryBoardMinuteKline;
+
 /**
  * 国内期货交易所
  */
 type FuturesExchange = 'SHFE' | 'DCE' | 'CZCE' | 'INE' | 'CFFEX' | 'GFEX';
 /**
- * 国内/全球期货历史 K 线
+ * 期货 K 线
  */
 interface FuturesKline {
-    /** 日期 YYYY-MM-DD */
     date: string;
-    /** 合约代码 */
     code: string;
-    /** 合约名称 */
     name: string;
-    /** 开盘价 */
     open: number | null;
-    /** 收盘价 */
     close: number | null;
-    /** 最高价 */
     high: number | null;
-    /** 最低价 */
     low: number | null;
-    /** 成交量 */
     volume: number | null;
-    /** 成交额 */
     amount: number | null;
-    /** 振幅% */
     amplitude: number | null;
-    /** 涨跌幅% */
     changePercent: number | null;
-    /** 涨跌额 */
     change: number | null;
-    /** 换手率% */
     turnoverRate: number | null;
-    /** 持仓量（期货特有） */
     openInterest: number | null;
 }
 /**
- * 全球期货实时行情
+ * 全球期货实时报价
  */
 interface GlobalFuturesQuote {
-    /** 合约代码，如 HG00Y */
     code: string;
-    /** 名称，如 COMEX铜 */
     name: string;
-    /** 最新价 */
     price: number | null;
-    /** 涨跌额 */
     change: number | null;
-    /** 涨跌幅% */
     changePercent: number | null;
-    /** 今开 */
     open: number | null;
-    /** 最高 */
     high: number | null;
-    /** 最低 */
     low: number | null;
-    /** 昨结算价 */
     prevSettle: number | null;
-    /** 成交量 */
     volume: number | null;
-    /** 买盘量 */
     buyVolume: number | null;
-    /** 卖盘量 */
     sellVolume: number | null;
-    /** 持仓量 */
     openInterest: number | null;
 }
 /**
- * 期货库存品种信息
+ * 期货库存品种
  */
 interface FuturesInventorySymbol {
-    /** 品种代码 */
     code: string;
-    /** 品种名称 */
     name: string;
-    /** 市场代码 */
     marketCode: string;
 }
 /**
  * 期货库存数据
  */
 interface FuturesInventory {
-    /** 品种代码，如 RB */
     code: string;
-    /** 日期 */
     date: string;
-    /** 库存量 */
     inventory: number | null;
-    /** 增减 */
     change: number | null;
 }
 /**
- * COMEX 黄金/白银库存
+ * COMEX 库存数据
  */
 interface ComexInventory {
-    /** 日期 */
     date: string;
-    /** 品种（黄金/白银） */
     name: string;
-    /** 库存量（吨） */
     storageTon: number | null;
-    /** 库存量（盎司） */
     storageOunce: number | null;
+    /**
+     * @deprecated 请改用 `storageTon`
+     */
+    inventory: number | null;
+    /**
+     * @deprecated COMEX 接口当前未提供稳定的变动字段，始终返回 `null`
+     */
+    change: number | null;
+    /**
+     * @deprecated 请改用 `name`
+     */
+    market: 'gold' | 'silver';
+}
+
+/**
+ * 中金所股指期权产品
+ */
+type IndexOptionProduct = 'ho' | 'io' | 'mo';
+/**
+ * 期权 T 型报价项
+ */
+interface OptionTQuote {
+    symbol: string;
+    buyVolume: number | null;
+    buyPrice: number | null;
+    price: number | null;
+    askPrice: number | null;
+    askVolume: number | null;
+    openInterest: number | null;
+    change: number | null;
+    strikePrice: number | null;
 }
 /**
- * 股票搜索结果
+ * 期权 T 型报价结果
+ */
+interface OptionTQuoteResult {
+    calls: OptionTQuote[];
+    puts: OptionTQuote[];
+}
+/**
+ * 期权日 K 线
+ */
+interface OptionKline {
+    date: string;
+    open: number | null;
+    high: number | null;
+    low: number | null;
+    close: number | null;
+    volume: number | null;
+}
+/**
+ * 期权分钟数据
+ */
+interface OptionMinute {
+    time: string;
+    date: string;
+    price: number | null;
+    volume: number | null;
+    openInterest: number | null;
+    avgPrice: number | null;
+}
+/**
+ * ETF 期权月份信息
+ */
+interface ETFOptionMonth {
+    months: string[];
+    stockId: string;
+    cateId: string;
+    cateList: string[];
+}
+/**
+ * ETF 期权到期信息
+ */
+interface ETFOptionExpireDay {
+    expireDay: string;
+    remainderDays: number;
+    stockId: string;
+    name: string;
+}
+/**
+ * ETF 期权品种
+ */
+type ETFOptionCate = '50ETF' | '300ETF' | '500ETF' | '科创50' | '科创板50';
+/**
+ * 中金所期权实时行情
+ */
+interface CFFEXOptionQuote {
+    code: string;
+    name: string;
+    price: number | null;
+    change: number | null;
+    changePercent: number | null;
+    volume: number | null;
+    amount: number | null;
+    openInterest: number | null;
+    strikePrice: number | null;
+    remainDays: number | null;
+    dailyChange: number | null;
+    prevSettle: number | null;
+    open: number | null;
+}
+/**
+ * 期权龙虎榜项
+ */
+interface OptionLHBItem {
+    tradeType: string;
+    date: string;
+    symbol: string;
+    targetName: string;
+    rank: number;
+    memberName: string;
+    sellVolume: number | null;
+    sellVolumeChange: number | null;
+    netSellVolume: number | null;
+    sellVolumeRatio: number | null;
+    buyVolume: number | null;
+    buyVolumeChange: number | null;
+    netBuyVolume: number | null;
+    buyVolumeRatio: number | null;
+    sellPosition: number | null;
+    sellPositionChange: number | null;
+    netSellPosition: number | null;
+    sellPositionRatio: number | null;
+    buyPosition: number | null;
+    buyPositionChange: number | null;
+    netBuyPosition: number | null;
+    buyPositionRatio: number | null;
+    /**
+     * @deprecated 请改用 `date`
+     */
+    tradeDate: string;
+    /**
+     * @deprecated 旧字段，使用当前数据时优先读取 `buyVolume` / `sellVolume`
+     */
+    volume: number | null;
+    /**
+     * @deprecated 旧字段，使用当前数据时优先读取 `buyVolumeChange` / `sellVolumeChange`
+     */
+    volumeChange: number | null;
+    /**
+     * @deprecated 旧字段，历史实现中无稳定金额语义，当前返回最接近的持仓值
+     */
+    amount: number | null;
+    /**
+     * @deprecated 旧字段，历史实现中无稳定金额变动语义，当前返回最接近的持仓变动值
+     */
+    amountChange: number | null;
+    /**
+     * @deprecated 请改用 `buyPosition` / `sellPosition`
+     */
+    openInterest: number | null;
+    /**
+     * @deprecated 请改用 `buyPositionChange` / `sellPositionChange`
+     */
+    openInterestChange: number | null;
+    /**
+     * @deprecated 请改用更细粒度的 `tradeType`
+     */
+    side: 'buy' | 'sell' | 'net' | null;
+}
+
+/**
+ * 标准化的搜索结果资产分类
+ * - 由 `SearchResult.type` 原始字符串归一化得到
+ * - 用于跨数据源做统一的资产类型判断
+ */
+type SearchResultType = 'stock' | 'index' | 'fund' | 'bond' | 'futures' | 'option' | 'other';
+/**
+ * 搜索结果
+ *
+ * @remarks
+ * `type` 字段保留上游原始资产类型字符串（如 `'GP-A'`、`'ZS'`、`'KJ'` 等），
+ * 以保持向后兼容；如需基于统一分类做判断，请使用 `category`。
  */
 interface SearchResult {
-    /** 股票代码（完整，如 sh600519） */
+    /** 股票代码（完整，如 `sh600519`） */
     code: string;
-    /** 股票名称 */
+    /** 名称 */
     name: string;
-    /** 市场标识 (sh/sz/hk/us) */
+    /** 市场标识，如 `sh` / `sz` / `hk` / `us` */
     market: string;
-    /** 资产类别 (GP-A/GP/KJ 等) */
+    /** 上游原始资产类型字符串，如 `'GP-A'` / `'ZS'` / `'KJ'` */
     type: string;
+    /**
+     * 标准化后的资产分类（在原始 `type` 基础上做归一化）
+     * - 不影响 `type` 原值，可放心用于 `switch` 等场景
+     */
+    category?: SearchResultType;
 }
 /**
  * 分红派送详情
  */
 interface DividendDetail {
-    /** 股票代码 */
     code: string;
-    /** 股票名称 */
     name: string;
-    /** 报告期 YYYY-MM-DD */
     reportDate: string | null;
-    /** 预案公告日 YYYY-MM-DD */
     planNoticeDate: string | null;
-    /** 业绩披露日期 YYYY-MM-DD */
     disclosureDate: string | null;
-    /** 送转总比例（每10股送转X股） */
     assignTransferRatio: number | null;
-    /** 送股比例（每10股送X股） */
     bonusRatio: number | null;
-    /** 转股比例（每10股转X股） */
     transferRatio: number | null;
-    /** 每10股派息(税前)，单位：元 */
     dividendPretax: number | null;
-    /** 分红描述（如：10派2.36元(含税,扣税后2.124元)） */
     dividendDesc: string | null;
-    /** 股息率 */
     dividendYield: number | null;
-    /** 每股收益(元) */
     eps: number | null;
-    /** 每股净资产(元) */
     bps: number | null;
-    /** 每股公积金(元) */
     capitalReserve: number | null;
-    /** 每股未分配利润(元) */
     unassignedProfit: number | null;
-    /** 净利润同比增长(%) */
     netProfitYoy: number | null;
-    /** 总股本(股) */
     totalShares: number | null;
-    /** 股权登记日 YYYY-MM-DD */
     equityRecordDate: string | null;
-    /** 除权除息日 YYYY-MM-DD */
     exDividendDate: string | null;
-    /** 现金分红发放日 YYYY-MM-DD */
     payDate: string | null;
-    /** 方案进度（如：实施分配、股东大会预案等） */
     assignProgress: string | null;
-    /** 最新公告日期 YYYY-MM-DD */
     noticeDate: string | null;
 }
+
 /**
- * 中金所股指期权品种代码
+ * 资金流向相关数据类型
  */
-type IndexOptionProduct = 'ho' | 'io' | 'mo';
 /**
- * 期权 T 型报价单条数据（看涨 / 看跌共用）
+ * 个股资金流（日/周/月线）
  */
-interface OptionTQuote {
-    /** 合约标识，如 io2504C3600 */
-    symbol: string;
-    /** 买量 */
-    buyVolume: number | null;
-    /** 买价 */
-    buyPrice: number | 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;
-    /** 卖价 */
-    askPrice: number | null;
-    /** 卖量 */
-    askVolume: number | null;
-    /** 持仓量 */
-    openInterest: number | null;
-    /** 涨跌 */
-    change: number | null;
-    /** 行权价（仅看涨合约含此字段，看跌为 null） */
-    strikePrice: 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>;
 }
+
 /**
- * 期权 T 型报价结果
+ * 龙虎榜数据类型
  */
-interface OptionTQuoteResult {
-    /** 看涨合约列表 */
-    calls: OptionTQuote[];
-    /** 看跌合约列表 */
-    puts: OptionTQuote[];
-}
+/** 龙虎榜统计周期 */
+type DragonTigerPeriod = '1month' | '3month' | '6month' | '1year';
 /**
- * 期权日 K 线
+ * 龙虎榜详情项
  */
-interface OptionKline {
-    /** 日期 YYYY-MM-DD */
+interface DragonTigerDetailItem {
+    /** 股票代码 */
+    code: string;
+    /** 股票名称 */
+    name: string;
+    /** 上榜日期 YYYY-MM-DD */
     date: string;
-    /** 开盘价 */
-    open: number | null;
-    /** 最高价 */
-    high: number | null;
-    /** 最低价 */
-    low: number | null;
     /** 收盘价 */
     close: number | null;
-    /** 成交量 */
-    volume: 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 OptionMinute {
-    /** 时间 HH:mm:ss */
-    time: string;
-    /** 日期 YYYY-MM-DD */
-    date: string;
-    /** 价格 */
-    price: number | null;
-    /** 成交量 */
-    volume: number | null;
-    /** 持仓量 */
-    openInterest: number | null;
-    /** 均价 */
-    avgPrice: 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;
 }
+
 /**
- * ETF 期权到期月份信息
+ * 大宗交易数据类型
  */
-interface ETFOptionMonth {
-    /** 到期月份数组 YYYY-MM */
-    months: string[];
-    /** 标的证券代码 */
-    stockId: string;
-    /** 当前品种标识 */
-    cateId: string;
-    /** 可选品种列表 */
-    cateList: string[];
-}
 /**
- * ETF 期权到期日信息
+ * 大宗交易市场统计项（按日）
  */
-interface ETFOptionExpireDay {
-    /** 到期日 YYYY-MM-DD */
-    expireDay: string;
-    /** 距到期剩余天数 */
-    remainderDays: number;
-    /** 标的证券代码 */
-    stockId: 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;
 }
+
 /**
- * 上交所 ETF 期权品种
+ * 融资融券数据类型
  */
-type ETFOptionCate = '50ETF' | '300ETF' | '500ETF' | '科创50' | '科创板50';
 /**
- * 中金所期权实时行情（东方财富）
+ * 融资融券账户统计项（按日）
  */
-interface CFFEXOptionQuote {
-    /** 合约代码，如 MO2603-P-8200 */
+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;
-    /** 最新价 */
-    price: number | null;
-    /** 涨跌额 */
-    change: number | null;
-    /** 涨跌幅% */
-    changePercent: number | null;
-    /** 成交量 */
-    volume: number | null;
-    /** 成交额 */
-    amount: number | null;
-    /** 持仓量 */
-    openInterest: number | null;
-    /** 行权价 */
-    strikePrice: number | null;
-    /** 剩余天数 */
-    remainDays: number | null;
-    /** 日增 */
-    dailyChange: number | null;
-    /** 昨结算价 */
-    prevSettle: number | null;
-    /** 今开 */
-    open: number | null;
-}
-/**
- * 期权龙虎榜条目
- */
-interface OptionLHBItem {
-    /** 交易类型（认沽交易量/认沽持仓量/认购交易量/认购持仓量） */
-    tradeType: string;
-    /** 交易日期 YYYY-MM-DD */
+    /** 日期 YYYY-MM-DD */
     date: string;
-    /** 标的代码 */
-    symbol: string;
-    /** 标的名称 */
-    targetName: string;
-    /** 会员简称 */
-    memberName: string;
-    /** 排名 */
-    rank: number;
-    /** 卖量 */
-    sellVolume: number | null;
-    /** 卖量变化 */
-    sellVolumeChange: number | null;
-    /** 净卖量 */
-    netSellVolume: number | null;
-    /** 卖量占比 */
-    sellVolumeRatio: number | null;
-    /** 买量 */
-    buyVolume: number | null;
-    /** 买量变化 */
-    buyVolumeChange: number | null;
-    /** 净买量 */
-    netBuyVolume: number | null;
-    /** 买量占比 */
-    buyVolumeRatio: number | null;
-    /** 卖持仓 */
-    sellPosition: number | null;
-    /** 卖持仓变化 */
-    sellPositionChange: number | null;
-    /** 净卖持仓 */
-    netSellPosition: number | null;
-    /** 卖持仓占比 */
-    sellPositionRatio: number | null;
-    /** 买持仓 */
-    buyPosition: number | null;
-    /** 买持仓变化 */
-    buyPositionChange: number | null;
-    /** 净买持仓 */
-    netBuyPosition: number | null;
-    /** 买持仓占比 */
-    buyPositionRatio: number | null;
+    /** 融资余额(元) */
+    finBalance: number | null;
+    /** 融资买入额(元) */
+    finBuyAmount: number | null;
+    /** 融资偿还额(元) */
+    finRepayAmount: number | null;
+    /** 融券余量(股) */
+    loanBalance: number | null;
+    /** 融券卖出量(股) */
+    loanSellVolume: number | null;
+    /** 融券偿还量(股) */
+    loanRepayVolume: number | null;
 }
 
 /**
@@ -1149,18 +1738,6 @@ interface GetUSCodeListOptions {
     market?: USMarket;
 }
 
-/**
- * 腾讯 Smartbox 搜索接口
- * 支持浏览器（JSONP）和 Node.js（fetch）双端
- */
-
-/** 全局变量声明（浏览器环境）*/
-declare global {
-    interface Window {
-        v_hint?: string;
-    }
-}
-
 /**
  * 东方财富 - A 股 K 线
  */
@@ -1317,6 +1894,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;
@@ -1851,17 +2532,88 @@ type KlineWithIndicators<T extends HistoryKline | HKUSHistoryKline> = T & {
  */
 declare function addIndicators<T extends HistoryKline | HKUSHistoryKline>(klines: T[], options?: IndicatorOptions): KlineWithIndicators<T>[];
 
+type BaseKline = HistoryKline | HKUSHistoryKline;
+type IndicatorKey = keyof IndicatorOptions;
+interface IndicatorComputationContext {
+    closes: (number | null)[];
+    ohlcv: OHLCV[];
+}
+interface IndicatorLookback {
+    bars: number;
+    emaBased?: boolean;
+}
+interface IndicatorDescriptor<K extends IndicatorKey = IndicatorKey> {
+    key: K;
+    estimateLookback: (option: IndicatorOptions[K]) => IndicatorLookback;
+    compute: (context: IndicatorComputationContext, option: IndicatorOptions[K]) => unknown[];
+}
+type IndicatorDescriptorMap = {
+    [K in IndicatorKey]: IndicatorDescriptor<K>;
+};
+declare function buildIndicatorContext<T extends BaseKline>(klines: T[]): IndicatorComputationContext;
+declare const INDICATOR_REGISTRY: IndicatorDescriptorMap;
+declare function getEnabledIndicatorKeys(options: IndicatorOptions): IndicatorKey[];
+declare function estimateIndicatorLookback(options: IndicatorOptions): {
+    maxLookback: number;
+    hasEmaBasedIndicator: boolean;
+    requiredBars: number;
+};
+
 /**
- * Stock SDK - 门面类
- * 统一对外接口，组合各模块
+ * 腾讯 Smartbox 搜索接口
+ * 支持浏览器（JSONP）和 Node.js（fetch）双端
  */
 
+/** 全局变量声明（浏览器环境）*/
+declare global {
+    interface Window {
+        v_hint?: string;
+    }
+}
+
+type MarketType = 'A' | 'HK' | 'US';
 /**
- * 市场类型
+ * `getKlineWithIndicators` 的请求参数
  */
-type MarketType = 'A' | 'HK' | 'US';
+interface KlineWithIndicatorsOptions {
+    /**
+     * 市场类型
+     * - 不传时由 SDK 根据 `symbol` 自动识别
+     * - A 股 / 港股 / 美股 => 'A' / 'HK' / 'US'
+     */
+    market?: MarketType;
+    /** K 线周期，默认 `'daily'` */
+    period?: 'daily' | 'weekly' | 'monthly';
+    /** 复权方式：`''` 不复权 / `'qfq'` 前复权 / `'hfq'` 后复权 */
+    adjust?: '' | 'qfq' | 'hfq';
+    /**
+     * 起始日期（`YYYYMMDD` 或 `YYYY-MM-DD`）
+     * - SDK 会根据指标依赖自动向前多取若干 bar，以保证首日指标有效
+     */
+    startDate?: string;
+    /** 结束日期（`YYYYMMDD` 或 `YYYY-MM-DD`） */
+    endDate?: string;
+    /**
+     * 指标配置
+     * - 仅传入 key（如 `{ ma: [5, 10] }`）即可启用对应指标
+     * - 完整选项参见 `IndicatorOptions`
+     */
+    indicators?: IndicatorOptions;
+}
+
 declare class StockSDK {
-    private client;
+    private readonly client;
+    private readonly quoteService;
+    private readonly boardService;
+    private readonly klineService;
+    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` 配置继续有效，
@@ -1869,452 +2621,387 @@ declare class StockSDK {
      */
     constructor(options?: RequestClientOptions);
     /**
-     * 获取 A 股 / 指数 全量行情
-     * @param codes 股票代码数组，如 ['sz000858', 'sh600000']
+     * 获取 A 股完整行情（腾讯接口）
+     * @param codes 股票代码数组（如 `['sh600519', 'sz000001']`）
      */
     getFullQuotes(codes: string[]): Promise<FullQuote[]>;
     /**
-     * 获取简要行情
-     * @param codes 股票代码数组，如 ['sz000858', 'sh000001']
+     * 获取 A 股简化行情（腾讯接口）
+     * @param codes 股票代码数组
      */
     getSimpleQuotes(codes: string[]): Promise<SimpleQuote[]>;
     /**
-     * 获取港股扩展行情
-     * @param codes 港股代码数组，如 ['09988', '00700']
+     * 获取港股行情
+     * @param codes 港股代码数组（如 `['hk00700']`）
      */
     getHKQuotes(codes: string[]): Promise<HKQuote[]>;
     /**
-     * 获取美股简要行情
-     * @param codes 美股代码数组，如 ['BABA', 'AAPL']
+     * 获取美股行情
+     * @param codes 美股代码数组（如 `['usAAPL']`）
      */
     getUSQuotes(codes: string[]): Promise<USQuote[]>;
     /**
-     * 获取公募基金行情
-     * @param codes 基金代码数组，如 ['000001', '110011']
+     * 获取基金行情（场内/场外）
+     * @param codes 基金代码数组
      */
     getFundQuotes(codes: string[]): Promise<FundQuote[]>;
     /**
-     * 获取资金流向
-     * @param codes 股票代码数组，如 ['sz000858', 'sh600000']
+     * 获取资金流向数据
+     * @param codes 股票代码数组
      */
     getFundFlow(codes: string[]): Promise<FundFlow[]>;
     /**
-     * 获取盘口大单占比
-     * @param codes 股票代码数组，如 ['sz000858', 'sh600000']
+     * 获取盘口大单/异动数据
+     * @param codes 股票代码数组
      */
     getPanelLargeOrder(codes: string[]): Promise<PanelLargeOrder[]>;
     /**
-     * 获取当日分时走势数据
-     * @param code 股票代码，如 'sz000001' 或 'sh600000'
+     * 获取当日分时数据
+     * @param code 单只股票代码
      */
     getTodayTimeline(code: string): Promise<TodayTimelineResponse>;
     /**
-     * 获取行业板块名称列表
-     * @returns 行业板块列表
+     * 获取行业板块列表（东方财富）
      */
     getIndustryList(): Promise<IndustryBoard[]>;
     /**
-     * 获取行业板块实时行情
-     * @param symbol 行业板块名称（如"小金属"）或代码（如"BK1027"）
-     * @returns 实时行情指标列表
+     * 获取行业板块成分股实时行情
+     * @param symbol 行业板块代码
      */
     getIndustrySpot(symbol: string): Promise<IndustryBoardSpot[]>;
     /**
-     * 获取行业板块成分股
-     * @param symbol 行业板块名称（如"小金属"）或代码（如"BK1027"）
-     * @returns 成分股列表
+     * 获取行业板块成分股列表
+     * @param symbol 行业板块代码
      */
     getIndustryConstituents(symbol: string): Promise<IndustryBoardConstituent[]>;
     /**
-     * 获取行业板块历史 K 线（日/周/月）
-     * @param symbol 行业板块名称（如"小金属"）或代码（如"BK1027"）
-     * @param options 配置选项
-     * @returns 历史 K 线数据
+     * 获取行业板块历史 K 线
+     * @param symbol 行业板块代码
+     * @param options K 线参数
      */
     getIndustryKline(symbol: string, options?: IndustryBoardKlineOptions): Promise<IndustryBoardKline[]>;
     /**
-     * 获取行业板块分时行情（1/5/15/30/60 分钟）
-     * @param symbol 行业板块名称（如"小金属"）或代码（如"BK1027"）
-     * @param options 配置选项
-     * @returns 分时行情数据
+     * 获取行业板块分时/分钟 K 线
+     * @param symbol 行业板块代码
+     * @param options 周期参数（不传周期则返回当日分时）
      */
     getIndustryMinuteKline(symbol: string, options?: IndustryBoardMinuteKlineOptions): Promise<IndustryBoardMinuteTimeline[] | IndustryBoardMinuteKline[]>;
     /**
-     * 获取概念板块名称列表
-     * @returns 概念板块列表
+     * 获取概念板块列表（东方财富）
      */
     getConceptList(): Promise<ConceptBoard[]>;
     /**
-     * 获取概念板块实时行情
-     * @param symbol 概念板块名称（如"人工智能"）或代码（如"BK0800"）
-     * @returns 实时行情指标列表
+     * 获取概念板块成分股实时行情
+     * @param symbol 概念板块代码
      */
     getConceptSpot(symbol: string): Promise<ConceptBoardSpot[]>;
     /**
-     * 获取概念板块成分股
-     * @param symbol 概念板块名称（如"人工智能"）或代码（如"BK0800"）
-     * @returns 成分股列表
+     * 获取概念板块成分股列表
+     * @param symbol 概念板块代码
      */
     getConceptConstituents(symbol: string): Promise<ConceptBoardConstituent[]>;
     /**
-     * 获取概念板块历史 K 线（日/周/月）
-     * @param symbol 概念板块名称（如"人工智能"）或代码（如"BK0800"）
-     * @param options 配置选项
-     * @returns 历史 K 线数据
+     * 获取概念板块历史 K 线
+     * @param symbol 概念板块代码
+     * @param options K 线参数
      */
     getConceptKline(symbol: string, options?: ConceptBoardKlineOptions): Promise<ConceptBoardKline[]>;
     /**
-     * 获取概念板块分时行情（1/5/15/30/60 分钟）
-     * @param symbol 概念板块名称（如"人工智能"）或代码（如"BK0800"）
-     * @param options 配置选项
-     * @returns 分时行情数据
+     * 获取概念板块分时/分钟 K 线
+     * @param symbol 概念板块代码
+     * @param options 周期参数（不传周期则返回当日分时）
      */
     getConceptMinuteKline(symbol: string, options?: ConceptBoardMinuteKlineOptions): Promise<ConceptBoardMinuteTimeline[] | ConceptBoardMinuteKline[]>;
     /**
-     * 获取 A 股历史 K 线（日/周/月）
+     * 获取 A 股历史 K 线（日/周/月，含复权）
+     * @param symbol 股票代码
+     * @param options K 线参数
      */
     getHistoryKline(symbol: string, options?: HistoryKlineOptions): Promise<HistoryKline[]>;
     /**
-     * 获取 A 股分钟 K 线或分时数据
+     * 获取 A 股分时/分钟 K 线
+     * @param symbol 股票代码
+     * @param options 周期参数（不传周期则返回当日分时）
      */
     getMinuteKline(symbol: string, options?: MinuteKlineOptions): Promise<MinuteTimeline[] | MinuteKline[]>;
     /**
-     * 获取港股历史 K 线（日/周/月）
+     * 获取港股历史 K 线
+     * @param symbol 港股代码
+     * @param options K 线参数
      */
     getHKHistoryKline(symbol: string, options?: HKKlineOptions): Promise<HKUSHistoryKline[]>;
     /**
-     * 获取美股历史 K 线（日/周/月）
+     * 获取美股历史 K 线
+     * @param symbol 美股代码
+     * @param options K 线参数
      */
     getUSHistoryKline(symbol: string, options?: USKlineOptions): Promise<HKUSHistoryKline[]>;
     /**
-     * 搜索股票
-     * @param keyword 关键词（股票代码、名称、拼音）
+     * 模糊搜索股票/指数/基金等
+     * @param keyword 关键词（代码 / 名称 / 拼音）
      */
     search(keyword: string): Promise<SearchResult[]>;
     /**
-     * 从远程获取 A 股代码列表
-     * @param options 配置选项
-     *
-     * @example
-     * // 获取全部 A 股（带交易所前缀）
-     * const codes = await sdk.getAShareCodeList();
-     *
-     * @example
-     * // 获取全部 A 股（不带交易所前缀）
-     * const codes = await sdk.getAShareCodeList({ simple: true });
-     *
-     * @example
-     * // 获取科创板股票
-     * const codes = await sdk.getAShareCodeList({ market: 'kc' });
-     *
-     * @example
-     * // 获取创业板股票（不带前缀）
-     * const codes = await sdk.getAShareCodeList({ simple: true, market: 'cy' });
+     * 获取 A 股全量代码列表
+     * @param options 过滤选项；传 `boolean` 兼容旧版「是否包含交易所前缀」用法
      */
     getAShareCodeList(options?: GetAShareCodeListOptions | boolean): Promise<string[]>;
     /**
-     * 从远程获取美股代码列表
-     * @param options 配置选项
-     *
-     * @example
-     * // 获取全部美股（带市场前缀）
-     * const codes = await sdk.getUSCodeList();
-     * // ['105.AAPL', '106.BABA', ...]
-     *
-     * @example
-     * // 获取全部美股（不带市场前缀）
-     * const codes = await sdk.getUSCodeList({ simple: true });
-     * // ['AAPL', 'BABA', ...]
-     *
-     * @example
-     * // 筛选纳斯达克股票
-     * const codes = await sdk.getUSCodeList({ market: 'NASDAQ' });
-     * // ['105.AAPL', ...]
-     *
-     * @example
-     * // 筛选纽交所股票
-     * const codes = await sdk.getUSCodeList({ market: 'NYSE' });
-     * // ['106.BABA', ...]
+     * 获取美股全量代码列表
+     * @param options 过滤选项；传 `boolean` 兼容旧版「是否包含市场前缀」用法
      */
     getUSCodeList(options?: GetUSCodeListOptions | boolean): Promise<string[]>;
     /**
-     * 从远程获取港股代码列表
+     * 获取港股全量代码列表
      */
     getHKCodeList(): Promise<string[]>;
     /**
-     * 从远程获取基金代码列表
-     * @returns 基金代码数组（6 位代码）
-     *
-     * @example
-     * const codes = await sdk.getFundCodeList();
-     * console.log(codes.length); // 26068
+     * 获取基金全量代码列表
      */
     getFundCodeList(): Promise<string[]>;
     /**
-     * 获取全部 A 股实时行情
-     * @param options 配置选项
-     *
-     * @example
-     * // 获取全部 A 股行情
-     * const quotes = await sdk.getAllAShareQuotes();
-     *
-     * @example
-     * // 获取科创板行情
-     * const kcQuotes = await sdk.getAllAShareQuotes({ market: 'kc' });
-     *
-     * @example
-     * // 获取创业板行情
-     * const cyQuotes = await sdk.getAllAShareQuotes({ market: 'cy' });
+     * 批量拉取全部 A 股完整行情
+     * @param options 批量请求参数（如批大小、并发等）
      */
     getAllAShareQuotes(options?: GetAllAShareQuotesOptions): Promise<FullQuote[]>;
     /**
-     * 获取全部港股实时行情
+     * 批量拉取全部港股行情
+     * @param options 批量请求参数
      */
     getAllHKShareQuotes(options?: GetAllAShareQuotesOptions): Promise<HKQuote[]>;
     /**
-     * 获取全部美股实时行情
-     * @param options 配置选项
-     *
-     * @example
-     * // 获取全部美股行情
-     * const quotes = await sdk.getAllUSShareQuotes();
-     *
-     * @example
-     * // 获取纳斯达克股票行情
-     * const nasdaqQuotes = await sdk.getAllUSShareQuotes({ market: 'NASDAQ' });
-     *
-     * @example
-     * // 获取纽交所股票行情（带进度回调）
-     * const nyseQuotes = await sdk.getAllUSShareQuotes({
-     *   market: 'NYSE',
-     *   onProgress: (completed, total) => console.log(`${completed}/${total}`)
-     * });
+     * 批量拉取全部美股行情
+     * @param options 批量请求参数
      */
     getAllUSShareQuotes(options?: GetAllUSQuotesOptions): Promise<USQuote[]>;
     /**
-     * 获取全部股票实时行情（使用自定义股票代码列表）
+     * 按给定代码列表批量拉取完整行情
+     * @param codes 股票代码数组
+     * @param options 批量请求参数
      */
     getAllQuotesByCodes(codes: string[], options?: GetAllAShareQuotesOptions): Promise<FullQuote[]>;
     /**
-     * 批量混合查询，返回原始解析结果（key + fields）
-     * @param params 如 'sz000858,s_sh000001,jj000001'
+     * 直接调用腾讯批量行情原始接口（高级用法）
+     * @param params 拼接后的查询参数（如 `'sh600519,sz000001'`）
      */
     batchRaw(params: string): Promise<{
         key: string;
         fields: string[];
     }[]>;
     /**
-     * 获取 A 股交易日历
-     * @returns 交易日期字符串数组，格式如 ['1990-12-19', '1990-12-20', ...]
+     * 获取交易日历（A 股）
      */
     getTradingCalendar(): Promise<string[]>;
     /**
-     * 获取股票分红派送详情
-     * @param symbol - 股票代码（纯数字或带交易所前缀），如 '600519' 或 'sh600519'
-     * @returns 分红派送详情列表，按报告日期降序排列
-     *
-     * @example
-     * // 获取贵州茅台的分红历史
-     * const dividends = await sdk.getDividendDetail('600519');
-     * console.log(dividends[0].dividendPretax); // 每10股派息(税前)
+     * 获取分红配股明细
+     * @param symbol 股票代码
      */
     getDividendDetail(symbol: string): Promise<DividendDetail[]>;
     /**
-     * 获取国内期货历史 K 线（日/周/月）
-     * @param symbol - 合约代码，如 'rb2605'（具体合约）或 'RBM'（主连）
-     * @param options - 配置选项
-     * @returns 期货 K 线数据数组
-     *
-     * @example
-     * // 获取螺纹钢主连日K
-     * const klines = await sdk.getFuturesKline('RBM');
-     *
-     * @example
-     * // 获取沪深300期货具体合约周K
-     * const klines = await sdk.getFuturesKline('IF2604', { period: 'weekly' });
+     * 获取国内期货历史 K 线
+     * @param symbol 期货合约代码
+     * @param options K 线参数
      */
     getFuturesKline(symbol: string, options?: FuturesKlineOptions): Promise<FuturesKline[]>;
     /**
      * 获取全球期货实时行情
-     * @param options - 配置选项
-     * @returns 全球期货行情数组
-     *
-     * @example
-     * const quotes = await sdk.getGlobalFuturesSpot();
-     * console.log(quotes[0].name); // "COMEX铜"
+     * @param options 筛选选项
      */
     getGlobalFuturesSpot(options?: GlobalFuturesSpotOptions): Promise<GlobalFuturesQuote[]>;
     /**
-     * 获取全球期货历史 K 线（日/周/月）
-     * @param symbol - 合约代码，如 'HG00Y'（COMEX铜连续）
-     * @param options - 配置选项
-     * @returns 期货 K 线数据数组
-     *
-     * @example
-     * const klines = await sdk.getGlobalFuturesKline('HG00Y');
+     * 获取全球期货历史 K 线
+     * @param symbol 期货合约代码
+     * @param options K 线参数
      */
     getGlobalFuturesKline(symbol: string, options?: GlobalFuturesKlineOptions): Promise<FuturesKline[]>;
     /**
      * 获取期货库存品种列表
-     * @returns 品种列表（code + name + marketCode）
-     *
-     * @example
-     * const symbols = await sdk.getFuturesInventorySymbols();
-     * console.log(symbols); // [{code: 'rb', name: '螺纹钢', marketCode: '...'}]
      */
     getFuturesInventorySymbols(): Promise<FuturesInventorySymbol[]>;
     /**
-     * 获取期货库存数据
-     * @param symbol - 品种代码（从 getFuturesInventorySymbols 获取）
-     * @param options - 配置选项
-     * @returns 库存数据数组
-     *
-     * @example
-     * const inventory = await sdk.getFuturesInventory('rb');
+     * 获取指定品种的期货库存历史
+     * @param symbol 品种代码
+     * @param options 查询参数
      */
     getFuturesInventory(symbol: string, options?: FuturesInventoryOptions): Promise<FuturesInventory[]>;
     /**
-     * 获取 COMEX 黄金/白银库存数据
-     * @param symbol - 'gold' 或 'silver'
-     * @param options - 配置选项
-     * @returns COMEX 库存数据数组
-     *
-     * @example
-     * const goldInventory = await sdk.getComexInventory('gold');
+     * 获取 COMEX 黄金/白银库存
+     * @param symbol `'gold'` 或 `'silver'`
+     * @param options 查询参数
      */
     getComexInventory(symbol: 'gold' | 'silver', options?: ComexInventoryOptions): Promise<ComexInventory[]>;
     /**
-     * 获取中金所股指期权 T 型报价（看涨 + 看跌）
-     * @param product - 品种代码 'ho'(上证50) / 'io'(沪深300) / 'mo'(中证1000)
-     * @param contract - 合约代码，如 'io2504'
-     *
-     * @example
-     * const spot = await sdk.getIndexOptionSpot('io', 'io2504');
-     * console.log(spot.calls[0].strikePrice); // 行权价
+     * 获取股指期权 T 型报价
+     * @param product 期权品种
+     * @param contract 合约月份等参数
      */
     getIndexOptionSpot(product: IndexOptionProduct, contract: string): Promise<OptionTQuoteResult>;
     /**
-     * 获取中金所股指期权合约日 K 线
-     * @param symbol - 合约代码（含看涨/看跌标识），如 'io2504C3600'
-     *
-     * @example
-     * const klines = await sdk.getIndexOptionKline('io2504C3600');
+     * 获取股指期权日 K 线
+     * @param symbol 合约代码
      */
     getIndexOptionKline(symbol: string): Promise<OptionKline[]>;
     /**
-     * 获取中金所全部期权实时行情列表
-     *
-     * @example
-     * const quotes = await sdk.getCFFEXOptionQuotes();
-     * console.log(quotes[0].code); // 'MO2603-P-8200'
+     * 获取中金所期权当日报价（IO/MO 等）
+     * @param options 筛选选项
      */
     getCFFEXOptionQuotes(options?: CFFEXOptionQuotesOptions): Promise<CFFEXOptionQuote[]>;
     /**
-     * 获取上交所 ETF 期权到期月份列表
-     * @param cate - 品种名称，如 '50ETF', '300ETF'
-     *
-     * @example
-     * const info = await sdk.getETFOptionMonths('50ETF');
-     * console.log(info.months); // ['2026-03', '2026-04', ...]
+     * 获取 ETF 期权可用月份
+     * @param cate ETF 期权品种
      */
     getETFOptionMonths(cate: ETFOptionCate): Promise<ETFOptionMonth>;
     /**
-     * 获取上交所 ETF 期权到期日与剩余天数
-     * @param cate - 品种名称
-     * @param month - 到期月份 YYYY-MM
-     *
-     * @example
-     * const info = await sdk.getETFOptionExpireDay('50ETF', '2026-03');
-     * console.log(info.remainderDays); // 12
+     * 获取 ETF 期权指定月份的合约列表/到期日
+     * @param cate ETF 期权品种
+     * @param month 月份（如 `'202405'`）
      */
     getETFOptionExpireDay(cate: ETFOptionCate, month: string): Promise<ETFOptionExpireDay>;
     /**
-     * 获取上交所 ETF 期权当日分钟行情
-     * @param code - 期权代码（纯数字），如 '10009633'
+     * 获取 ETF 期权当日分时
+     * @param code 合约代码
      */
     getETFOptionMinute(code: string): Promise<OptionMinute[]>;
     /**
-     * 获取上交所 ETF 期权历史日 K 线
-     * @param code - 期权代码（纯数字），如 '10009633'
+     * 获取 ETF 期权日 K 线
+     * @param code 合约代码
      */
     getETFOptionDailyKline(code: string): Promise<OptionKline[]>;
     /**
-     * 获取上交所 ETF 期权 5 日分钟行情
-     * @param code - 期权代码（纯数字），如 '10009633'
+     * 获取 ETF 期权 5 日分时
+     * @param code 合约代码
      */
     getETFOption5DayMinute(code: string): Promise<OptionMinute[]>;
     /**
      * 获取商品期权 T 型报价
-     * @param variety - 品种代码（如 'au', 'cu', 'SR'）
-     * @param contract - 合约代码，如 'au2506'
-     *
-     * @example
-     * const spot = await sdk.getCommodityOptionSpot('au', 'au2506');
+     * @param variety 品种
+     * @param contract 合约
      */
     getCommodityOptionSpot(variety: string, contract: string): Promise<OptionTQuoteResult>;
     /**
-     * 获取商品期权合约日 K 线
-     * @param symbol - 合约代码（含看涨/看跌标识），如 'm2409C3200'
+     * 获取商品期权日 K 线
+     * @param symbol 合约代码
      */
     getCommodityOptionKline(symbol: string): Promise<OptionKline[]>;
     /**
      * 获取期权龙虎榜
-     * @param symbol - 标的代码 '510050' / '510300' / '159919'
-     * @param date - 交易日期 YYYY-MM-DD
-     *
-     * @example
-     * const lhb = await sdk.getOptionLHB('510050', '2022-01-21');
+     * @param symbol 合约代码
+     * @param date 日期 `YYYY-MM-DD`
      */
     getOptionLHB(symbol: string, date: string): Promise<OptionLHBItem[]>;
     /**
-     * 市场类型识别
+     * 获取带技术指标的 K 线（A 股 / 港股 / 美股自动识别）
+     * @param symbol 股票代码
+     * @param options 配置（市场、周期、复权、日期范围、指标列表等）
+     * @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'
      */
-    private detectMarket;
+    getStockChanges(type?: StockChangeType): Promise<StockChangeItem[]>;
+    /** 获取板块异动详情（当日板块异动汇总） */
+    getBoardChanges(): Promise<BoardChangeItem[]>;
     /**
-     * 安全获取数组最大值
+     * 获取龙虎榜详情
+     * @param options 起止日期 YYYYMMDD
      */
-    private safeMax;
+    getDragonTigerDetail(options: DragonTigerDateOptions): Promise<DragonTigerDetailItem[]>;
     /**
-     * 计算各指标所需的最大前置天数
+     * 获取个股上榜统计
+     * @param period 统计周期（默认近一月）
      */
-    private calcRequiredLookback;
+    getDragonTigerStockStats(period?: DragonTigerPeriod): Promise<DragonTigerStockStatItem[]>;
     /**
-     * 计算实际请求的开始日期
+     * 获取机构买卖统计
+     * @param options 起止日期 YYYYMMDD
      */
-    private calcActualStartDate;
+    getDragonTigerInstitution(options: DragonTigerDateOptions): Promise<DragonTigerInstitutionItem[]>;
     /**
-     * 计算实际请求的开始日期（交易日历）
+     * 获取营业部排行
+     * @param period 统计周期
      */
-    private calcActualStartDateByCalendar;
+    getDragonTigerBranchRank(period?: DragonTigerPeriod): Promise<DragonTigerBranchItem[]>;
     /**
-     * 统一日期格式为 YYYY-MM-DD
+     * 获取个股某日上榜席位明细（买入榜 + 卖出榜合并）
+     * @param symbol 股票代码
+     * @param date 上榜日期 YYYYMMDD 或 YYYY-MM-DD
      */
-    private normalizeDate;
+    getDragonTigerStockSeatDetail(symbol: string, date: string): Promise<DragonTigerSeatItem[]>;
+    /** 获取大宗交易市场每日统计 */
+    getBlockTradeMarketStat(): Promise<BlockTradeMarketStatItem[]>;
     /**
-     * 压缩日期格式为 YYYYMMDD
+     * 获取大宗交易明细
+     * @param options 起止日期
      */
-    private toCompactDate;
+    getBlockTradeDetail(options?: BlockTradeDateOptions): Promise<BlockTradeDetailItem[]>;
     /**
-     * 日期字符串转时间戳
+     * 获取大宗交易每日统计（按股票汇总）
+     * @param options 起止日期
      */
-    private dateToTimestamp;
+    getBlockTradeDailyStat(options?: BlockTradeDateOptions): Promise<BlockTradeDailyStatItem[]>;
+    /** 获取融资融券账户统计 */
+    getMarginAccountInfo(): Promise<MarginAccountItem[]>;
     /**
-     * 获取带技术指标的历史 K 线
+     * 获取融资融券标的明细
+     * @param date 指定交易日 YYYY-MM-DD（默认服务端最新交易日）
      */
-    getKlineWithIndicators(symbol: string, options?: {
-        /** 市场类型，不传则自动识别 */
-        market?: MarketType;
-        /** K 线周期 */
-        period?: 'daily' | 'weekly' | 'monthly';
-        /** 复权类型 */
-        adjust?: '' | 'qfq' | 'hfq';
-        /** 开始日期 YYYYMMDD */
-        startDate?: string;
-        /** 结束日期 YYYYMMDD */
-        endDate?: string;
-        /** 技术指标配置 */
-        indicators?: IndicatorOptions;
-    }): Promise<KlineWithIndicators<HistoryKline | HKUSHistoryKline>[]>;
+    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, type IndexOptionProduct, 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 RetryOptions, type SAROptions$1 as SAROptions, type SARResult$1 as SARResult, type SearchResult, type SimpleQuote, StockSDK, type TodayTimeline, type TodayTimelineResponse, type USQuote, type WROptions, addIndicators, asyncPool, calcATR, calcBIAS, calcBOLL, calcCCI, calcDMI, calcEMA, calcKC, calcKDJ, calcMA, calcMACD, calcOBV, calcROC, calcRSI, calcSAR, calcSMA, calcWMA, calcWR, chunkArray, decodeGBK, StockSDK as default, extractJsonFromJsonp, jsonpRequest, parseResponse, safeNumber, safeNumberOrNull };
+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 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, getEnabledIndicatorKeys, getSdkErrorCode, jsonpRequest, parseResponse, safeNumber, safeNumberOrNull };