@t2b2c/agent-stock-sdk 0.0.0-stage → 0.1.1

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.
Files changed (92) hide show
  1. package/README.md +188 -2
  2. package/dist/board/ge7-themes.d.ts +4 -0
  3. package/dist/board/ge7-themes.d.ts.map +1 -0
  4. package/dist/board/ge7-themes.js +10 -0
  5. package/dist/board/limit-up-ladder.d.ts +8 -0
  6. package/dist/board/limit-up-ladder.d.ts.map +1 -0
  7. package/dist/board/limit-up-ladder.js +13 -0
  8. package/dist/client.d.ts +76 -0
  9. package/dist/client.d.ts.map +1 -0
  10. package/dist/client.js +130 -0
  11. package/dist/config.d.ts +34 -0
  12. package/dist/config.d.ts.map +1 -0
  13. package/dist/config.js +12 -0
  14. package/dist/http.d.ts +12 -0
  15. package/dist/http.d.ts.map +1 -0
  16. package/dist/http.js +60 -0
  17. package/dist/index.d.ts +35 -0
  18. package/dist/index.d.ts.map +1 -0
  19. package/dist/index.js +22 -0
  20. package/dist/kline/capture-kline-screenshots.d.ts +10 -0
  21. package/dist/kline/capture-kline-screenshots.d.ts.map +1 -0
  22. package/dist/kline/capture-kline-screenshots.js +133 -0
  23. package/dist/kline/capture-market-kline-screenshots.d.ts +13 -0
  24. package/dist/kline/capture-market-kline-screenshots.d.ts.map +1 -0
  25. package/dist/kline/capture-market-kline-screenshots.js +167 -0
  26. package/dist/kline/fetch-kline.d.ts +30 -0
  27. package/dist/kline/fetch-kline.d.ts.map +1 -0
  28. package/dist/kline/fetch-kline.js +54 -0
  29. package/dist/kline/fetch-market-kline.d.ts +10 -0
  30. package/dist/kline/fetch-market-kline.d.ts.map +1 -0
  31. package/dist/kline/fetch-market-kline.js +67 -0
  32. package/dist/kline/kline-list-url.d.ts +14 -0
  33. package/dist/kline/kline-list-url.d.ts.map +1 -0
  34. package/dist/kline/kline-list-url.js +46 -0
  35. package/dist/kline/market-symbols.d.ts +22 -0
  36. package/dist/kline/market-symbols.d.ts.map +1 -0
  37. package/dist/kline/market-symbols.js +105 -0
  38. package/dist/kline/normalize.d.ts +17 -0
  39. package/dist/kline/normalize.d.ts.map +1 -0
  40. package/dist/kline/normalize.js +34 -0
  41. package/dist/kline/screenshot-helpers.d.ts +59 -0
  42. package/dist/kline/screenshot-helpers.d.ts.map +1 -0
  43. package/dist/kline/screenshot-helpers.js +320 -0
  44. package/dist/kline/screenshot-route.d.ts +25 -0
  45. package/dist/kline/screenshot-route.d.ts.map +1 -0
  46. package/dist/kline/screenshot-route.js +65 -0
  47. package/dist/kline/webbridge-client.d.ts +22 -0
  48. package/dist/kline/webbridge-client.d.ts.map +1 -0
  49. package/dist/kline/webbridge-client.js +41 -0
  50. package/dist/pool/large-cap-limit-up-3d.d.ts +7 -0
  51. package/dist/pool/large-cap-limit-up-3d.d.ts.map +1 -0
  52. package/dist/pool/large-cap-limit-up-3d.js +20 -0
  53. package/dist/pool/large-cap-trend.d.ts +7 -0
  54. package/dist/pool/large-cap-trend.d.ts.map +1 -0
  55. package/dist/pool/large-cap-trend.js +20 -0
  56. package/dist/pool/limit-up-30d.d.ts +8 -0
  57. package/dist/pool/limit-up-30d.d.ts.map +1 -0
  58. package/dist/pool/limit-up-30d.js +21 -0
  59. package/dist/pool/pick-and-merge.d.ts +12 -0
  60. package/dist/pool/pick-and-merge.d.ts.map +1 -0
  61. package/dist/pool/pick-and-merge.js +110 -0
  62. package/dist/pool/query-bodies.d.ts +68 -0
  63. package/dist/pool/query-bodies.d.ts.map +1 -0
  64. package/dist/pool/query-bodies.js +121 -0
  65. package/dist/pool/small-cap-trend.d.ts +8 -0
  66. package/dist/pool/small-cap-trend.d.ts.map +1 -0
  67. package/dist/pool/small-cap-trend.js +27 -0
  68. package/dist/pool/snapshot-query.d.ts +5 -0
  69. package/dist/pool/snapshot-query.d.ts.map +1 -0
  70. package/dist/pool/snapshot-query.js +15 -0
  71. package/dist/types/board.d.ts +67 -0
  72. package/dist/types/board.d.ts.map +1 -0
  73. package/dist/types/board.js +1 -0
  74. package/dist/types/kline-screenshot.d.ts +64 -0
  75. package/dist/types/kline-screenshot.d.ts.map +1 -0
  76. package/dist/types/kline-screenshot.js +1 -0
  77. package/dist/types/kline.d.ts +31 -0
  78. package/dist/types/kline.d.ts.map +1 -0
  79. package/dist/types/kline.js +6 -0
  80. package/dist/types/market-kline-screenshot.d.ts +35 -0
  81. package/dist/types/market-kline-screenshot.d.ts.map +1 -0
  82. package/dist/types/market-kline-screenshot.js +1 -0
  83. package/dist/types/snapshot-pool.d.ts +53 -0
  84. package/dist/types/snapshot-pool.d.ts.map +1 -0
  85. package/dist/types/snapshot-pool.js +1 -0
  86. package/docs/SnapshotPoolItem/345/255/227/346/256/265/350/257/264/346/230/216.md +140 -0
  87. package/docs//344/270/244/344/270/252/350/266/213/345/212/277/347/245/250curl.md +102 -0
  88. package/docs//350/266/213/345/212/277/347/245/250/344/270/216/346/211/223/346/235/277/350/202/241/347/245/250/346/261/240.md +260 -0
  89. package/examples/capture-kline-screenshots.ts +151 -0
  90. package/examples/capture-market-kline-screenshots.ts +152 -0
  91. package/examples/fetch-snapshot-pools.ts +237 -0
  92. package/package.json +54 -4
