stock-sdk 2.2.1 → 2.3.0

package/README.md

@@ -61,6 +61,7 @@
 - ✅ **统一符号模型**：`string` 一等公民，`sh600519` / `600519` / `600519.SH` / `00700` / `hk00700` / `AAPL` / `105.AAPL` 等写法容错解析；支持中证等特殊指数（`930955` / `H30533` / `HSHCI` / `GDAXI`，[详见符号指南](https://stock-sdk.linkdiary.cn/guide/symbols.html)）
 - ✅ **A 股 / 港股 / 美股 / 公募基金**实时行情、历史 K 线（日/周/月）、分钟 K 线（1/5/15/30/60）、当日分时
 - ✅ **技术指标**：MA / MACD / BOLL / KDJ / RSI / WR / BIAS / CCI / ATR / OBV / ROC / DMI / SAR / KC
+- ✅ **筹码分布（CYQ）**：`sdk.chips.cn/hk/us` 获利比例 / 平均成本 / 90-70 成本区间与集中度 / 筹码峰直方图（东财算法本地计算，零新增数据源）
 - ✅ **信号 / 选股 / 回测**：`calcSignals`（金叉死叉/超买超卖等事件识别）、链式选股器、本地回测
 - ✅ **期货 / 期权 / 资金流 / 龙虎榜 / 北向 / 大宗交易 / 融资融券 / 涨停板** 等全套扩展数据
 - ✅ **基金深度数据**：历史净值、实时估值、同类排名走势、基金/ETF 分红送配、**主题基金**
@@ -241,6 +242,7 @@ import { SdkError, isSdkError, getSdkErrorCode } from 'stock-sdk/errors';
 | 实时行情 | ✅ | ✅ | ✅ | ✅ | ✅ 全球期货 | ✅ ETF / 中金所 / 商品 |
 | 历史 K 线（日/周/月） | ✅ | ✅ | ✅ | ⚠️ 场内 ETF/LOF | ✅ 国内 + 全球 | ✅ |
 | 分钟 K 线（5/15/30/60） | ✅ | ✅ `kline.hkMinute` | ✅ `kline.usMinute` | ⚠️ 场内 ETF/LOF | ❌ | ❌ |
+| 筹码分布（CYQ） | ✅ `chips.cn` | ✅ `chips.hk` | ✅ `chips.us` | — | — | — |
 | 当日分时（1 分钟） | ✅ `quotes.timeline` | ✅ `kline.hkMinute`(period='1') | ✅ `kline.usMinute`(period='1') | ⚠️ 场内 ETF/LOF | ❌ | ✅ ETF 期权 |
 | 分红派送 | ✅ | ❌ | ❌ | ✅ 基金 + ETF | — | — |
 | 资金流向 | ✅ 个股/大盘/排名/板块 | ❌ | ❌ | — | — | — |
@@ -267,12 +269,13 @@ import { SdkError, isSdkError, getSdkErrorCode } from 'stock-sdk/errors';
 | `sdk.codes` | `.cn` / `.us` / `.hk` / `.fund` |
 | `sdk.batch` | `.cn` / `.hk` / `.us` / `.byCodes` / `.raw` |
 | `sdk.kline` | `.cn` / `.cnMinute` / `.hk` / `.hkMinute` / `.us` / `.usMinute` / `.withIndicators` |
+| `sdk.chips` | `.cn` / `.hk` / `.us`（筹码分布：获利比例 / 平均成本 / 成本区间 / 筹码峰） |
 | `sdk.board` | `.industry.*` / `.concept.*`（`list` / `spot` / `constituents` / `kline` / `minuteKline`） |
 | `sdk.options` | `.index.*` / `.etf.*` / `.commodity.*` / `.cffex.*` / `.lhb` |
 | `sdk.futures` | `.kline` / `.globalSpot` / `.globalKline` / `.inventory` / `.comexInventory` … |
 | `sdk.fundFlow` | `.individual` / `.market` / `.rank` / `.sectorRank` / `.sectorHistory` |
 | `sdk.northbound` | `.minute` / `.summary` / `.holdingRank` / `.history` / `.individual` |
-| `sdk.marketEvent` | `.ztPool` / `.stockChanges` / `.boardChanges` |
+| `sdk.marketEvent` | `.ztPool` / `.stockChanges`(支持多类型 / `'all'`) / `.boardChanges` / `.individualChanges` / `.individualChangesHistory`(个股异动) |
 | `sdk.dragonTiger` | `.detail` / `.stockStats` / `.institution` / `.branchRank` / `.seatDetail` |
 | `sdk.blockTrade` / `sdk.margin` | 大宗交易 / 融资融券 |
 | `sdk.fund` | `.dividendList` / `.navHistory` / `.estimate` / `.rankHistory` / `.theme` |

package/dist/{addIndicators-DQNysyLs.d.cts → addIndicators-_V3HEi0q.d.cts}

@@ -333,6 +333,8 @@ interface MAOptions {
     periods?: number[];
     /** 均线类型：'sma'(简单) | 'ema'(指数) | 'wma'(加权)，默认 'sma' */
     type?: 'sma' | 'ema' | 'wma';
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface MACDOptions {
     /** 短期 EMA 周期，默认 12 */
@@ -341,12 +343,16 @@ interface MACDOptions {
     long?: number;
     /** 信号线 EMA 周期，默认 9 */
     signal?: number;
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface BOLLOptions {
     /** 均线周期，默认 20 */
     period?: number;
     /** 标准差倍数，默认 2 */
     stdDev?: number;
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface KDJOptions {
     /** RSV 周期，默认 9 */
@@ -355,26 +361,38 @@ interface KDJOptions {
     kPeriod?: number;
     /** D 值平滑周期，默认 3 */
     dPeriod?: number;
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface RSIOptions {
     /** RSI 周期数组，默认 [6, 12, 24] */
     periods?: number[];
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface WROptions {
     /** WR 周期数组，默认 [6, 10] */
     periods?: number[];
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface BIASOptions {
     /** BIAS 周期数组，默认 [6, 12, 24] */
     periods?: number[];
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface CCIOptions {
     /** CCI 周期，默认 14 */
     period?: number;
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface ATROptions {
     /** ATR 周期，默认 14 */
     period?: number;
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 /**
  * 周期型指标(periods 复数)的文档简写入参:

package/dist/{addIndicators-DQNysyLs.d.ts → addIndicators-_V3HEi0q.d.ts}

@@ -333,6 +333,8 @@ interface MAOptions {
     periods?: number[];
     /** 均线类型：'sma'(简单) | 'ema'(指数) | 'wma'(加权)，默认 'sma' */
     type?: 'sma' | 'ema' | 'wma';
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface MACDOptions {
     /** 短期 EMA 周期，默认 12 */
@@ -341,12 +343,16 @@ interface MACDOptions {
     long?: number;
     /** 信号线 EMA 周期，默认 9 */
     signal?: number;
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface BOLLOptions {
     /** 均线周期，默认 20 */
     period?: number;
     /** 标准差倍数，默认 2 */
     stdDev?: number;
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface KDJOptions {
     /** RSV 周期，默认 9 */
@@ -355,26 +361,38 @@ interface KDJOptions {
     kPeriod?: number;
     /** D 值平滑周期，默认 3 */
     dPeriod?: number;
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface RSIOptions {
     /** RSI 周期数组，默认 [6, 12, 24] */
     periods?: number[];
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface WROptions {
     /** WR 周期数组，默认 [6, 10] */
     periods?: number[];
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface BIASOptions {
     /** BIAS 周期数组，默认 [6, 12, 24] */
     periods?: number[];
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface CCIOptions {
     /** CCI 周期，默认 14 */
     period?: number;
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 interface ATROptions {
     /** ATR 周期，默认 14 */
     period?: number;
+    /** 输出舍入小数位，默认 3 */
+    decimals?: number;
 }
 /**
  * 周期型指标(periods 复数)的文档简写入参:

package/dist/chip-BbA23rr1.d.cts

@@ -0,0 +1,113 @@
+/**
+ * 筹码计算所需的最小 K 线形状:SDK 的 A 股 / 港股 / 美股历史日 K 线
+ * (`HistoryKline` / `HKHistoryKline` / `USHistoryKline`)均满足。
+ */
+interface ChipKlineLike {
+    /** 日期 YYYY-MM-DD(或任意可标识该 bar 的字符串,原样透传到输出行) */
+    date: string;
+    /** 开盘价 */
+    open: number | null;
+    /** 最高价 */
+    high: number | null;
+    /** 最低价 */
+    low: number | null;
+    /** 收盘价 */
+    close: number | null;
+    /** 换手率 % */
+    turnoverRate: number | null;
+}
+/**
+ * 筹码峰直方图(单日分布形状)
+ */
+interface ChipHistogram {
+    /** 价格档(150 档,低 → 高,已按原算法保留 2 位小数) */
+    prices: number[];
+    /** 各价格档筹码占比(0..1,总和 ≈ 1;按 6 位小数舍入) */
+    ratios: number[];
+}
+/**
+ * `calcChipDistribution` 配置
+ */
+interface ChipDistributionOptions {
+    /**
+     * 分布回看窗口(根)。每日分布只由最近 `range` 根 K 线推演。
+     *
+     * - `120`(默认):与东财 App / 网页筹码分布的显示口径一致;
+     * - `0`:从序列首根全量累计(akshare `stock_cyq_em` 的口径)。
+     *   注意该模式下每行成本为 O(序列长度),长序列请配合 {@link tail}。
+     *
+     * @default 120
+     */
+    range?: number;
+    /**
+     * 仅对输入序列**最后 `tail` 根**产出统计行(输出长度 = min(tail, 输入长度))。
+     * 前面的 bar 仍参与分布推演,只是不生成输出行 —— 用于「取足暖机数据、
+     * 只要尾部结果」的场景,避免 `range: 0` + 长序列时的 O(N²) 全量计算。
+     * 不传时对每根输入 bar 都产出统计行;`tail <= 0` 或 `NaN` 输出空数组,
+     * 非整数向下取整,`Infinity` 等价于不传(输出全部行)。
+     */
+    tail?: number;
+    /**
+     * 是否在输出行上附带筹码峰直方图:
+     * - `false`(默认):不附带;
+     * - `'last'` 或 `true`:仅最后一行附带(看「当前筹码峰」的常见场景);
+     * - `'all'`:每行都附带(数据量为 每行 150 档 × 2 数组,注意体积)。
+     *
+     * @default false
+     */
+    includeHistogram?: boolean | 'last' | 'all';
+    /**
+     * 比例类字段(获利比例 / 集中度)的输出舍入小数位。
+     * 价格类字段(平均成本 / 90-70 成本区间)固定 2 位小数(原算法口径),不受此项影响。
+     *
+     * @default 3
+     */
+    decimals?: number;
+}
+/**
+ * 单日筹码分布统计(字段口径与 akshare `stock_cyq_em` 输出对齐)
+ */
+interface ChipDistributionItem {
+    /** 日期(透传输入 bar 的 date) */
+    date: string;
+    /** 获利比例 0..1(收盘价之下的筹码占比);收盘价缺失或分布退化时为 null */
+    profitRatio: number | null;
+    /** 平均成本(元,累计 50% 筹码处的价格,即中位数成本 —— 东财「平均成本」口径) */
+    avgCost: number | null;
+    /** 90% 筹码成本区间下沿(元) */
+    cost90Low: number | null;
+    /** 90% 筹码成本区间上沿(元) */
+    cost90High: number | null;
+    /** 90% 筹码集中度 (高-低)/(高+低) */
+    concentration90: number | null;
+    /** 70% 筹码成本区间下沿(元) */
+    cost70Low: number | null;
+    /** 70% 筹码成本区间上沿(元) */
+    cost70High: number | null;
+    /** 70% 筹码集中度 */
+    concentration70: number | null;
+    /** 筹码峰直方图(按 includeHistogram 配置附带) */
+    histogram?: ChipHistogram;
+}
+/**
+ * 计算筹码分布(纯函数,零网络)。
+ *
+ * 输入通常为**日 K 线**(需含换手率;SDK 的 `kline.cn` / `kline.hk` / `kline.us`
+ * 返回值可直接使用)。对输入的每根 bar(或 `tail` 限定的尾部)输出一行统计。
+ *
+ * 口径说明:
+ * - `range` 默认 120(东财 App 显示口径);`range: 0` 为 akshare 全量累计口径,
+ *   两者数值不同,对拍 akshare 输出时请显式传 `range: 0`;
+ * - 复权方式由调用方在取 K 线时决定,分布数值随复权口径变化;
+ * - 换手率缺失(null)的 bar 按 0 换手处理(沿用东财 `hsl/100 || 0` 语义);
+ *   OHLC 含 null 的脏行整体跳过,不贡献分布;
+ * - 窗口内累计换手极低(如长期停牌 / 仙股)时分布主要由窗口首日堆叠决定,
+ *   参考价值有限;指数 / 无换手率概念的品种不适用本模型。
+ *
+ * @param klines - K 线序列(按时间升序)
+ * @param options - 见 {@link ChipDistributionOptions}
+ * @returns 每日筹码分布统计(与输入尾部 bar 一一对应)
+ */
+declare function calcChipDistribution(klines: ChipKlineLike[], options?: ChipDistributionOptions): ChipDistributionItem[];
+
+export { type ChipKlineLike as C, type ChipHistogram as a, type ChipDistributionOptions as b, calcChipDistribution as c, type ChipDistributionItem as d };

package/dist/chip-BbA23rr1.d.ts

@@ -0,0 +1,113 @@
+/**
+ * 筹码计算所需的最小 K 线形状:SDK 的 A 股 / 港股 / 美股历史日 K 线
+ * (`HistoryKline` / `HKHistoryKline` / `USHistoryKline`)均满足。
+ */
+interface ChipKlineLike {
+    /** 日期 YYYY-MM-DD(或任意可标识该 bar 的字符串,原样透传到输出行) */
+    date: string;
+    /** 开盘价 */
+    open: number | null;
+    /** 最高价 */
+    high: number | null;
+    /** 最低价 */
+    low: number | null;
+    /** 收盘价 */
+    close: number | null;
+    /** 换手率 % */
+    turnoverRate: number | null;
+}
+/**
+ * 筹码峰直方图(单日分布形状)
+ */
+interface ChipHistogram {
+    /** 价格档(150 档,低 → 高,已按原算法保留 2 位小数) */
+    prices: number[];
+    /** 各价格档筹码占比(0..1,总和 ≈ 1;按 6 位小数舍入) */
+    ratios: number[];
+}
+/**
+ * `calcChipDistribution` 配置
+ */
+interface ChipDistributionOptions {
+    /**
+     * 分布回看窗口(根)。每日分布只由最近 `range` 根 K 线推演。
+     *
+     * - `120`(默认):与东财 App / 网页筹码分布的显示口径一致;
+     * - `0`:从序列首根全量累计(akshare `stock_cyq_em` 的口径)。
+     *   注意该模式下每行成本为 O(序列长度),长序列请配合 {@link tail}。
+     *
+     * @default 120
+     */
+    range?: number;
+    /**
+     * 仅对输入序列**最后 `tail` 根**产出统计行(输出长度 = min(tail, 输入长度))。
+     * 前面的 bar 仍参与分布推演,只是不生成输出行 —— 用于「取足暖机数据、
+     * 只要尾部结果」的场景,避免 `range: 0` + 长序列时的 O(N²) 全量计算。
+     * 不传时对每根输入 bar 都产出统计行;`tail <= 0` 或 `NaN` 输出空数组,
+     * 非整数向下取整,`Infinity` 等价于不传(输出全部行)。
+     */
+    tail?: number;
+    /**
+     * 是否在输出行上附带筹码峰直方图:
+     * - `false`(默认):不附带;
+     * - `'last'` 或 `true`:仅最后一行附带(看「当前筹码峰」的常见场景);
+     * - `'all'`:每行都附带(数据量为 每行 150 档 × 2 数组,注意体积)。
+     *
+     * @default false
+     */
+    includeHistogram?: boolean | 'last' | 'all';
+    /**
+     * 比例类字段(获利比例 / 集中度)的输出舍入小数位。
+     * 价格类字段(平均成本 / 90-70 成本区间)固定 2 位小数(原算法口径),不受此项影响。
+     *
+     * @default 3
+     */
+    decimals?: number;
+}
+/**
+ * 单日筹码分布统计(字段口径与 akshare `stock_cyq_em` 输出对齐)
+ */
+interface ChipDistributionItem {
+    /** 日期(透传输入 bar 的 date) */
+    date: string;
+    /** 获利比例 0..1(收盘价之下的筹码占比);收盘价缺失或分布退化时为 null */
+    profitRatio: number | null;
+    /** 平均成本(元,累计 50% 筹码处的价格,即中位数成本 —— 东财「平均成本」口径) */
+    avgCost: number | null;
+    /** 90% 筹码成本区间下沿(元) */
+    cost90Low: number | null;
+    /** 90% 筹码成本区间上沿(元) */
+    cost90High: number | null;
+    /** 90% 筹码集中度 (高-低)/(高+低) */
+    concentration90: number | null;
+    /** 70% 筹码成本区间下沿(元) */
+    cost70Low: number | null;
+    /** 70% 筹码成本区间上沿(元) */
+    cost70High: number | null;
+    /** 70% 筹码集中度 */
+    concentration70: number | null;
+    /** 筹码峰直方图(按 includeHistogram 配置附带) */
+    histogram?: ChipHistogram;
+}
+/**
+ * 计算筹码分布(纯函数,零网络)。
+ *
+ * 输入通常为**日 K 线**(需含换手率;SDK 的 `kline.cn` / `kline.hk` / `kline.us`
+ * 返回值可直接使用)。对输入的每根 bar(或 `tail` 限定的尾部)输出一行统计。
+ *
+ * 口径说明:
+ * - `range` 默认 120(东财 App 显示口径);`range: 0` 为 akshare 全量累计口径,
+ *   两者数值不同,对拍 akshare 输出时请显式传 `range: 0`;
+ * - 复权方式由调用方在取 K 线时决定,分布数值随复权口径变化;
+ * - 换手率缺失(null)的 bar 按 0 换手处理(沿用东财 `hsl/100 || 0` 语义);
+ *   OHLC 含 null 的脏行整体跳过,不贡献分布;
+ * - 窗口内累计换手极低(如长期停牌 / 仙股)时分布主要由窗口首日堆叠决定,
+ *   参考价值有限;指数 / 无换手率概念的品种不适用本模型。
+ *
+ * @param klines - K 线序列(按时间升序)
+ * @param options - 见 {@link ChipDistributionOptions}
+ * @returns 每日筹码分布统计(与输入尾部 bar 一一对应)
+ */
+declare function calcChipDistribution(klines: ChipKlineLike[], options?: ChipDistributionOptions): ChipDistributionItem[];
+
+export { type ChipKlineLike as C, type ChipHistogram as a, type ChipDistributionOptions as b, calcChipDistribution as c, type ChipDistributionItem as d };