stock-sdk 1.9.3 → 1.10.0

package/README.md

@@ -54,6 +54,7 @@
 - ✅ 同时提供 **ESM** 和 **CommonJS** 两种模块格式
 - ✅ 完整的 **TypeScript** 类型定义和单元测试覆盖
 - ✅ **A 股、港股、美股、公募基金**实时行情
+- ✅ **基金深度数据**（v1.10.0+）：历史净值（全历史单位/累计）、实时估值（盘中刷新）、同类排名走势、基金/ETF 分红送配
 - ✅ **历史 K 线**（日/周/月）、**分钟 K 线**（1/5/15/30/60 分钟）和**当日分时走势**数据
 - ✅ **技术指标**：内置 MA、MACD、BOLL、KDJ、RSI、WR、BIAS、CCI、ATR、OBV、ROC、DMI、SAR、KC
 - ✅ **期货行情**：国内期货 K 线、全球期货实时行情与 K 线、期货库存数据
@@ -69,25 +70,29 @@
 ## 市场支持矩阵
 
 不同市场的能力覆盖度差异较大，下表帮你快速判断 SDK 是否覆盖你的场景。
-✅ 已支持，⚠️ 部分支持/限制见备注，❌ 未支持。
+
+- ✅ 已支持
+- ⚠️ 部分支持 / 限制见备注
+- ❌ 暂未实现（市场有此能力或存在数据源，SDK 后续可补）
+- — 概念不适用（该市场 / 产品本身不存在此能力，如基金不会涨停、期货合约无分红）
 
 | 能力 | A 股 | 港股 | 美股 | 公募基金 | 期货 | 期权 |
 |------|:----:|:----:|:----:|:--------:|:----:|:----:|
 | 实时行情 | ✅ | ✅ | ✅ | ✅ | ✅ 全球期货 | ✅ ETF / 中金所 / 商品 |
-| 历史 K 线（日/周/月） | ✅ | ✅ | ✅ | ❌ | ✅ 国内 + 全球 | ✅ |
-| 分钟 K 线（5/15/30/60） | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| 当日分时（1 分钟） | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ ETF 期权 |
-| 资金流向 | ✅ 个股/大盘/排名/板块 | ❌ | ❌ | ❌ | ❌ | ❌ |
-| 板块（行业 / 概念） | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| 龙虎榜 | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ 期权龙虎榜 |
-| 沪深港通 / 北向资金 | ✅ 北向 | ✅ 南向 | ❌ | ❌ | ❌ | ❌ |
-| 大宗交易 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| 融资融券 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
-| 涨停板 / 盘口异动 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| 历史 K 线（日/周/月） | ✅ | ✅ | ✅ | ⚠️ 场内 ETF/LOF（走 `getHistoryKline`） | ✅ 国内 + 全球 | ✅ |
+| 分钟 K 线（5/15/30/60） | ✅ | ✅ `getHKMinuteKline` | ✅ `getUSMinuteKline` | ⚠️ 场内 ETF/LOF（走 `getMinuteKline`） | ❌ | ❌ |
+| 当日分时（1 分钟） | ✅ | ✅ `getHKMinuteKline` (period='1') | ✅ `getUSMinuteKline` (period='1') | ⚠️ 场内 ETF/LOF | ❌ | ✅ ETF 期权 |
+| 分红派送 | ✅ | ❌ | ❌ | ✅ 基金 + ETF（`getFundDividendList`） | — | — |
+| 资金流向 | ✅ 个股/大盘/排名/板块 | ❌ | ❌ | — | — | — |
+| 板块（行业 / 概念） | ✅ | ❌ | ❌ | ❌ | — | — |
+| 龙虎榜 | ✅ | — | — | — | — | ✅ 期权龙虎榜 |
+| 沪深港通 / 北向资金 | ✅ 北向 | ✅ 南向 | — | — | — | — |
+| 大宗交易 | ✅ | ❌ | ❌ | — | — | — |
+| 融资融券 | ✅ | — | — | — | — | — |
+| 涨停板 / 盘口异动 | ✅ | — | — | — | — | — |
 | 全市场代码列表 | ✅ 5000+ | ✅ | ✅ | ✅ | ❌ | ❌ |
 | 批量行情 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
-| 库存数据 | ❌ | ❌ | ❌ | ❌ | ✅ 国内 + COMEX | ❌ |
-| 分红派送 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| 库存数据 | — | — | — | — | ✅ 国内 + COMEX | — |
 | 交易日历 | ✅ + `isTradingDay()` 等工具 | ⚠️ 仅市场状态判断（按周一-周五） | ⚠️ 仅市场状态判断（按周一-周五） | — | — | — |
 
 > **数据延迟**：实时行情来自腾讯财经 / 东方财富等公开接口，**非实时撮合**，
@@ -232,6 +237,8 @@ Stock SDK 配套 MCP Server（[stock-sdk-mcp](https://www.npmjs.com/package/stoc
 | `getHKHistoryKline` | 港股历史 K 线（日/周/月） |
 | `getUSHistoryKline` | 美股历史 K 线（日/周/月） |
 | `getMinuteKline` | A 股分钟 K 线（1/5/15/30/60 分钟） |
+| `getHKMinuteKline` | 港股分钟 K 线（5/15/30/60 分钟）或当日分时（period='1'），v1.10.0+ |
+| `getUSMinuteKline` | 美股分钟 K 线（5/15/30/60 分钟）或当日分时（period='1'），v1.10.0+ |
 | `getTodayTimeline` | A 股当日分时走势 |
 
 ### 技术指标
@@ -310,6 +317,15 @@ Stock SDK 配套 MCP Server（[stock-sdk-mcp](https://www.npmjs.com/package/stoc
 | `getTradingCalendar` | A 股交易日历 |
 | `getDividendDetail` | 股票分红派送详情 |
 
+### 基金扩展（v1.10.0+）
+
+| 方法 | 说明 |
+|------|------|
+| `getFundDividendList` | 基金 / ETF 分红明细（全市场，按年份分页，可按代码过滤） |
+| `getFundNavHistory` | 基金历史净值（单位 + 累计，全历史一次返回） |
+| `getFundEstimate` | 基金当日实时估值（含 T-1 单位净值 + 盘中估算） |
+| `getFundRankHistory` | 基金同类排名走势（每日近三月排名 + 百分位） |
+
 ### 资金流向（深度）
 
 | 方法 | 说明 |