@@ -0,0 +1,64 @@
1
+ export type KlineScreenshotPeriod = 'day' | 'week' | 'month';
2
+ export type CaptureKlineScreenshotsOptions = {
3
+ /** Stock codes in display order (e.g. `['000595', '000665']`). */
4
+ codes: string[];
5
+ /**
6
+ * Years of candles to fit in each card viewport.
7
+ * @default 2.5
8
+ */
9
+ years?: number;
10
+ /** Chart period passed to `/kline-list`. @default 'day' */
11
+ period?: KlineScreenshotPeriod;
12
+ /**
13
+ * stock-app origin hosting `/kline-list`.
14
+ * @default 'http://192.168.188.1:9311'
15
+ */
16
+ stockAppBaseUrl?: string;
17
+ /**
18
+ * Kimi WebBridge daemon origin.
19
+ * @default 'http://127.0.0.1:10086'
20
+ */
21
+ webbridgeBaseUrl?: string;
22
+ /** WebBridge session id (one task = one session). Auto-generated when omitted. */
23
+ session?: string;
24
+ /** Directory for PNG outputs. Defaults to OS temp under `agent-stock-sdk-kline`. */
25
+ outputDir?: string;
26
+ /** Filename prefix, e.g. `wb` → `wb-000595.png`. @default 'kline' */
27
+ filePrefix?: string;
28
+ /** Max wait for cards / canvases to render. @default 60_000 */
29
+ timeoutMs?: number;
30
+ /** Poll interval while waiting for charts. @default 1_000 */
31
+ pollIntervalMs?: number;
32
+ /** Settle after card resize before CDP clip. @default 900 */
33
+ settleMs?: number;
34
+ /**
35
+ * Close the WebBridge tab opened for this capture after screenshots finish
36
+ * (success or failure). Uses `close_tab` on the current session tab.
37
+ * @default true
38
+ */
39
+ closeTab?: boolean;
40
+ /** Optional fetch override (tests / custom Node fetch). */
41
+ fetch?: typeof fetch;
42
+ /**
43
+ * Inject WebBridge `command` for tests.
44
+ * When set, HTTP to the daemon is skipped.
45
+ */
46
+ command?: WebbridgeCommandFn;
47
+ };
48
+ export type WebbridgeCommandFn = (action: string, args?: Record<string, unknown>) => Promise<unknown>;
49
+ export type KlineCardScreenshot = {
50
+ code: string;
51
+ path: string;
52
+ sizeBytes: number;
53
+ };
54
+ export type CaptureKlineScreenshotsResult = {
55
+ url: string;
56
+ session: string;
57
+ years: number;
58
+ period: KlineScreenshotPeriod;
59
+ visibleBarsHint: number;
60
+ cards: KlineCardScreenshot[];
61
+ /** Whether the capture tab was closed via WebBridge `close_tab`. */
62
+ tabClosed: boolean;
63
+ };
64
+ //# sourceMappingURL=kline-screenshot.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kline-screenshot.d.ts","sourceRoot":"","sources":["../../src/types/kline-screenshot.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;AAE5D,MAAM,MAAM,8BAA8B,GAAG;IAC3C,kEAAkE;IAClE,KAAK,EAAE,MAAM,EAAE,CAAA;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,MAAM,CAAC,EAAE,qBAAqB,CAAA;IAC9B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC3B,OAAO,CAAC,OAAO,CAAC,CAAA;AAErB,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,qBAAqB,CAAA;IAC7B,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,mBAAmB,EAAE,CAAA;IAC5B,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAA;CACnB,CAAA"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,31 @@
1
+ export type KlinePeriod = 'daily' | 'weekly';
2
+ /** Unified OHLCV bar for agent consumers. */
3
+ export type KlineBar = {
4
+ date: string;
5
+ open: number | null;
6
+ high: number | null;
7
+ low: number | null;
8
+ close: number | null;
9
+ volume: number | null;
10
+ amount: number | null;
11
+ changePercent?: number | null;
12
+ change?: number | null;
13
+ code?: string;
14
+ name?: string;
15
+ };
16
+ export type IndexKlineSymbol = 'cyb' | 'sse' | 'nasdaq' | 'gold';
17
+ export declare const INDEX_KLINE_SYMBOLS: Record<IndexKlineSymbol, {
18
+ label: string;
19
+ code: string;
20
+ market: 'cn' | 'us' | 'futures';
21
+ }>;
22
+ export type FetchKlineOptions = {
23
+ period?: KlinePeriod;
24
+ /** YYYYMMDD */
25
+ startDate?: string;
26
+ /** YYYYMMDD */
27
+ endDate?: string;
28
+ /** CN only; ignored for US / futures. @default 'qfq' */
29
+ adjust?: '' | 'qfq' | 'hfq';
30
+ };
31
+ //# sourceMappingURL=kline.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kline.d.ts","sourceRoot":"","sources":["../../src/types/kline.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE5C,6CAA6C;AAC7C,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,gBAAgB,GACxB,KAAK,GACL,KAAK,GACL,QAAQ,GACR,MAAM,CAAA;AAEV,eAAO,MAAM,mBAAmB,EAAE,MAAM,CACtC,gBAAgB,EAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,CAMjE,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,eAAe;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,MAAM,CAAC,EAAE,EAAE,GAAG,KAAK,GAAG,KAAK,CAAA;CAC5B,CAAA"}
@@ -0,0 +1,6 @@
1
+ export const INDEX_KLINE_SYMBOLS = {
2
+ cyb: { label: '创业板指', code: 'sz399006', market: 'cn' },
3
+ sse: { label: '上证指数', code: 'sh000001', market: 'cn' },
4
+ nasdaq: { label: '纳斯达克指数', code: 'IXIC', market: 'us' },
5
+ gold: { label: '黄金 GC00Y', code: 'GC00Y', market: 'futures' },
6
+ };
@@ -0,0 +1,35 @@
1
+ import type { KlineScreenshotPeriod, WebbridgeCommandFn } from './kline-screenshot.js';
2
+ export type CaptureMarketKlineScreenshotsOptions = {
3
+ /**
4
+ * Preset ids (`cyb`,`sse`,`nasdaq`,`gold`) and/or `us:TICKER`.
5
+ * Omit for default presets.
6
+ */
7
+ symbols?: string[];
8
+ /**
9
+ * Years of candles in the viewport.
10
+ * @default 2.5
11
+ */
12
+ years?: number;
13
+ /** @default 'day' — market page supports day/week only */
14
+ period?: Exclude<KlineScreenshotPeriod, 'month'>;
15
+ stockAppBaseUrl?: string;
16
+ webbridgeBaseUrl?: string;
17
+ session?: string;
18
+ outputDir?: string;
19
+ filePrefix?: string;
20
+ timeoutMs?: number;
21
+ pollIntervalMs?: number;
22
+ /** Settle after card resize before CDP clip. @default 900 */
23
+ settleMs?: number;
24
+ /**
25
+ * `per-symbol` (default): navigate one symbol per page — avoids WebBridge
26
+ * selector clip bugs on scrollable multi-card lists.
27
+ * `batch`: one page with all symbols; scrolls each card into view before shot.
28
+ */
29
+ layout?: 'per-symbol' | 'batch';
30
+ /** @default true */
31
+ closeTab?: boolean;
32
+ fetch?: typeof fetch;
33
+ command?: WebbridgeCommandFn;
34
+ };
35
+ //# sourceMappingURL=market-kline-screenshot.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"market-kline-screenshot.d.ts","sourceRoot":"","sources":["../../src/types/market-kline-screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,uBAAuB,CAAA;AAE9B,MAAM,MAAM,oCAAoC,GAAG;IACjD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAA;IAChD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAA;IAC/B,oBAAoB;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAC7B,CAAA"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Agent 消费的 snapshot 行子集:对齐 K 线网格 `KlineGridCard` 头区 + 默认 meta +
3
+ * 各池筛选会驱动显示的技术 / 韭研列。完整 query 行字段远多于此,勿整行塞进上下文。
4
+ */
5
+ export type SnapshotPoolItem = {
6
+ code: string;
7
+ name?: string | null;
8
+ floatMarketCapYuan?: number | null;
9
+ fundHoldingsCount?: number | null;
10
+ financingBalanceYuan?: number | null;
11
+ price?: number | null;
12
+ changePercent?: number | null;
13
+ klineTurnover?: number | null;
14
+ amount?: number | null;
15
+ bullBarDate?: string | null;
16
+ dayReturn20d?: number | null;
17
+ dayReturn40d?: number | null;
18
+ dayReturn60d?: number | null;
19
+ weekReturn26w?: number | null;
20
+ boxAmplitudePct?: number | null;
21
+ jiuyanActDate?: string | null;
22
+ jiuyanFieldName?: string | null;
23
+ jiuyanLimitUpTotalDays?: number | null;
24
+ jiuyanLimitUpDuringDays?: number | null;
25
+ jiuyanConsecutiveLimitUpDays?: number | null;
26
+ jiuyanLimitUpTime?: string | null;
27
+ jiuyanBriefReason?: string[] | null;
28
+ jiuyanDetailReason?: string[] | null;
29
+ jiuyanThemeRank?: number | null;
30
+ };
31
+ /** Nest `POST /stocks/snapshot/query` 原始响应壳(items 未裁剪)。 */
32
+ export type SnapshotQueryResponse = {
33
+ items: unknown[];
34
+ total: number;
35
+ page: number;
36
+ pageSize: number;
37
+ dataVersion?: string | null;
38
+ stale?: boolean;
39
+ recentTradingDays10?: string[] | null;
40
+ };
41
+ export type SnapshotPoolResult = {
42
+ items: SnapshotPoolItem[];
43
+ /** 合并前各源返回的 total(若有分页截断,可能大于 items.length) */
44
+ sourceTotals: Record<string, number>;
45
+ dataVersion?: string | null;
46
+ stale?: boolean;
47
+ recentTradingDays10?: string[] | null;
48
+ };
49
+ export type SnapshotPoolQueryPaging = {
50
+ page?: number;
51
+ pageSize?: number;
52
+ };
53
+ //# sourceMappingURL=snapshot-pool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"snapshot-pool.d.ts","sourceRoot":"","sources":["../../src/types/snapshot-pool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEpB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEpC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,4BAA4B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5C,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACnC,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACpC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC,CAAA;AAED,2DAA2D;AAC3D,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACzB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,140 @@
1
+ # SnapshotPoolItem 字段说明
2
+
3
+ `SnapshotPoolItem` 不是 Nest `POST /stocks/snapshot/query` 的整包响应类型,而是 SDK 从 query **每一行**里裁剪出的子集(`pickSnapshotPoolItem`)。
4
+
5
+ - 整包响应壳:`SnapshotQueryResponse`(`items` / `total` / `page` …)
6
+ - 池方法返回:`SnapshotPoolResult`(`items: SnapshotPoolItem[]` + `sourceTotals` …)
7
+ - 单行子集:本文档的 `SnapshotPoolItem`
8
+
9
+ 对齐 K 线网格 `KlineGridCard`:头区 chips + 默认行情 meta + 各池筛选会驱动显示的技术 / 韭研列。完整 query 行字段远多于此,勿整行塞进 Agent 上下文。
10
+
11
+ 类型定义:`src/types/snapshot-pool.ts`。
12
+
13
+ ---
14
+
15
+ ## 1. 身份
16
+
17
+ | 字段 | 类型 | 含义 | 有什么用 | 举例 |
18
+ |------|------|------|----------|------|
19
+ | `code` | `string`(必有) | 股票代码 | 主键;合并去重、拉 K 线 / 截图、网格标题 | `"000001"`、`"600519"` |
20
+ | `name` | `string \| null` | 股票简称 | 展示用,旁挂在 code 旁 | `"平安银行"`、`"贵州茅台"` |
21
+
22
+ 无有效 `code` 的行会被丢弃。
23
+
24
+ ---
25
+
26
+ ## 2. 头区 chips(JJ / SZ)
27
+
28
+ 网格卡片头固定区:基金持股 / 流通市值 / 融资余额。
29
+
30
+ | 字段 | 类型 | 含义 | 有什么用 | 举例 |
31
+ |------|------|------|----------|------|
32
+ | `floatMarketCapYuan` | `number \| null` | 流通市值,单位 **元** | 分小/大市值池;UI 显示流通档 | `2e10` → 200 亿;池 A ≤ `3e10`(300 亿);池 C ≥ `5e10`(500 亿);池 D ≥ `3e10`(300 亿) |
33
+ | `fundHoldingsCount` | `number \| null` | 基金持股家数 | 机构参与度;A2 / 池 C 门槛 | `5`;A2 ≥ 3;池 C ≥ 40 |
34
+ | `financingBalanceYuan` | `number \| null` | 融资余额,单位 **元** | 杠杆资金热度芯片 | `1e8` → 1 亿元 |
35
+
36
+ > 读数时注意:市值 / 融资都是「元」,不是「亿元」。`2e10` = 200 亿。
37
+
38
+ ---
39
+
40
+ ## 3. 默认行情 meta
41
+
42
+ 网格默认可见列(非迷你 K 线模式)。
43
+
44
+ | 字段 | 类型 | 含义 | 有什么用 | 举例 |
45
+ |------|------|------|----------|------|
46
+ | `price` | `number \| null` | 最新价(通常为最近收盘价) | 看绝对价格档位 | `12.35` |
47
+ | `changePercent` | `number \| null` | 涨跌幅,单位 **%** | 当日强弱 | `5.2` → 涨 5.2%;`-2.1` → 跌 2.1% |
48
+ | `klineTurnover` | `number \| null` | 当日换手率,单位 **%** | 活跃度 / 筹码交换 | `3.2` → 换手 3.2% |
49
+ | `amount` | `number \| null` | 成交额(与 Nest snapshot 一致,通常为元) | 流动性粗判 | `1.5e9` 量级 |
50
+ | `bullBarDate` | `string \| null` | 走牛确认 bar 日期 | 「走牛点」列;趋势启动参照日 | `"2026-03-01"` |
51
+
52
+ ---
53
+
54
+ ## 4. 技术 / 收益(池筛选常用)
55
+
56
+ 多为百分比收益或振幅;具体筛选阈值见 [`趋势票与打板股票池.md`](./趋势票与打板股票池.md)。
57
+
58
+ | 字段 | 类型 | 含义 | 有什么用 | 举例 |
59
+ |------|------|------|----------|------|
60
+ | `dayReturn20d` | `number \| null` | 近 20 个交易日收益 % | 短线趋势强度;池 A 核心门槛 | `35`;A1 ≥ 30;A2 ≥ 25 |
61
+ | `dayReturn40d` | `number \| null` | 近 40 日收益 % | 中短周期;池 C 防过热上限 | `60`;池 C ≤ 100 |
62
+ | `dayReturn60d` | `number \| null` | 近 60 日收益 % | 中期趋势;池 A 区间、池 C 下限 | `50`;池 A ∈ `[25, 140]`;池 C ≥ 20 |
63
+ | `weekReturn26w` | `number \| null` | 近 26 周收益 % | 半年维度;过滤已翻倍过猛票 | `80`;池 A 常见上限 ≤ 180 |
64
+ | `boxAmplitudePct` | `number \| null` | 箱体振幅 % | 震荡幅度;过大说明波动过野 | `40`;池 A 常见上限 ≤ 150 |
65
+
66
+ ---
67
+
68
+ ## 5. 韭研异动 / 打板相关
69
+
70
+ 打板二波、中军、题材强度研判时重点看这组。
71
+
72
+ | 字段 | 类型 | 含义 | 有什么用 | 举例 |
73
+ |------|------|------|----------|------|
74
+ | `jiuyanActDate` | `string \| null` | 韭研异动日 | 时间窗筛选 + 默认排序键(desc) | `"2026-03-10"`;池 B 近 30 自然日;池 D 近 3 自然日 |
75
+ | `jiuyanFieldName` | `string \| null` | 韭研板块 / 题材名 | 归类主线题材 | `"银行"`、`"人工智能"` |
76
+ | `jiuyanLimitUpTotalDays` | `number \| null` | 涨停总天数(题材周期内累计) | 活跃度门槛 | `3`;池 A ≥ 2;池 B ≥ 5 |
77
+ | `jiuyanLimitUpDuringDays` | `number \| null` | 连板天数(本次行情持续天数口径) | 连板高度粗看 | `2` |
78
+ | `jiuyanConsecutiveLimitUpDays` | `number \| null` | 连续涨停天数 | 当前连板数 | `2` → 2 连板 |
79
+ | `jiuyanLimitUpTime` | `string \| null` | 涨停时间 | 早板 / 午后板强弱 | `"09:35:00"` |
80
+ | `jiuyanBriefReason` | `string[] \| null` | 涨停原因(简) | 一句话标签 | `["连板"]`、`["业绩预增"]` |
81
+ | `jiuyanDetailReason` | `string[] \| null` | 涨停原因(详) | 更细叙事 | `["主线", "资金回流"]` |
82
+ | `jiuyanThemeRank` | `number \| null` | 题材当日涨停强度排名 | 越小通常越强(视源定义) | `1` → 题材当日第一档 |
83
+
84
+ ---
85
+
86
+ ## 6. 完整示例(裁剪后)
87
+
88
+ ```ts
89
+ const item: SnapshotPoolItem = {
90
+ code: '000001',
91
+ name: '平安银行',
92
+ floatMarketCapYuan: 2e10, // 200 亿
93
+ fundHoldingsCount: 5,
94
+ financingBalanceYuan: 1e8, // 1 亿
95
+ price: 12.35,
96
+ changePercent: 5.2,
97
+ klineTurnover: 3.2,
98
+ amount: 1.5e9,
99
+ bullBarDate: '2026-03-01',
100
+ dayReturn20d: 35,
101
+ dayReturn40d: 60,
102
+ dayReturn60d: 50,
103
+ weekReturn26w: 80,
104
+ boxAmplitudePct: 40,
105
+ jiuyanActDate: '2026-03-10',
106
+ jiuyanFieldName: '银行',
107
+ jiuyanLimitUpTotalDays: 3,
108
+ jiuyanLimitUpDuringDays: 2,
109
+ jiuyanConsecutiveLimitUpDays: 2,
110
+ jiuyanLimitUpTime: '09:35:00',
111
+ jiuyanBriefReason: ['连板'],
112
+ jiuyanDetailReason: ['主线'],
113
+ jiuyanThemeRank: 1,
114
+ }
115
+ ```
116
+
117
+ Nest 原始 `items[]` 还会带大量其它列(如更长周期收益等);SDK 不会保留它们。例如测试里的 `dayReturn5d` / `dayReturn120d` 在 pick 后会被丢掉。
118
+
119
+ ---
120
+
121
+ ## 7. 和接口 / SDK 返回的关系
122
+
123
+ ```text
124
+ POST /stocks/snapshot/query
125
+ │
126
+ ▼
127
+ SnapshotQueryResponse
128
+ items: unknown[] ← 完整 snapshot 行(字段很多)
129
+ total / page / pageSize …
130
+ │
131
+ │ pickSnapshotPoolItem(s)
132
+ ▼
133
+ SnapshotPoolItem[] ← 本文档字段
134
+ │
135
+ │ 池方法封装
136
+ ▼
137
+ SnapshotPoolResult
138
+ items: SnapshotPoolItem[]
139
+ sourceTotals / dataVersion / stale / recentTradingDays10
140
+ ```
@@ -0,0 +1,102 @@
1
+
2
+ ## 小市值找趋势票 流通市值(亿)≤300, 找打板或主线趋势票
3
+
4
+ ```bash
5
+ curl --url 'http://192.168.188.1:9301/stocks/snapshot/query' \
6
+ -H 'Accept: application/json, text/plain, */*' \
7
+ -H 'Accept-Language: zh-CN,zh;q=0.9,en;q=0.8' \
8
+ -H 'Cache-Control: no-cache' \
9
+ -H 'Connection: keep-alive' \
10
+ -H 'Content-Type: application/json' \
11
+ -H 'Origin: http://192.168.188.1:9311' \
12
+ -H 'Pragma: no-cache' \
13
+ -H 'Referer: http://192.168.188.1:9311/' \
14
+ -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/157.0.0.0 Safari/537.36' \
15
+ -H 'rid: anti-csrf' \
16
+ -H 'st-auth-mode: cookie' \
17
+ --data-raw '{"filters":{"signalNames":[],"jiuyanFieldNames":[],"jiuyanThemeMatchQuery":"","jiuyanThemeRankMax":null,"onlyWithSignals":false,"changePercentMin":null,"changePercentMax":null,"amountMin":null,"amountMax":null,"klineTurnoverMin":null,"klineTurnoverMax":null,"bullConfirmed":false,"acquisitionOpenIn20Td":false,"reorganizationIn20Td":false,"stRemovalIn20Td":false,"stRemovalIn60Td":false,"earningsGrowthIn20Td":false,"earningsGrowthIn60Td":false,"detailDateInLast10Td":false,"minBoxWin":null,"ranges":{"weekReturn6w":{"min":null,"max":null},"weekReturn26w":{"min":null,"max":180},"dayReturn60d":{"min":25,"max":140},"boxAmplitudePct":{"min":null,"max":150},"floatMarketCapYuan":{"min":null,"max":30000000000},"jiuyanLimitUpDuringDays":{"min":null,"max":null},"dayReturn20d":{"min":30,"max":null},"jiuyanLimitUpTotalDays":{"min":2,"max":null}},"dateRanges":{}},"sort":{"field":"jiuyanActDate","order":"desc"},"page":0,"pageSize":100}' \
18
+ --insecure
19
+
20
+ ```
21
+
22
+
23
+ ## 基金持股大于3,小市值找趋势票2 流通市值(亿)≤300, 找打板或主线趋势票
24
+
25
+ ```bash
26
+ curl --url 'http://192.168.188.1:9301/stocks/snapshot/query' \
27
+ -H 'Accept: application/json, text/plain, */*' \
28
+ -H 'Accept-Language: zh-CN,zh;q=0.9,en;q=0.8' \
29
+ -H 'Cache-Control: no-cache' \
30
+ -H 'Connection: keep-alive' \
31
+ -H 'Content-Type: application/json' \
32
+ -H 'Origin: http://192.168.188.1:9311' \
33
+ -H 'Pragma: no-cache' \
34
+ -H 'Referer: http://192.168.188.1:9311/' \
35
+ -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/157.0.0.0 Safari/537.36' \
36
+ -H 'rid: anti-csrf' \
37
+ -H 'st-auth-mode: cookie' \
38
+ --data-raw '{"filters":{"signalNames":[],"jiuyanFieldNames":[],"jiuyanThemeMatchQuery":"","jiuyanThemeRankMax":null,"onlyWithSignals":false,"changePercentMin":null,"changePercentMax":null,"amountMin":null,"amountMax":null,"klineTurnoverMin":null,"klineTurnoverMax":null,"bullConfirmed":false,"acquisitionOpenIn20Td":false,"reorganizationIn20Td":false,"stRemovalIn20Td":false,"stRemovalIn60Td":false,"earningsGrowthIn20Td":false,"earningsGrowthIn60Td":false,"detailDateInLast10Td":false,"minBoxWin":null,"ranges":{"weekReturn6w":{"min":null,"max":null},"weekReturn26w":{"min":null,"max":180},"dayReturn60d":{"min":25,"max":140},"boxAmplitudePct":{"min":null,"max":150},"floatMarketCapYuan":{"min":null,"max":30000000000},"fundHoldingsCount":{"min":3,"max":null},"jiuyanLimitUpDuringDays":{"min":null,"max":null},"dayReturn20d":{"min":25,"max":null},"jiuyanLimitUpTotalDays":{"min":2,"max":null}},"dateRanges":{}},"sort":{"field":"jiuyanActDate","order":"desc"},"page":0,"pageSize":100}' \
39
+ --insecure
40
+
41
+ ```
42
+
43
+
44
+
45
+ ## 韭研异动日近30个自然日,涨停总天数≥5 的股票列表, 找打板或主线趋势票
46
+
47
+ ```bash
48
+ curl --url 'http://192.168.188.1:9301/stocks/snapshot/query' \
49
+ -H 'Accept: application/json, text/plain, */*' \
50
+ -H 'Accept-Language: zh-CN,zh;q=0.9,en;q=0.8' \
51
+ -H 'Cache-Control: no-cache' \
52
+ -H 'Connection: keep-alive' \
53
+ -H 'Content-Type: application/json' \
54
+ -H 'Origin: http://192.168.188.1:9311' \
55
+ -H 'Pragma: no-cache' \
56
+ -H 'Referer: http://192.168.188.1:9311/' \
57
+ -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/157.0.0.0 Safari/537.36' \
58
+ -H 'rid: anti-csrf' \
59
+ -H 'st-auth-mode: cookie' \
60
+ --data-raw '{"filters":{"signalNames":[],"jiuyanFieldNames":[],"jiuyanThemeMatchQuery":"","jiuyanThemeRankMax":null,"onlyWithSignals":false,"changePercentMin":null,"changePercentMax":null,"amountMin":null,"amountMax":null,"klineTurnoverMin":null,"klineTurnoverMax":null,"bullConfirmed":false,"acquisitionOpenIn20Td":false,"reorganizationIn20Td":false,"stRemovalIn20Td":false,"stRemovalIn60Td":false,"earningsGrowthIn20Td":false,"earningsGrowthIn60Td":false,"detailDateInLast10Td":false,"minBoxWin":null,"ranges":{"jiuyanLimitUpTotalDays":{"min":5,"max":null}},"dateRanges":{"jiuyanActDate":{"from":null,"to":null,"lastNDays":30}},"boards":["hz_zb","cyb","sz_zb"]},"sort":{"field":"jiuyanActDate","order":"desc"},"page":0,"pageSize":100}' \
61
+ --insecure
62
+ ```
63
+
64
+
65
+ ## 市值大于 500 亿,大市值哪个涨的好
66
+
67
+
68
+ ```
69
+ curl --url 'http://192.168.188.1:9301/stocks/snapshot/query' \
70
+ -H 'Accept: application/json, text/plain, */*' \
71
+ -H 'Accept-Language: zh-CN,zh;q=0.9,en;q=0.8' \
72
+ -H 'Cache-Control: no-cache' \
73
+ -H 'Connection: keep-alive' \
74
+ -H 'Content-Type: application/json' \
75
+ -H 'Origin: http://192.168.188.1:9311' \
76
+ -H 'Pragma: no-cache' \
77
+ -H 'Referer: http://192.168.188.1:9311/' \
78
+ -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/157.0.0.0 Safari/537.36' \
79
+ -H 'rid: anti-csrf' \
80
+ -H 'st-auth-mode: cookie' \
81
+ --data-raw '{"filters":{"signalNames":[],"jiuyanFieldNames":[],"jiuyanThemeMatchQuery":"","jiuyanThemeRankMax":null,"onlyWithSignals":false,"changePercentMin":null,"changePercentMax":null,"amountMin":null,"amountMax":null,"klineTurnoverMin":null,"klineTurnoverMax":null,"bullConfirmed":false,"acquisitionOpenIn20Td":false,"reorganizationIn20Td":false,"stRemovalIn20Td":false,"stRemovalIn60Td":false,"earningsGrowthIn20Td":false,"earningsGrowthIn60Td":false,"detailDateInLast10Td":false,"minBoxWin":null,"ranges":{"jiuyanLimitUpTotalDays":{"min":null,"max":null},"floatMarketCapYuan":{"min":50000000000,"max":null},"dayReturn40d":{"min":null,"max":100},"dayReturn60d":{"min":20,"max":null},"dayReturn10d":{"min":null,"max":null},"fundHoldingsCount":{"min":40,"max":null}},"dateRanges":{},"boards":["hz_zb","sz_zb"]},"sort":{"field":"jiuyanActDate","order":"desc"},"page":0,"pageSize":100}' \
82
+ --insecure
83
+ ```
84
+
85
+ ### 流通市值(亿)≥300, 韭研异动日近3个自然日涨停数大于等于 1,大市值涨停观察
86
+
87
+ ```
88
+ curl --url 'http://192.168.188.1:9301/stocks/snapshot/query' \
89
+ -H 'Accept: application/json, text/plain, */*' \
90
+ -H 'Accept-Language: zh-CN,zh;q=0.9,en;q=0.8' \
91
+ -H 'Cache-Control: no-cache' \
92
+ -H 'Connection: keep-alive' \
93
+ -H 'Content-Type: application/json' \
94
+ -H 'Origin: http://192.168.188.1:9311' \
95
+ -H 'Pragma: no-cache' \
96
+ -H 'Referer: http://192.168.188.1:9311/' \
97
+ -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/157.0.0.0 Safari/537.36' \
98
+ -H 'rid: anti-csrf' \
99
+ -H 'st-auth-mode: cookie' \
100
+ --data-raw '{"filters":{"signalNames":[],"jiuyanFieldNames":[],"jiuyanThemeMatchQuery":"","jiuyanThemeRankMax":null,"onlyWithSignals":false,"changePercentMin":null,"changePercentMax":null,"amountMin":null,"amountMax":null,"klineTurnoverMin":null,"klineTurnoverMax":null,"bullConfirmed":false,"acquisitionOpenIn20Td":false,"reorganizationIn20Td":false,"stRemovalIn20Td":false,"stRemovalIn60Td":false,"earningsGrowthIn20Td":false,"earningsGrowthIn60Td":false,"detailDateInLast10Td":false,"minBoxWin":null,"ranges":{"floatMarketCapYuan":{"min":30000000000,"max":null}},"dateRanges":{"jiuyanActDate":{"from":null,"to":null,"lastNDays":3}},"boards":["hz_zb","sz_zb","cyb"]},"sort":{"field":"jiuyanActDate","order":"desc"},"page":0,"pageSize":100}' \
101
+ --insecure
102
+ ```