stock-sdk 1.8.2 → 1.8.3

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,343 @@ 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';
 }
+
 /**
- * 股票搜索结果
- */
-interface SearchResult {
-    /** 股票代码（完整，如 sh600519） */
-    code: string;
-    /** 股票名称 */
-    name: string;
-    /** 市场标识 (sh/sz/hk/us) */
-    market: string;
-    /** 资产类别 (GP-A/GP/KJ 等) */
-    type: string;
-}
-/**
- * 分红派送详情
- */
-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 型报价单条数据（看涨 / 看跌共用）
+ * 期权 T 型报价项
  */
 interface OptionTQuote {
-    /** 合约标识，如 io2504C3600 */
     symbol: string;
-    /** 买量 */
     buyVolume: number | null;
-    /** 买价 */
     buyPrice: number | null;
-    /** 最新价 */
     price: number | null;
-    /** 卖价 */
     askPrice: number | null;
-    /** 卖量 */
     askVolume: number | null;
-    /** 持仓量 */
     openInterest: number | null;
-    /** 涨跌 */
     change: number | null;
-    /** 行权价（仅看涨合约含此字段，看跌为 null） */
     strikePrice: number | null;
 }
 /**
  * 期权 T 型报价结果
  */
 interface OptionTQuoteResult {
-    /** 看涨合约列表 */
     calls: OptionTQuote[];
-    /** 看跌合约列表 */
     puts: OptionTQuote[];
 }
 /**
  * 期权日 K 线
  */
 interface OptionKline {
-    /** 日期 YYYY-MM-DD */
     date: string;
-    /** 开盘价 */
     open: number | null;
-    /** 最高价 */
     high: number | null;
-    /** 最低价 */
     low: number | null;
-    /** 收盘价 */
     close: number | null;
-    /** 成交量 */
     volume: 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;
 }
 /**
- * ETF 期权到期月份信息
+ * ETF 期权月份信息
  */
 interface ETFOptionMonth {
-    /** 到期月份数组 YYYY-MM */
     months: string[];
-    /** 标的证券代码 */
     stockId: string;
-    /** 当前品种标识 */
     cateId: string;
-    /** 可选品种列表 */
     cateList: string[];
 }
 /**
- * ETF 期权到期日信息
+ * ETF 期权到期信息
  */
 interface ETFOptionExpireDay {
-    /** 到期日 YYYY-MM-DD */
     expireDay: string;
-    /** 距到期剩余天数 */
     remainderDays: number;
-    /** 标的证券代码 */
     stockId: string;
-    /** 标的名称 */
     name: string;
 }
 /**
- * 上交所 ETF 期权品种
+ * ETF 期权品种
  */
 type ETFOptionCate = '50ETF' | '300ETF' | '500ETF' | '科创50' | '科创板50';
 /**
- * 中金所期权实时行情（东方财富）
+ * 中金所期权实时行情
  */
 interface CFFEXOptionQuote {
-    /** 合约代码，如 MO2603-P-8200 */
     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 */
     date: string;
-    /** 标的代码 */
     symbol: string;
-    /** 标的名称 */
     targetName: string;
-    /** 会员简称 */
-    memberName: 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`） */
+    code: string;
+    /** 名称 */
+    name: string;
+    /** 市场标识，如 `sh` / `sz` / `hk` / `us` */
+    market: string;
+    /** 上游原始资产类型字符串，如 `'GP-A'` / `'ZS'` / `'KJ'` */
+    type: string;
+    /**
+     * 标准化后的资产分类（在原始 `type` 基础上做归一化）
+     * - 不影响 `type` 原值，可放心用于 `switch` 等场景
+     */
+    category?: SearchResultType;
+}
+/**
+ * 分红派送详情
+ */
+interface DividendDetail {
+    code: string;
+    name: string;
+    reportDate: string | null;
+    planNoticeDate: string | null;
+    disclosureDate: string | null;
+    assignTransferRatio: number | null;
+    bonusRatio: number | null;
+    transferRatio: number | null;
+    dividendPretax: number | null;
+    dividendDesc: string | null;
+    dividendYield: number | null;
+    eps: number | null;
+    bps: number | null;
+    capitalReserve: number | null;
+    unassignedProfit: number | null;
+    netProfitYoy: number | null;
+    totalShares: number | null;
+    equityRecordDate: string | null;
+    exDividendDate: string | null;
+    payDate: string | null;
+    assignProgress: string | null;
+    noticeDate: string | null;
 }
 
 /**
@@ -1149,18 +1098,6 @@ interface GetUSCodeListOptions {
     market?: USMarket;
 }
 
-/**
- * 腾讯 Smartbox 搜索接口
- * 支持浏览器（JSONP）和 Node.js（fetch）双端
- */
-
-/** 全局变量声明（浏览器环境）*/
-declare global {
-    interface Window {
-        v_hint?: string;
-    }
-}
-
 /**
  * 东方财富 - A 股 K 线
  */
@@ -1851,17 +1788,83 @@ 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;
     /**
      * 创建 Stock SDK 实例。
      * 旧的全局 `timeout` / `retry` / `rateLimit` / `circuitBreaker` 配置继续有效，
@@ -1869,452 +1872,281 @@ 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[]>;
     /**
-     * 市场类型识别
-     */
-    private detectMarket;
-    /**
-     * 安全获取数组最大值
-     */
-    private safeMax;
-    /**
-     * 计算各指标所需的最大前置天数
-     */
-    private calcRequiredLookback;
-    /**
-     * 计算实际请求的开始日期
-     */
-    private calcActualStartDate;
-    /**
-     * 计算实际请求的开始日期（交易日历）
-     */
-    private calcActualStartDateByCalendar;
-    /**
-     * 统一日期格式为 YYYY-MM-DD
-     */
-    private normalizeDate;
-    /**
-     * 压缩日期格式为 YYYYMMDD
-     */
-    private toCompactDate;
-    /**
-     * 日期字符串转时间戳
-     */
-    private dateToTimestamp;
-    /**
-     * 获取带技术指标的历史 K 线
+     * 获取带技术指标的 K 线（A 股 / 港股 / 美股自动识别）
+     * @param symbol 股票代码
+     * @param options 配置（市场、周期、复权、日期范围、指标列表等）
+     * @see {@link KlineWithIndicatorsOptions}
      */
-    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>[]>;
+    getKlineWithIndicators(symbol: string, options?: KlineWithIndicatorsOptions): Promise<KlineWithIndicators<HistoryKline | HKUSHistoryKline>[]>;
 }
 
-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 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 };