stock-sdk 1.9.0 → 1.9.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +32 -0
- package/dist/index.cjs +1 -1
- package/dist/index.d.cts +274 -25
- package/dist/index.d.ts +274 -25
- package/dist/index.js +1 -1
- package/package.json +1 -1
package/dist/index.d.cts
CHANGED
|
@@ -233,6 +233,32 @@ interface JsonpOptions {
|
|
|
233
233
|
*/
|
|
234
234
|
declare function jsonpRequest<T = unknown>(url: string, options?: JsonpOptions): Promise<T>;
|
|
235
235
|
|
|
236
|
+
/**
|
|
237
|
+
* 时间元信息工具
|
|
238
|
+
*
|
|
239
|
+
* 给行情/K线/分时等含时间字段的数据补充统一的 `timestamp` (UTC unix ms)
|
|
240
|
+
* 与 `tz` (IANA 时区名),让消费者无需自己根据各数据源的字符串格式做时区换算。
|
|
241
|
+
*
|
|
242
|
+
* 设计要点:
|
|
243
|
+
* - 不引入第三方时区库 (SDK 零依赖),通过 `Intl.DateTimeFormat` 计算时区偏移。
|
|
244
|
+
* - 兼容多种本地时间字符串格式 (yyyyMMddHHmmss / YYYY-MM-DD HH:mm:ss / YYYY-MM-DD HH:mm /
|
|
245
|
+
* YYYY-MM-DD / yyyyMMdd / HH:mm 配 baseDate)。
|
|
246
|
+
* - 解析失败/输入为空时 `timestamp` 为 `NaN`,调用方可用 `Number.isNaN` 检测。
|
|
247
|
+
*/
|
|
248
|
+
/**
|
|
249
|
+
* 已支持的市场时区。沿用 IANA 时区名。
|
|
250
|
+
*
|
|
251
|
+
* - `Asia/Shanghai`: A 股 (沪深北)
|
|
252
|
+
* - `Asia/Hong_Kong`: 港股
|
|
253
|
+
* - `America/New_York`: 美股 (含夏令时切换)
|
|
254
|
+
*/
|
|
255
|
+
declare const MARKET_TZ: {
|
|
256
|
+
readonly CN: "Asia/Shanghai";
|
|
257
|
+
readonly HK: "Asia/Hong_Kong";
|
|
258
|
+
readonly US: "America/New_York";
|
|
259
|
+
};
|
|
260
|
+
type MarketTz = (typeof MARKET_TZ)[keyof typeof MARKET_TZ];
|
|
261
|
+
|
|
236
262
|
/**
|
|
237
263
|
* A 股 / 指数 全量行情
|
|
238
264
|
*/
|
|
@@ -265,8 +291,12 @@ interface FullQuote {
|
|
|
265
291
|
price: number;
|
|
266
292
|
volume: number;
|
|
267
293
|
}[];
|
|
268
|
-
/**
|
|
294
|
+
/** 行情时间(原始字符串,腾讯接口格式 `yyyyMMddHHmmss`,市场时区) */
|
|
269
295
|
time: string;
|
|
296
|
+
/** 行情时间对应的 UTC unix 毫秒时间戳;无法解析时为 `NaN` */
|
|
297
|
+
timestamp: number;
|
|
298
|
+
/** 行情时间所属市场时区 (`Asia/Shanghai`) */
|
|
299
|
+
tz: MarketTz;
|
|
270
300
|
/** 涨跌额 */
|
|
271
301
|
change: number;
|
|
272
302
|
/** 涨跌幅% */
|
|
@@ -356,7 +386,12 @@ interface FundFlow {
|
|
|
356
386
|
/** 总资金流 */
|
|
357
387
|
totalFlow: number;
|
|
358
388
|
name: string;
|
|
389
|
+
/** 数据日期(原始字符串,A 股时区) */
|
|
359
390
|
date: string;
|
|
391
|
+
/** 数据日期对应当日 00:00 (`Asia/Shanghai`) 的 UTC 毫秒时间戳;无法解析时为 `NaN` */
|
|
392
|
+
timestamp: number;
|
|
393
|
+
/** 数据日期所属时区 (`Asia/Shanghai`) */
|
|
394
|
+
tz: MarketTz;
|
|
360
395
|
raw: string[];
|
|
361
396
|
}
|
|
362
397
|
/**
|
|
@@ -384,7 +419,12 @@ interface HKQuote {
|
|
|
384
419
|
prevClose: number;
|
|
385
420
|
open: number;
|
|
386
421
|
volume: number;
|
|
422
|
+
/** 行情时间(原始字符串,腾讯接口格式 `yyyyMMddHHmmss`,港股时区) */
|
|
387
423
|
time: string;
|
|
424
|
+
/** UTC unix 毫秒时间戳;无法解析时为 `NaN` */
|
|
425
|
+
timestamp: number;
|
|
426
|
+
/** 行情时间所属市场时区 (`Asia/Hong_Kong`) */
|
|
427
|
+
tz: MarketTz;
|
|
388
428
|
change: number;
|
|
389
429
|
changePercent: number;
|
|
390
430
|
high: number;
|
|
@@ -414,8 +454,12 @@ interface USQuote {
|
|
|
414
454
|
open: number;
|
|
415
455
|
/** 成交量 */
|
|
416
456
|
volume: number;
|
|
417
|
-
/**
|
|
457
|
+
/** 行情时间(原始字符串,腾讯接口格式 `yyyyMMddHHmmss`,美东时区) */
|
|
418
458
|
time: string;
|
|
459
|
+
/** UTC unix 毫秒时间戳(自动处理美东夏令时);无法解析时为 `NaN` */
|
|
460
|
+
timestamp: number;
|
|
461
|
+
/** 行情时间所属市场时区 (`America/New_York`) */
|
|
462
|
+
tz: MarketTz;
|
|
419
463
|
/** 涨跌额 */
|
|
420
464
|
change: number;
|
|
421
465
|
/** 涨跌幅% */
|
|
@@ -455,8 +499,12 @@ interface FundQuote {
|
|
|
455
499
|
accNav: number;
|
|
456
500
|
/** 当日涨跌额 */
|
|
457
501
|
change: number;
|
|
458
|
-
/** 净值日期 */
|
|
502
|
+
/** 净值日期(原始字符串,如 `'2024-05-12'`,A 股时区) */
|
|
459
503
|
navDate: string;
|
|
504
|
+
/** 净值日期对应当日 00:00 (`Asia/Shanghai`) 的 UTC 毫秒时间戳;无法解析时为 `NaN` */
|
|
505
|
+
timestamp: number;
|
|
506
|
+
/** 净值日期所属时区 (`Asia/Shanghai`) */
|
|
507
|
+
tz: MarketTz;
|
|
460
508
|
raw: string[];
|
|
461
509
|
}
|
|
462
510
|
|
|
@@ -464,8 +512,12 @@ interface FundQuote {
|
|
|
464
512
|
* A 股历史 K 线(日/周/月)
|
|
465
513
|
*/
|
|
466
514
|
interface HistoryKline {
|
|
467
|
-
/** 日期 YYYY-MM-DD */
|
|
515
|
+
/** 日期 YYYY-MM-DD (A 股时区) */
|
|
468
516
|
date: string;
|
|
517
|
+
/** 当日 00:00 (`Asia/Shanghai`) 的 UTC 毫秒时间戳;无法解析时为 `NaN` */
|
|
518
|
+
timestamp: number;
|
|
519
|
+
/** 日期所属市场时区 (`Asia/Shanghai`) */
|
|
520
|
+
tz: MarketTz;
|
|
469
521
|
/** 股票代码 */
|
|
470
522
|
code: string;
|
|
471
523
|
/** 开盘价 */
|
|
@@ -493,8 +545,12 @@ interface HistoryKline {
|
|
|
493
545
|
* A 股分时数据(1 分钟)
|
|
494
546
|
*/
|
|
495
547
|
interface MinuteTimeline {
|
|
496
|
-
/** 时间 YYYY-MM-DD HH:mm */
|
|
548
|
+
/** 时间 YYYY-MM-DD HH:mm (A 股时区) */
|
|
497
549
|
time: string;
|
|
550
|
+
/** UTC 毫秒时间戳 (`Asia/Shanghai` 解释);无法解析时为 `NaN` */
|
|
551
|
+
timestamp: number;
|
|
552
|
+
/** 时间所属市场时区 (`Asia/Shanghai`) */
|
|
553
|
+
tz: MarketTz;
|
|
498
554
|
/** 开盘价 */
|
|
499
555
|
open: number | null;
|
|
500
556
|
/** 收盘价 */
|
|
@@ -514,8 +570,12 @@ interface MinuteTimeline {
|
|
|
514
570
|
* A 股分钟 K 线(5/15/30/60)
|
|
515
571
|
*/
|
|
516
572
|
interface MinuteKline {
|
|
517
|
-
/** 时间 YYYY-MM-DD HH:mm */
|
|
573
|
+
/** 时间 YYYY-MM-DD HH:mm (A 股时区) */
|
|
518
574
|
time: string;
|
|
575
|
+
/** UTC 毫秒时间戳 (`Asia/Shanghai` 解释);无法解析时为 `NaN` */
|
|
576
|
+
timestamp: number;
|
|
577
|
+
/** 时间所属市场时区 (`Asia/Shanghai`) */
|
|
578
|
+
tz: MarketTz;
|
|
519
579
|
/** 开盘价 */
|
|
520
580
|
open: number | null;
|
|
521
581
|
/** 收盘价 */
|
|
@@ -541,8 +601,15 @@ interface MinuteKline {
|
|
|
541
601
|
* 当日分时项
|
|
542
602
|
*/
|
|
543
603
|
interface TodayTimeline {
|
|
544
|
-
/** 时间 HH:mm */
|
|
604
|
+
/** 时间 HH:mm (A 股时区) */
|
|
545
605
|
time: string;
|
|
606
|
+
/**
|
|
607
|
+
* UTC 毫秒时间戳。由所属 `TodayTimelineResponse.date` 与 `time` 拼接后,
|
|
608
|
+
* 按 `Asia/Shanghai` 解释得到;无法解析时为 `NaN`。
|
|
609
|
+
*/
|
|
610
|
+
timestamp: number;
|
|
611
|
+
/** 时间所属市场时区 (`Asia/Shanghai`) */
|
|
612
|
+
tz: MarketTz;
|
|
546
613
|
/** 当前价 */
|
|
547
614
|
price: number;
|
|
548
615
|
/** 均价 */
|
|
@@ -558,8 +625,12 @@ interface TodayTimeline {
|
|
|
558
625
|
interface TodayTimelineResponse {
|
|
559
626
|
/** 股票代码 */
|
|
560
627
|
code: string;
|
|
561
|
-
/** 交易日期 YYYY-MM-DD */
|
|
628
|
+
/** 交易日期 YYYY-MM-DD (A 股时区) */
|
|
562
629
|
date: string;
|
|
630
|
+
/** 交易日 00:00 (`Asia/Shanghai`) 的 UTC 毫秒时间戳;无法解析时为 `NaN` */
|
|
631
|
+
timestamp: number;
|
|
632
|
+
/** 日期所属市场时区 (`Asia/Shanghai`) */
|
|
633
|
+
tz: MarketTz;
|
|
563
634
|
/**
|
|
564
635
|
* 昨收价
|
|
565
636
|
* - 由 SDK 解析腾讯接口的 `quoteFields[4]` 得到
|
|
@@ -570,11 +641,16 @@ interface TodayTimelineResponse {
|
|
|
570
641
|
data: TodayTimeline[];
|
|
571
642
|
}
|
|
572
643
|
/**
|
|
573
|
-
* 港股 / 美股历史 K
|
|
644
|
+
* 港股 / 美股历史 K 线公共字段。
|
|
645
|
+
*
|
|
646
|
+
* 内部基类,通常不直接使用。请用具体的 `HKHistoryKline` 或 `USHistoryKline`,
|
|
647
|
+
* 它们各自带本地化字段 (`currency` / `lotSize`)。
|
|
574
648
|
*/
|
|
575
|
-
interface
|
|
576
|
-
/** 日期 YYYY-MM-DD */
|
|
649
|
+
interface ForeignHistoryKlineBase {
|
|
650
|
+
/** 日期 YYYY-MM-DD (市场本地时区) */
|
|
577
651
|
date: string;
|
|
652
|
+
/** UTC 毫秒时间戳;无法解析时为 `NaN` */
|
|
653
|
+
timestamp: number;
|
|
578
654
|
/** 股票代码 */
|
|
579
655
|
code: string;
|
|
580
656
|
/** 股票名称 */
|
|
@@ -600,6 +676,41 @@ interface HKUSHistoryKline {
|
|
|
600
676
|
/** 换手率% */
|
|
601
677
|
turnoverRate: number | null;
|
|
602
678
|
}
|
|
679
|
+
/**
|
|
680
|
+
* 港股历史 K 线
|
|
681
|
+
*
|
|
682
|
+
* `currency` 固定 `'HKD'`,`tz` 固定 `'Asia/Hong_Kong'`。
|
|
683
|
+
* `lotSize`(每手股数)由 K 线接口本身不直接返回,目前为 `null`,
|
|
684
|
+
* 后续若数据源补齐再填充;如需港股每手股数请用 `getHKQuotes` 的 `lotSize` 字段。
|
|
685
|
+
*/
|
|
686
|
+
interface HKHistoryKline extends ForeignHistoryKlineBase {
|
|
687
|
+
/** 时区 (`Asia/Hong_Kong`) */
|
|
688
|
+
tz: MarketTz;
|
|
689
|
+
/** 计价币种 (固定 `'HKD'`) */
|
|
690
|
+
currency: 'HKD';
|
|
691
|
+
/** 港股每手股数;K 线接口暂不返回,固定 `null` */
|
|
692
|
+
lotSize: number | null;
|
|
693
|
+
}
|
|
694
|
+
/**
|
|
695
|
+
* 美股历史 K 线
|
|
696
|
+
*
|
|
697
|
+
* `currency` 固定 `'USD'`,`tz` 固定 `'America/New_York'`(自动处理夏令时切换)。
|
|
698
|
+
* 不含盘前/盘后(extended hours)数据,仅常规交易时段。
|
|
699
|
+
*/
|
|
700
|
+
interface USHistoryKline extends ForeignHistoryKlineBase {
|
|
701
|
+
/** 时区 (`America/New_York`,含夏令时) */
|
|
702
|
+
tz: MarketTz;
|
|
703
|
+
/** 计价币种 (固定 `'USD'`) */
|
|
704
|
+
currency: 'USD';
|
|
705
|
+
}
|
|
706
|
+
/**
|
|
707
|
+
* 港股 / 美股历史 K 线 (兼容别名)
|
|
708
|
+
*
|
|
709
|
+
* @deprecated 自 v1.9.1 起拆分为 {@link HKHistoryKline} 与 {@link USHistoryKline},
|
|
710
|
+
* 各自带本地化字段 (currency / lotSize)。本别名仍是它们的 union,
|
|
711
|
+
* 老代码无需立即迁移;新代码请直接用具体类型以获得更好的类型推断。
|
|
712
|
+
*/
|
|
713
|
+
type HKUSHistoryKline = HKHistoryKline | USHistoryKline;
|
|
603
714
|
|
|
604
715
|
/**
|
|
605
716
|
* 行业板块列表项
|
|
@@ -989,6 +1100,15 @@ interface SearchResult {
|
|
|
989
1100
|
*/
|
|
990
1101
|
category?: SearchResultType;
|
|
991
1102
|
}
|
|
1103
|
+
/**
|
|
1104
|
+
* 外部财经站点链接
|
|
1105
|
+
*/
|
|
1106
|
+
interface ExternalLink {
|
|
1107
|
+
/** 站点名称 */
|
|
1108
|
+
name: string;
|
|
1109
|
+
/** 可直接打开的 URL */
|
|
1110
|
+
url: string;
|
|
1111
|
+
}
|
|
992
1112
|
/**
|
|
993
1113
|
* 分红派送详情
|
|
994
1114
|
*/
|
|
@@ -1743,9 +1863,19 @@ interface GetUSCodeListOptions {
|
|
|
1743
1863
|
*/
|
|
1744
1864
|
|
|
1745
1865
|
interface HistoryKlineOptions {
|
|
1746
|
-
/** K 线周期 */
|
|
1866
|
+
/** K 线周期 @default 'daily' */
|
|
1747
1867
|
period?: 'daily' | 'weekly' | 'monthly';
|
|
1748
|
-
/**
|
|
1868
|
+
/**
|
|
1869
|
+
* 复权类型
|
|
1870
|
+
*
|
|
1871
|
+
* - `'qfq'` 前复权(默认):用最新一次分红送股调整历史价格,适合看走势
|
|
1872
|
+
* - `'hfq'` 后复权:固定历史价格,把分红送股摊到当下,适合长期收益率/复利计算
|
|
1873
|
+
* - `''` 不复权:返回交易所原始价格
|
|
1874
|
+
*
|
|
1875
|
+
* **未传时默认使用 `'qfq'`**。如果做回测、计算分红再投资收益,请显式传 `'hfq'` 或 `''`。
|
|
1876
|
+
*
|
|
1877
|
+
* @default 'qfq'
|
|
1878
|
+
*/
|
|
1749
1879
|
adjust?: '' | 'qfq' | 'hfq';
|
|
1750
1880
|
/** 开始日期 YYYYMMDD */
|
|
1751
1881
|
startDate?: string;
|
|
@@ -1753,9 +1883,17 @@ interface HistoryKlineOptions {
|
|
|
1753
1883
|
endDate?: string;
|
|
1754
1884
|
}
|
|
1755
1885
|
interface MinuteKlineOptions {
|
|
1756
|
-
/** K 线周期 */
|
|
1886
|
+
/** K 线周期 @default '1' */
|
|
1757
1887
|
period?: '1' | '5' | '15' | '30' | '60';
|
|
1758
|
-
/**
|
|
1888
|
+
/**
|
|
1889
|
+
* 复权类型(仅 5/15/30/60 分钟有效;1 分钟分时不支持复权)
|
|
1890
|
+
*
|
|
1891
|
+
* - `'qfq'` 前复权(默认)
|
|
1892
|
+
* - `'hfq'` 后复权
|
|
1893
|
+
* - `''` 不复权
|
|
1894
|
+
*
|
|
1895
|
+
* @default 'qfq'
|
|
1896
|
+
*/
|
|
1759
1897
|
adjust?: '' | 'qfq' | 'hfq';
|
|
1760
1898
|
/** 开始时间 */
|
|
1761
1899
|
startDate?: string;
|
|
@@ -1771,9 +1909,19 @@ interface MinuteKlineOptions {
|
|
|
1771
1909
|
* 通用历史 K 线请求选项
|
|
1772
1910
|
*/
|
|
1773
1911
|
interface HistoryKlineRequestOptions {
|
|
1774
|
-
/** K 线周期 */
|
|
1912
|
+
/** K 线周期 @default 'daily' */
|
|
1775
1913
|
period?: 'daily' | 'weekly' | 'monthly';
|
|
1776
|
-
/**
|
|
1914
|
+
/**
|
|
1915
|
+
* 复权类型
|
|
1916
|
+
*
|
|
1917
|
+
* - `'qfq'` 前复权(默认)
|
|
1918
|
+
* - `'hfq'` 后复权
|
|
1919
|
+
* - `''` 不复权
|
|
1920
|
+
*
|
|
1921
|
+
* 详见 [复权说明](https://stock-sdk.linkdiary.cn/guide/dividend-adjustment.html)。
|
|
1922
|
+
*
|
|
1923
|
+
* @default 'qfq'
|
|
1924
|
+
*/
|
|
1777
1925
|
adjust?: '' | 'qfq' | 'hfq';
|
|
1778
1926
|
/** 开始日期 YYYYMMDD */
|
|
1779
1927
|
startDate?: string;
|
|
@@ -2601,6 +2749,31 @@ interface KlineWithIndicatorsOptions {
|
|
|
2601
2749
|
indicators?: IndicatorOptions;
|
|
2602
2750
|
}
|
|
2603
2751
|
|
|
2752
|
+
/**
|
|
2753
|
+
* 交易日历 / 市场状态工具
|
|
2754
|
+
*
|
|
2755
|
+
* 在原有 `getTradingCalendar()` 字符串数组之外,提供更高层的便利方法:
|
|
2756
|
+
* - `isTradingDay(date?)`:判断是否交易日 (A 股,基于上游日历)
|
|
2757
|
+
* - `nextTradingDay(date?)` / `prevTradingDay(date?)`:跳转最近的交易日
|
|
2758
|
+
* - `getMarketStatus(market?)`:返回当前市场是开盘/午休/盘前/盘后/休市等状态
|
|
2759
|
+
*
|
|
2760
|
+
* 港股 / 美股没有官方日历数据源,`getMarketStatus('HK' | 'US')` 退化为
|
|
2761
|
+
* "周一-周五 + 已知交易时段"判断。法定假日不会被识别。
|
|
2762
|
+
*/
|
|
2763
|
+
|
|
2764
|
+
/**
|
|
2765
|
+
* 市场实时状态。
|
|
2766
|
+
*
|
|
2767
|
+
* - `'pre_market'` 盘前(含集合竞价)
|
|
2768
|
+
* - `'open'` 连续竞价交易中
|
|
2769
|
+
* - `'lunch_break'` 午间休市(港股 12:00-13:00,A 股 11:30-13:00;美股无)
|
|
2770
|
+
* - `'after_hours'` 盘后
|
|
2771
|
+
* - `'closed'` 非交易日 / 周末 / 凌晨等远离交易时段的时间
|
|
2772
|
+
*/
|
|
2773
|
+
type MarketStatus = 'pre_market' | 'open' | 'lunch_break' | 'after_hours' | 'closed';
|
|
2774
|
+
/** 支持的市场枚举,用于 `getMarketStatus`。 */
|
|
2775
|
+
type SupportedMarket = 'A' | 'HK' | 'US';
|
|
2776
|
+
|
|
2604
2777
|
declare class StockSDK {
|
|
2605
2778
|
private readonly client;
|
|
2606
2779
|
private readonly quoteService;
|
|
@@ -2614,6 +2787,7 @@ declare class StockSDK {
|
|
|
2614
2787
|
private readonly marketEventService;
|
|
2615
2788
|
private readonly dragonTigerService;
|
|
2616
2789
|
private readonly dataService;
|
|
2790
|
+
private readonly tradingCalendarService;
|
|
2617
2791
|
/**
|
|
2618
2792
|
* 创建 Stock SDK 实例。
|
|
2619
2793
|
* 旧的全局 `timeout` / `retry` / `rateLimit` / `circuitBreaker` 配置继续有效,
|
|
@@ -2713,29 +2887,50 @@ declare class StockSDK {
|
|
|
2713
2887
|
*/
|
|
2714
2888
|
getConceptMinuteKline(symbol: string, options?: ConceptBoardMinuteKlineOptions): Promise<ConceptBoardMinuteTimeline[] | ConceptBoardMinuteKline[]>;
|
|
2715
2889
|
/**
|
|
2716
|
-
* 获取 A 股历史 K
|
|
2890
|
+
* 获取 A 股历史 K 线(日/周/月,含复权)。
|
|
2891
|
+
*
|
|
2892
|
+
* **复权默认值:`adjust='qfq'`(前复权)。**
|
|
2893
|
+
* - 前复权适合看走势/做技术分析
|
|
2894
|
+
* - 后复权 `'hfq'` 适合算长期收益率/复利
|
|
2895
|
+
* - 不复权 `''` 是交易所原始价
|
|
2896
|
+
*
|
|
2897
|
+
* 不显式传 `adjust` 时返回的是已经被前复权调整过的价格,
|
|
2898
|
+
* 做回测/收益计算时务必显式传值,详见
|
|
2899
|
+
* [复权说明](https://stock-sdk.linkdiary.cn/guide/dividend-adjustment.html)。
|
|
2900
|
+
*
|
|
2717
2901
|
* @param symbol 股票代码
|
|
2718
2902
|
* @param options K 线参数
|
|
2719
2903
|
*/
|
|
2720
2904
|
getHistoryKline(symbol: string, options?: HistoryKlineOptions): Promise<HistoryKline[]>;
|
|
2721
2905
|
/**
|
|
2722
|
-
* 获取 A 股分时/分钟 K
|
|
2906
|
+
* 获取 A 股分时/分钟 K 线。
|
|
2907
|
+
*
|
|
2908
|
+
* **复权默认值:`adjust='qfq'`(前复权,仅 5/15/30/60 分钟有效)。** 1 分钟分时不支持复权。
|
|
2909
|
+
*
|
|
2723
2910
|
* @param symbol 股票代码
|
|
2724
|
-
* @param options
|
|
2911
|
+
* @param options 周期参数(不传周期则返回当日分时)
|
|
2725
2912
|
*/
|
|
2726
2913
|
getMinuteKline(symbol: string, options?: MinuteKlineOptions): Promise<MinuteTimeline[] | MinuteKline[]>;
|
|
2727
2914
|
/**
|
|
2728
|
-
* 获取港股历史 K
|
|
2915
|
+
* 获取港股历史 K 线。
|
|
2916
|
+
*
|
|
2917
|
+
* **复权默认值:`adjust='qfq'`(前复权)。** 详见
|
|
2918
|
+
* [复权说明](https://stock-sdk.linkdiary.cn/guide/dividend-adjustment.html)。
|
|
2919
|
+
*
|
|
2729
2920
|
* @param symbol 港股代码
|
|
2730
2921
|
* @param options K 线参数
|
|
2731
2922
|
*/
|
|
2732
|
-
getHKHistoryKline(symbol: string, options?: HKKlineOptions): Promise<
|
|
2923
|
+
getHKHistoryKline(symbol: string, options?: HKKlineOptions): Promise<HKHistoryKline[]>;
|
|
2733
2924
|
/**
|
|
2734
|
-
* 获取美股历史 K
|
|
2925
|
+
* 获取美股历史 K 线。
|
|
2926
|
+
*
|
|
2927
|
+
* **复权默认值:`adjust='qfq'`(前复权)。** 详见
|
|
2928
|
+
* [复权说明](https://stock-sdk.linkdiary.cn/guide/dividend-adjustment.html)。
|
|
2929
|
+
*
|
|
2735
2930
|
* @param symbol 美股代码
|
|
2736
2931
|
* @param options K 线参数
|
|
2737
2932
|
*/
|
|
2738
|
-
getUSHistoryKline(symbol: string, options?: USKlineOptions): Promise<
|
|
2933
|
+
getUSHistoryKline(symbol: string, options?: USKlineOptions): Promise<USHistoryKline[]>;
|
|
2739
2934
|
/**
|
|
2740
2935
|
* 模糊搜索股票/指数/基金等
|
|
2741
2936
|
* @param keyword 关键词(代码 / 名称 / 拼音)
|
|
@@ -2792,6 +2987,53 @@ declare class StockSDK {
|
|
|
2792
2987
|
* 获取交易日历(A 股)
|
|
2793
2988
|
*/
|
|
2794
2989
|
getTradingCalendar(): Promise<string[]>;
|
|
2990
|
+
/**
|
|
2991
|
+
* 判断给定日期是否为 A 股交易日。
|
|
2992
|
+
*
|
|
2993
|
+
* 数据源:`getTradingCalendar()` (腾讯接口,带 12 小时缓存)。
|
|
2994
|
+
* 第一次调用会拉取全量交易日列表,后续命中缓存。
|
|
2995
|
+
*
|
|
2996
|
+
* @param date 不传则取"现在 `Asia/Shanghai` 的当日"。
|
|
2997
|
+
* 支持 `'YYYY-MM-DD'` / `'YYYYMMDD'` / `Date` 对象。
|
|
2998
|
+
* @example
|
|
2999
|
+
* ```ts
|
|
3000
|
+
* await sdk.isTradingDay(); // 今天是否交易日
|
|
3001
|
+
* await sdk.isTradingDay('2024-10-01'); // false (国庆)
|
|
3002
|
+
* ```
|
|
3003
|
+
*/
|
|
3004
|
+
isTradingDay(date?: string | Date): Promise<boolean>;
|
|
3005
|
+
/**
|
|
3006
|
+
* 返回 A 股下一个交易日 (`'YYYY-MM-DD'`)。
|
|
3007
|
+
*
|
|
3008
|
+
* 如果 `date` 本身是交易日,返回它**之后**的下一个;否则返回大于它的第一个交易日。
|
|
3009
|
+
*
|
|
3010
|
+
* @param date 不传则取"现在 `Asia/Shanghai` 的当日"
|
|
3011
|
+
* @throws RangeError 当 `date` 已超过日历范围时
|
|
3012
|
+
*/
|
|
3013
|
+
nextTradingDay(date?: string | Date): Promise<string>;
|
|
3014
|
+
/**
|
|
3015
|
+
* 返回 A 股上一个交易日 (`'YYYY-MM-DD'`)。
|
|
3016
|
+
*
|
|
3017
|
+
* 如果 `date` 本身是交易日,返回它**之前**的上一个;否则返回小于它的最后一个交易日。
|
|
3018
|
+
*
|
|
3019
|
+
* @param date 不传则取"现在 `Asia/Shanghai` 的当日"
|
|
3020
|
+
* @throws RangeError 当 `date` 早于日历最早日期时
|
|
3021
|
+
*/
|
|
3022
|
+
prevTradingDay(date?: string | Date): Promise<string>;
|
|
3023
|
+
/**
|
|
3024
|
+
* 返回当前市场实时状态 (同步,不发请求)。
|
|
3025
|
+
*
|
|
3026
|
+
* 状态包括:`'pre_market'`(盘前)/ `'open'`(交易中)/ `'lunch_break'`(午休) /
|
|
3027
|
+
* `'after_hours'`(盘后)/ `'closed'`(休市/周末)。
|
|
3028
|
+
*
|
|
3029
|
+
* **注意:此方法仅按交易时段判断,不识别法定假日**。如需精确判断"今天是否交易日",
|
|
3030
|
+
* 请用 `await isTradingDay()` (会发请求)。
|
|
3031
|
+
*
|
|
3032
|
+
* 港股 / 美股没有官方日历,只按 "周一-周五 + 已知交易时段" 判断,假日不会被识别。
|
|
3033
|
+
*
|
|
3034
|
+
* @param market `'A'`(默认) / `'HK'` / `'US'`
|
|
3035
|
+
*/
|
|
3036
|
+
getMarketStatus(market?: SupportedMarket): MarketStatus;
|
|
2795
3037
|
/**
|
|
2796
3038
|
* 获取分红配股明细
|
|
2797
3039
|
* @param symbol 股票代码
|
|
@@ -3004,4 +3246,11 @@ declare class StockSDK {
|
|
|
3004
3246
|
getMarginTargetList(date?: string): Promise<MarginTargetItem[]>;
|
|
3005
3247
|
}
|
|
3006
3248
|
|
|
3007
|
-
|
|
3249
|
+
/**
|
|
3250
|
+
* 根据搜索结果生成外部财经站点链接。
|
|
3251
|
+
* @param result 搜索结果
|
|
3252
|
+
* @returns 东方财富、雪球链接列表;未知市场退回站内搜索链接
|
|
3253
|
+
*/
|
|
3254
|
+
declare function generateSearchExternalLinks(result: SearchResult): ExternalLink[];
|
|
3255
|
+
|
|
3256
|
+
export { type AShareMarket, type ATROptions, type BIASOptions, type BOLLOptions, type BlockTradeDailyStatItem, type BlockTradeDateOptions, type BlockTradeDetailItem, type BlockTradeMarketStatItem, type BoardChangeItem, type CCIOptions, type CFFEXOptionQuote, type CFFEXOptionQuotesOptions, type ComexInventory, type ComexInventoryOptions, type ConceptBoard, type ConceptBoardConstituent, type ConceptBoardKline, type ConceptBoardKlineOptions, type ConceptBoardMinuteKline, type ConceptBoardMinuteKlineOptions, type ConceptBoardMinuteTimeline, type ConceptBoardSpot, type DMIOptions$1 as DMIOptions, type DMIResult$1 as DMIResult, type DatacenterQuery, type DatacenterResult, type DividendDetail, type DragonTigerBranchItem, type DragonTigerDateOptions, type DragonTigerDetailItem, type DragonTigerInstitutionItem, type DragonTigerPeriod, type DragonTigerSeatItem, type DragonTigerStockStatItem, type ETFOptionCate, type ETFOptionExpireDay, type ETFOptionMonth, type ExternalLink, type FullQuote, type FundFlow, type FundFlowOptions, type FundFlowRankItem, type FundFlowRankOptions, type FundQuote, type FuturesExchange, type FuturesInventory, type FuturesInventoryOptions, type FuturesInventorySymbol, type FuturesKline, type FuturesKlineOptions, type GetAShareCodeListOptions, type GetAllAShareQuotesOptions, type GlobalFuturesKlineOptions, type GlobalFuturesQuote, type GlobalFuturesSpotOptions, type HKHistoryKline, 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 USHistoryKline, type USQuote, type WROptions, type ZTPoolItem, type ZTPoolType, addIndicators, asyncPool, buildIndicatorContext, calcATR, calcBIAS, calcBOLL, calcCCI, calcDMI, calcEMA, calcKC, calcKDJ, calcMA, calcMACD, calcOBV, calcROC, calcRSI, calcSAR, calcSMA, calcWMA, calcWR, chunkArray, decodeGBK, StockSDK as default, estimateIndicatorLookback, extractJsonFromJsonp, generateSearchExternalLinks, getEnabledIndicatorKeys, getSdkErrorCode, jsonpRequest, parseResponse, safeNumber, safeNumberOrNull };
|