@t2b2c/agent-stock-sdk 0.0.0-stage → 0.1.0
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 +185 -2
- package/dist/board/ge7-themes.d.ts +4 -0
- package/dist/board/ge7-themes.d.ts.map +1 -0
- package/dist/board/ge7-themes.js +10 -0
- package/dist/board/limit-up-ladder.d.ts +8 -0
- package/dist/board/limit-up-ladder.d.ts.map +1 -0
- package/dist/board/limit-up-ladder.js +13 -0
- package/dist/client.d.ts +76 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +130 -0
- package/dist/config.d.ts +34 -0
- package/dist/config.d.ts.map +1 -0
- package/dist/config.js +12 -0
- package/dist/http.d.ts +12 -0
- package/dist/http.d.ts.map +1 -0
- package/dist/http.js +60 -0
- package/dist/index.d.ts +35 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +22 -0
- package/dist/kline/capture-kline-screenshots.d.ts +10 -0
- package/dist/kline/capture-kline-screenshots.d.ts.map +1 -0
- package/dist/kline/capture-kline-screenshots.js +155 -0
- package/dist/kline/capture-market-kline-screenshots.d.ts +8 -0
- package/dist/kline/capture-market-kline-screenshots.d.ts.map +1 -0
- package/dist/kline/capture-market-kline-screenshots.js +149 -0
- package/dist/kline/fetch-kline.d.ts +30 -0
- package/dist/kline/fetch-kline.d.ts.map +1 -0
- package/dist/kline/fetch-kline.js +54 -0
- package/dist/kline/fetch-market-kline.d.ts +10 -0
- package/dist/kline/fetch-market-kline.d.ts.map +1 -0
- package/dist/kline/fetch-market-kline.js +67 -0
- package/dist/kline/kline-list-url.d.ts +14 -0
- package/dist/kline/kline-list-url.d.ts.map +1 -0
- package/dist/kline/kline-list-url.js +46 -0
- package/dist/kline/market-symbols.d.ts +22 -0
- package/dist/kline/market-symbols.d.ts.map +1 -0
- package/dist/kline/market-symbols.js +105 -0
- package/dist/kline/normalize.d.ts +17 -0
- package/dist/kline/normalize.d.ts.map +1 -0
- package/dist/kline/normalize.js +34 -0
- package/dist/kline/screenshot-route.d.ts +25 -0
- package/dist/kline/screenshot-route.d.ts.map +1 -0
- package/dist/kline/screenshot-route.js +65 -0
- package/dist/kline/webbridge-client.d.ts +22 -0
- package/dist/kline/webbridge-client.d.ts.map +1 -0
- package/dist/kline/webbridge-client.js +41 -0
- package/dist/pool/large-cap-limit-up-3d.d.ts +7 -0
- package/dist/pool/large-cap-limit-up-3d.d.ts.map +1 -0
- package/dist/pool/large-cap-limit-up-3d.js +20 -0
- package/dist/pool/large-cap-trend.d.ts +7 -0
- package/dist/pool/large-cap-trend.d.ts.map +1 -0
- package/dist/pool/large-cap-trend.js +20 -0
- package/dist/pool/limit-up-30d.d.ts +8 -0
- package/dist/pool/limit-up-30d.d.ts.map +1 -0
- package/dist/pool/limit-up-30d.js +21 -0
- package/dist/pool/pick-and-merge.d.ts +12 -0
- package/dist/pool/pick-and-merge.d.ts.map +1 -0
- package/dist/pool/pick-and-merge.js +110 -0
- package/dist/pool/query-bodies.d.ts +68 -0
- package/dist/pool/query-bodies.d.ts.map +1 -0
- package/dist/pool/query-bodies.js +121 -0
- package/dist/pool/small-cap-trend.d.ts +8 -0
- package/dist/pool/small-cap-trend.d.ts.map +1 -0
- package/dist/pool/small-cap-trend.js +27 -0
- package/dist/pool/snapshot-query.d.ts +5 -0
- package/dist/pool/snapshot-query.d.ts.map +1 -0
- package/dist/pool/snapshot-query.js +15 -0
- package/dist/types/board.d.ts +67 -0
- package/dist/types/board.d.ts.map +1 -0
- package/dist/types/board.js +1 -0
- package/dist/types/kline-screenshot.d.ts +62 -0
- package/dist/types/kline-screenshot.d.ts.map +1 -0
- package/dist/types/kline-screenshot.js +1 -0
- package/dist/types/kline.d.ts +31 -0
- package/dist/types/kline.d.ts.map +1 -0
- package/dist/types/kline.js +6 -0
- package/dist/types/market-kline-screenshot.d.ts +27 -0
- package/dist/types/market-kline-screenshot.d.ts.map +1 -0
- package/dist/types/market-kline-screenshot.js +1 -0
- package/dist/types/snapshot-pool.d.ts +53 -0
- package/dist/types/snapshot-pool.d.ts.map +1 -0
- package/dist/types/snapshot-pool.js +1 -0
- package/docs//344/270/244/344/270/252/350/266/213/345/212/277/347/245/250curl.md +102 -0
- 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
- package/examples/capture-kline-screenshots.ts +151 -0
- package/examples/capture-market-kline-screenshots.ts +81 -0
- package/examples/fetch-snapshot-pools.ts +237 -0
- package/package.json +52 -4
package/README.md
CHANGED
|
@@ -1,3 +1,186 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @t2b2c/agent-stock-sdk
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
面向 Agent / Node 脚本的股票数据 SDK:
|
|
4
|
+
|
|
5
|
+
1. **打板模块**:对接 Nest `stock-api`(默认 `http://192.168.188.1:9301`)
|
|
6
|
+
2. **snapshot 股票池**:`POST /stocks/snapshot/query`
|
|
7
|
+
- 池 A `getSmallCapTrendPool`:小市值趋势股(两路 query 按 `code` 合并)
|
|
8
|
+
- 池 B `getLimitUp30dPool`:近 30 自然日涨停活跃(打板二波 / 中军候选)
|
|
9
|
+
- 池 C `getLargeCapTrendPool`:大市值趋势(≥500 亿)
|
|
10
|
+
- 池 D `getLargeCapLimitUp3dPool`:大市值涨停观察(≥300 亿,异动近 3 日)
|
|
11
|
+
3. **指数 / 黄金 K 线**:基于 npm [`stock-sdk`](https://www.npmjs.com/package/stock-sdk)
|
|
12
|
+
4. **K 线卡片截图**(Kimi WebBridge,`years` 默认 **2.5**):
|
|
13
|
+
- **A 股个股** → `/kline-list`(`captureKlineScreenshots`,按 `data-code`)
|
|
14
|
+
- **A 股指数 / 黄金 / 美股指数 / 美股个股** → `/market-kline-list`(`captureMarketKlineScreenshots`,按 `data-symbol`)
|
|
15
|
+
|
|
16
|
+
> 前端页面 `:9311/a-share-sentiment`、`/jiuyan-limit-up-board`、`/kline-list`、`/market-kline-list` 仅为 UI;打板 / 指数 / snapshot 数据直接读 Nest JSON 或 stock-sdk;截图走本机 WebBridge + `:9311`。
|
|
17
|
+
> 股票池字段约定见 [`docs/趋势票与打板股票池.md`](./docs/趋势票与打板股票池.md)。
|
|
18
|
+
|
|
19
|
+
## Install
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
pnpm add @t2b2c/agent-stock-sdk
|
|
23
|
+
# or
|
|
24
|
+
npm publish # from packages/ts-agent-stock-sdk after build
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## Quick start
|
|
28
|
+
|
|
29
|
+
```ts
|
|
30
|
+
import { AgentStockSdk } from '@t2b2c/agent-stock-sdk'
|
|
31
|
+
|
|
32
|
+
const sdk = new AgentStockSdk({
|
|
33
|
+
apiBaseUrl: 'http://192.168.188.1:9301',
|
|
34
|
+
stockAppBaseUrl: 'http://192.168.188.1:9311',
|
|
35
|
+
})
|
|
36
|
+
|
|
37
|
+
// 高板主题(≥7 连板日行)
|
|
38
|
+
const ge7 = await sdk.getGe7BoardThemes()
|
|
39
|
+
|
|
40
|
+
// 涨停快照(今/昨)
|
|
41
|
+
const snapshot = await sdk.getLimitUpSnapshot()
|
|
42
|
+
|
|
43
|
+
// 多日对比
|
|
44
|
+
const multiDay = await sdk.getMultiDayCompare()
|
|
45
|
+
|
|
46
|
+
// 小市值趋势股池(A1∪A2,按 code 合并,已裁剪网格必要字段)
|
|
47
|
+
const trendPool = await sdk.getSmallCapTrendPool()
|
|
48
|
+
|
|
49
|
+
// 近 30 自然日涨停活跃池(打板二波 / 中军候选)
|
|
50
|
+
const limitUpPool = await sdk.getLimitUp30dPool()
|
|
51
|
+
|
|
52
|
+
// 大市值趋势 / 大市值涨停观察
|
|
53
|
+
const largeTrend = await sdk.getLargeCapTrendPool()
|
|
54
|
+
const largeLimitUp3d = await sdk.getLargeCapLimitUp3dPool()
|
|
55
|
+
|
|
56
|
+
// 创业板 / 上证 / 纳指 / 黄金 日或周 K
|
|
57
|
+
const cybDaily = await sdk.getCybKline({ period: 'daily' })
|
|
58
|
+
const sseWeekly = await sdk.getSseKline({ period: 'weekly' })
|
|
59
|
+
const nasdaq = await sdk.getNasdaqKline({ period: 'daily' })
|
|
60
|
+
const gold = await sdk.getGoldKline({ period: 'weekly' })
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
## Snapshot 股票池 example
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
# 默认拉全部池(A–D)
|
|
67
|
+
pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools
|
|
68
|
+
|
|
69
|
+
pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools -- \
|
|
70
|
+
--pool=large-trend \
|
|
71
|
+
--out=./tmp/snapshot-pools
|
|
72
|
+
|
|
73
|
+
pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools -- \
|
|
74
|
+
--pool=large-limitup \
|
|
75
|
+
--codes-only
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## K 线截图(Kimi WebBridge)
|
|
79
|
+
|
|
80
|
+
前置:本机已装 WebBridge,daemon 在跑,浏览器扩展已连接。
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
~/.kimi-webbridge/bin/kimi-webbridge start
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
### 截图分流
|
|
87
|
+
|
|
88
|
+
| 标的 | API | 页面 | 选择器 |
|
|
89
|
+
|------|-----|------|--------|
|
|
90
|
+
| A 股个股(6 位) | `captureKlineScreenshots` | `/kline-list` | `[data-kline-card][data-code="000595"]` |
|
|
91
|
+
| 指数 / 黄金 / 美股 | `captureMarketKlineScreenshots` | `/market-kline-list` | `[data-kline-card][data-symbol="cyb"]` / `us:AAPL` |
|
|
92
|
+
|
|
93
|
+
混合同一批 token 时可先分流:
|
|
94
|
+
|
|
95
|
+
```ts
|
|
96
|
+
import { partitionKlineScreenshotTargets } from '@t2b2c/agent-stock-sdk'
|
|
97
|
+
|
|
98
|
+
const { aShareCodes, marketSymbols } = partitionKlineScreenshotTargets([
|
|
99
|
+
'000595',
|
|
100
|
+
'cyb',
|
|
101
|
+
'us:AAPL',
|
|
102
|
+
])
|
|
103
|
+
// aShareCodes → captureKlineScreenshots
|
|
104
|
+
// marketSymbols → captureMarketKlineScreenshots
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
### 可执行案例
|
|
108
|
+
|
|
109
|
+
```bash
|
|
110
|
+
# A 股个股:默认 codes=000595,000665,002187 · years=2.5
|
|
111
|
+
pnpm --filter @t2b2c/agent-stock-sdk example:kline-shot
|
|
112
|
+
|
|
113
|
+
pnpm --filter @t2b2c/agent-stock-sdk example:kline-shot -- \
|
|
114
|
+
--codes=000595,000665,002187 \
|
|
115
|
+
--years=2.5 \
|
|
116
|
+
--out=./tmp/kline-exports
|
|
117
|
+
|
|
118
|
+
# 市场标的:默认 cyb,sse,nasdaq,gold
|
|
119
|
+
pnpm --filter @t2b2c/agent-stock-sdk example:market-kline-shot
|
|
120
|
+
|
|
121
|
+
pnpm --filter @t2b2c/agent-stock-sdk example:market-kline-shot -- \
|
|
122
|
+
--symbols=cyb,sse,nasdaq,gold,us:AAPL \
|
|
123
|
+
--years=2.5 \
|
|
124
|
+
--out=./tmp/market-kline-exports
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
### 代码调用
|
|
128
|
+
|
|
129
|
+
```ts
|
|
130
|
+
import {
|
|
131
|
+
AgentStockSdk,
|
|
132
|
+
captureKlineScreenshots,
|
|
133
|
+
captureMarketKlineScreenshots,
|
|
134
|
+
} from '@t2b2c/agent-stock-sdk'
|
|
135
|
+
|
|
136
|
+
const sdk = new AgentStockSdk()
|
|
137
|
+
|
|
138
|
+
// A 股个股 → /kline-list?codes=…&years=2.5
|
|
139
|
+
const aShareShot = await sdk.captureKlineScreenshots({
|
|
140
|
+
codes: ['000595', '000665', '002187'],
|
|
141
|
+
})
|
|
142
|
+
|
|
143
|
+
// 指数 / 黄金 / 美股 → /market-kline-list?symbols=…&years=2.5
|
|
144
|
+
const marketShot = await sdk.captureMarketKlineScreenshots({
|
|
145
|
+
symbols: ['cyb', 'sse', 'nasdaq', 'gold', 'us:AAPL'],
|
|
146
|
+
})
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
## API map
|
|
150
|
+
|
|
151
|
+
| SDK | Nest / stock-sdk / UI |
|
|
152
|
+
|-----|------------------|
|
|
153
|
+
| `getGe7BoardThemes()` | `GET /market-sentiment/ge7-board-day-rows` |
|
|
154
|
+
| `getLimitUpSnapshot()` | `GET /jiuyan/limit-up-ladder` → `today_yesterday` |
|
|
155
|
+
| `getMultiDayCompare()` | `GET /jiuyan/limit-up-ladder` → `multi_day` |
|
|
156
|
+
| `getSmallCapTrendPool()` | `POST /stocks/snapshot/query` ×2(A1∪A2) |
|
|
157
|
+
| `getLimitUp30dPool()` | `POST /stocks/snapshot/query`(近 30 日涨停) |
|
|
158
|
+
| `getLargeCapTrendPool()` | `POST /stocks/snapshot/query`(大市值 ≥500 亿) |
|
|
159
|
+
| `getLargeCapLimitUp3dPool()` | `POST /stocks/snapshot/query`(大市值异动近 3 日) |
|
|
160
|
+
| `getCybKline` | `stock-sdk` `kline.cn('sz399006')` |
|
|
161
|
+
| `getSseKline` | `stock-sdk` `kline.cn('sh000001')` |
|
|
162
|
+
| `getNasdaqKline` | `stock-sdk` `kline.us('IXIC')` |
|
|
163
|
+
| `getGoldKline` | `stock-sdk` `futures.globalKline('GC00Y')` |
|
|
164
|
+
| `getMarketKlines` / `fetchMarketSymbolKline` | stock-sdk cn / us / futures |
|
|
165
|
+
| `captureKlineScreenshots` | WebBridge → `:9311/kline-list?codes=&years=` |
|
|
166
|
+
| `captureMarketKlineScreenshots` | WebBridge → `:9311/market-kline-list?symbols=&years=` |
|
|
167
|
+
|
|
168
|
+
## Publish
|
|
169
|
+
|
|
170
|
+
```bash
|
|
171
|
+
pnpm --filter @t2b2c/agent-stock-sdk build
|
|
172
|
+
pnpm --filter @t2b2c/agent-stock-sdk publish --access public
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
## Options
|
|
176
|
+
|
|
177
|
+
```ts
|
|
178
|
+
new AgentStockSdk({
|
|
179
|
+
apiBaseUrl: 'http://192.168.188.1:9301',
|
|
180
|
+
stockAppBaseUrl: 'http://192.168.188.1:9311',
|
|
181
|
+
webbridgeBaseUrl: 'http://127.0.0.1:10086',
|
|
182
|
+
// nestQuery: null, // disable SuperTokens bypass query
|
|
183
|
+
// fetch: customFetch,
|
|
184
|
+
// stockSdk: injectedStockSdk, // tests
|
|
185
|
+
})
|
|
186
|
+
```
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ge7-themes.d.ts","sourceRoot":"","sources":["../../src/board/ge7-themes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE5D,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,mBAAmB,CAAC,CAW9B"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export async function fetchGe7BoardThemes(http) {
|
|
2
|
+
const data = await http.getJson('/market-sentiment/ge7-board-day-rows');
|
|
3
|
+
return {
|
|
4
|
+
rows: Array.isArray(data.rows) ? data.rows : [],
|
|
5
|
+
sourceOk: data.sourceOk === true,
|
|
6
|
+
...(typeof data.generatedAt === 'string' ? { generatedAt: data.generatedAt } : {}),
|
|
7
|
+
...(typeof data.dateFrom === 'string' ? { dateFrom: data.dateFrom } : {}),
|
|
8
|
+
...(typeof data.dateTo === 'string' ? { dateTo: data.dateTo } : {}),
|
|
9
|
+
};
|
|
10
|
+
}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { HttpClient } from '../http.js';
|
|
2
|
+
import type { JiuyanLimitUpLadderJson, JiuyanLimitUpLadderMultiDay, JiuyanLimitUpLadderTodayYesterday } from '../types/board.js';
|
|
3
|
+
export declare function fetchJiuyanLimitUpLadder(http: HttpClient): Promise<JiuyanLimitUpLadderJson>;
|
|
4
|
+
/** 涨停快照(今/昨对比) */
|
|
5
|
+
export declare function fetchLimitUpSnapshot(http: HttpClient): Promise<JiuyanLimitUpLadderTodayYesterday | null>;
|
|
6
|
+
/** 多日对比 */
|
|
7
|
+
export declare function fetchMultiDayCompare(http: HttpClient): Promise<JiuyanLimitUpLadderMultiDay | null>;
|
|
8
|
+
//# sourceMappingURL=limit-up-ladder.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"limit-up-ladder.d.ts","sourceRoot":"","sources":["../../src/board/limit-up-ladder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,KAAK,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,iCAAiC,EAClC,MAAM,mBAAmB,CAAA;AAE1B,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,kBAAkB;AAClB,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,iCAAiC,GAAG,IAAI,CAAC,CAGnD;AAED,WAAW;AACX,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAG7C"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
export async function fetchJiuyanLimitUpLadder(http) {
|
|
2
|
+
return http.getJson('/jiuyan/limit-up-ladder');
|
|
3
|
+
}
|
|
4
|
+
/** 涨停快照(今/昨对比) */
|
|
5
|
+
export async function fetchLimitUpSnapshot(http) {
|
|
6
|
+
const ladder = await fetchJiuyanLimitUpLadder(http);
|
|
7
|
+
return ladder.today_yesterday ?? null;
|
|
8
|
+
}
|
|
9
|
+
/** 多日对比 */
|
|
10
|
+
export async function fetchMultiDayCompare(http) {
|
|
11
|
+
const ladder = await fetchJiuyanLimitUpLadder(http);
|
|
12
|
+
return ladder.multi_day ?? null;
|
|
13
|
+
}
|
package/dist/client.d.ts
ADDED
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
import type { AgentStockSdkOptions } from './config.js';
|
|
2
|
+
import { type StockSdkLike } from './kline/fetch-kline.js';
|
|
3
|
+
import type { Ge7BoardDayRowsJson, JiuyanLimitUpLadderJson, JiuyanLimitUpLadderMultiDay, JiuyanLimitUpLadderTodayYesterday } from './types/board.js';
|
|
4
|
+
import type { SnapshotPoolQueryPaging, SnapshotPoolResult } from './types/snapshot-pool.js';
|
|
5
|
+
import type { CaptureKlineScreenshotsOptions, CaptureKlineScreenshotsResult } from './types/kline-screenshot.js';
|
|
6
|
+
import type { CaptureMarketKlineScreenshotsOptions } from './types/market-kline-screenshot.js';
|
|
7
|
+
import type { FetchKlineOptions, IndexKlineSymbol, KlineBar } from './types/kline.js';
|
|
8
|
+
import type { MarketKlineSeries } from './kline/fetch-market-kline.js';
|
|
9
|
+
export type AgentStockSdkClientOptions = AgentStockSdkOptions & {
|
|
10
|
+
/** Inject a stock-sdk compatible instance (mainly for tests). */
|
|
11
|
+
stockSdk?: StockSdkLike;
|
|
12
|
+
};
|
|
13
|
+
/**
|
|
14
|
+
* Agent-facing stock SDK:
|
|
15
|
+
* - dabang board data from Nest stock-api
|
|
16
|
+
* - index / gold K-lines via `stock-sdk`
|
|
17
|
+
* - A-share K-line card screenshots via Kimi WebBridge + stock-app `/kline-list`
|
|
18
|
+
*/
|
|
19
|
+
export declare class AgentStockSdk {
|
|
20
|
+
readonly apiBaseUrl: string;
|
|
21
|
+
readonly stockAppBaseUrl: string;
|
|
22
|
+
readonly webbridgeBaseUrl: string;
|
|
23
|
+
private readonly http;
|
|
24
|
+
private readonly stockSdk?;
|
|
25
|
+
private readonly fetchImpl?;
|
|
26
|
+
constructor(options?: AgentStockSdkClientOptions);
|
|
27
|
+
/** 高板主题列表(≥7 连板日行) */
|
|
28
|
+
getGe7BoardThemes(): Promise<Ge7BoardDayRowsJson>;
|
|
29
|
+
/** 完整连板天梯 JSON(含涨停快照 + 多日对比) */
|
|
30
|
+
getLimitUpLadder(): Promise<JiuyanLimitUpLadderJson>;
|
|
31
|
+
/** 涨停快照(今/昨对比) */
|
|
32
|
+
getLimitUpSnapshot(): Promise<JiuyanLimitUpLadderTodayYesterday | null>;
|
|
33
|
+
/** 多日对比 */
|
|
34
|
+
getMultiDayCompare(): Promise<JiuyanLimitUpLadderMultiDay | null>;
|
|
35
|
+
/**
|
|
36
|
+
* 池 A:小市值找趋势股(A1∪A2 按 code 合并)。
|
|
37
|
+
* 可能含主线 / 副线 / 打板票;返回已裁剪的网格必要字段。
|
|
38
|
+
*/
|
|
39
|
+
getSmallCapTrendPool(paging?: SnapshotPoolQueryPaging): Promise<SnapshotPoolResult>;
|
|
40
|
+
/**
|
|
41
|
+
* 池 B:近 30 自然日涨停活跃池(涨停总天数 ≥ 5)。
|
|
42
|
+
* 用于打板二波 / 打板中军候选;勿与池 A 混并。
|
|
43
|
+
*/
|
|
44
|
+
getLimitUp30dPool(paging?: SnapshotPoolQueryPaging): Promise<SnapshotPoolResult>;
|
|
45
|
+
/**
|
|
46
|
+
* 池 C:大市值趋势(流通市值 ≥ 500 亿,基金持股 ≥ 40)。
|
|
47
|
+
*/
|
|
48
|
+
getLargeCapTrendPool(paging?: SnapshotPoolQueryPaging): Promise<SnapshotPoolResult>;
|
|
49
|
+
/**
|
|
50
|
+
* 池 D:大市值涨停观察(流通市值 ≥ 300 亿,韭研异动日近 3 自然日)。
|
|
51
|
+
*/
|
|
52
|
+
getLargeCapLimitUp3dPool(paging?: SnapshotPoolQueryPaging): Promise<SnapshotPoolResult>;
|
|
53
|
+
getIndexKline(symbol: IndexKlineSymbol, options?: FetchKlineOptions): Promise<KlineBar[]>;
|
|
54
|
+
/** 创业板指日/周 K */
|
|
55
|
+
getCybKline(options?: FetchKlineOptions): Promise<KlineBar[]>;
|
|
56
|
+
/** 上证指数日/周 K */
|
|
57
|
+
getSseKline(options?: FetchKlineOptions): Promise<KlineBar[]>;
|
|
58
|
+
/** 纳斯达克指数日/周 K */
|
|
59
|
+
getNasdaqKline(options?: FetchKlineOptions): Promise<KlineBar[]>;
|
|
60
|
+
/** 黄金 GC00Y 日/周 K */
|
|
61
|
+
getGoldKline(options?: FetchKlineOptions): Promise<KlineBar[]>;
|
|
62
|
+
/**
|
|
63
|
+
* A-share **individual stocks**: open `/kline-list` via WebBridge and save PNGs.
|
|
64
|
+
* `years` defaults to **2.5**.
|
|
65
|
+
*/
|
|
66
|
+
captureKlineScreenshots(options: Omit<CaptureKlineScreenshotsOptions, 'stockAppBaseUrl' | 'webbridgeBaseUrl' | 'fetch'> & Partial<Pick<CaptureKlineScreenshotsOptions, 'stockAppBaseUrl' | 'webbridgeBaseUrl' | 'fetch'>>): Promise<CaptureKlineScreenshotsResult>;
|
|
67
|
+
/**
|
|
68
|
+
* Indices / gold / US: open `/market-kline-list` via WebBridge and save PNGs.
|
|
69
|
+
* `years` defaults to **2.5**.
|
|
70
|
+
*/
|
|
71
|
+
captureMarketKlineScreenshots(options?: Omit<CaptureMarketKlineScreenshotsOptions, 'stockAppBaseUrl' | 'webbridgeBaseUrl' | 'fetch'> & Partial<Pick<CaptureMarketKlineScreenshotsOptions, 'stockAppBaseUrl' | 'webbridgeBaseUrl' | 'fetch'>>): Promise<CaptureKlineScreenshotsResult>;
|
|
72
|
+
/** Fetch market K-line series (presets + `us:TICKER`) via stock-sdk. */
|
|
73
|
+
getMarketKlines(symbols: string[], options?: FetchKlineOptions): Promise<MarketKlineSeries[]>;
|
|
74
|
+
getMarketSymbolKline(symbol: string, options?: FetchKlineOptions): Promise<MarketKlineSeries>;
|
|
75
|
+
}
|
|
76
|
+
//# sourceMappingURL=client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
package/dist/client.js
ADDED
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
import { fetchGe7BoardThemes } from './board/ge7-themes.js';
|
|
2
|
+
import { fetchJiuyanLimitUpLadder, fetchLimitUpSnapshot, fetchMultiDayCompare, } from './board/limit-up-ladder.js';
|
|
3
|
+
import { DEFAULT_STOCK_APP_BASE_URL, DEFAULT_WEBBRIDGE_BASE_URL, resolveApiBaseUrl, } from './config.js';
|
|
4
|
+
import { createHttpClient } from './http.js';
|
|
5
|
+
import { captureKlineScreenshots } from './kline/capture-kline-screenshots.js';
|
|
6
|
+
import { captureMarketKlineScreenshots } from './kline/capture-market-kline-screenshots.js';
|
|
7
|
+
import { fetchCybKline, fetchGoldKline, fetchIndexKline, fetchNasdaqKline, fetchSseKline, } from './kline/fetch-kline.js';
|
|
8
|
+
import { fetchMarketKlines, fetchMarketSymbolKline, } from './kline/fetch-market-kline.js';
|
|
9
|
+
import { fetchLargeCapLimitUp3dPool } from './pool/large-cap-limit-up-3d.js';
|
|
10
|
+
import { fetchLargeCapTrendPool } from './pool/large-cap-trend.js';
|
|
11
|
+
import { fetchLimitUp30dPool } from './pool/limit-up-30d.js';
|
|
12
|
+
import { fetchSmallCapTrendPool } from './pool/small-cap-trend.js';
|
|
13
|
+
/**
|
|
14
|
+
* Agent-facing stock SDK:
|
|
15
|
+
* - dabang board data from Nest stock-api
|
|
16
|
+
* - index / gold K-lines via `stock-sdk`
|
|
17
|
+
* - A-share K-line card screenshots via Kimi WebBridge + stock-app `/kline-list`
|
|
18
|
+
*/
|
|
19
|
+
export class AgentStockSdk {
|
|
20
|
+
apiBaseUrl;
|
|
21
|
+
stockAppBaseUrl;
|
|
22
|
+
webbridgeBaseUrl;
|
|
23
|
+
http;
|
|
24
|
+
stockSdk;
|
|
25
|
+
fetchImpl;
|
|
26
|
+
constructor(options = {}) {
|
|
27
|
+
this.apiBaseUrl = resolveApiBaseUrl(options);
|
|
28
|
+
this.stockAppBaseUrl = (options.stockAppBaseUrl ?? DEFAULT_STOCK_APP_BASE_URL).replace(/\/+$/, '');
|
|
29
|
+
this.webbridgeBaseUrl = (options.webbridgeBaseUrl ?? DEFAULT_WEBBRIDGE_BASE_URL).replace(/\/+$/, '');
|
|
30
|
+
this.http = createHttpClient(options);
|
|
31
|
+
this.stockSdk = options.stockSdk;
|
|
32
|
+
this.fetchImpl = options.fetch;
|
|
33
|
+
}
|
|
34
|
+
// —— 打板模块 ——
|
|
35
|
+
/** 高板主题列表(≥7 连板日行) */
|
|
36
|
+
getGe7BoardThemes() {
|
|
37
|
+
return fetchGe7BoardThemes(this.http);
|
|
38
|
+
}
|
|
39
|
+
/** 完整连板天梯 JSON(含涨停快照 + 多日对比) */
|
|
40
|
+
getLimitUpLadder() {
|
|
41
|
+
return fetchJiuyanLimitUpLadder(this.http);
|
|
42
|
+
}
|
|
43
|
+
/** 涨停快照(今/昨对比) */
|
|
44
|
+
getLimitUpSnapshot() {
|
|
45
|
+
return fetchLimitUpSnapshot(this.http);
|
|
46
|
+
}
|
|
47
|
+
/** 多日对比 */
|
|
48
|
+
getMultiDayCompare() {
|
|
49
|
+
return fetchMultiDayCompare(this.http);
|
|
50
|
+
}
|
|
51
|
+
// —— snapshot 股票池(POST /stocks/snapshot/query)——
|
|
52
|
+
/**
|
|
53
|
+
* 池 A:小市值找趋势股(A1∪A2 按 code 合并)。
|
|
54
|
+
* 可能含主线 / 副线 / 打板票;返回已裁剪的网格必要字段。
|
|
55
|
+
*/
|
|
56
|
+
getSmallCapTrendPool(paging) {
|
|
57
|
+
return fetchSmallCapTrendPool(this.http, paging);
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* 池 B:近 30 自然日涨停活跃池(涨停总天数 ≥ 5)。
|
|
61
|
+
* 用于打板二波 / 打板中军候选;勿与池 A 混并。
|
|
62
|
+
*/
|
|
63
|
+
getLimitUp30dPool(paging) {
|
|
64
|
+
return fetchLimitUp30dPool(this.http, paging);
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* 池 C:大市值趋势(流通市值 ≥ 500 亿,基金持股 ≥ 40)。
|
|
68
|
+
*/
|
|
69
|
+
getLargeCapTrendPool(paging) {
|
|
70
|
+
return fetchLargeCapTrendPool(this.http, paging);
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* 池 D:大市值涨停观察(流通市值 ≥ 300 亿,韭研异动日近 3 自然日)。
|
|
74
|
+
*/
|
|
75
|
+
getLargeCapLimitUp3dPool(paging) {
|
|
76
|
+
return fetchLargeCapLimitUp3dPool(this.http, paging);
|
|
77
|
+
}
|
|
78
|
+
// —— 指数 / 黄金 K 线 ——
|
|
79
|
+
getIndexKline(symbol, options) {
|
|
80
|
+
return fetchIndexKline(symbol, options, this.stockSdk);
|
|
81
|
+
}
|
|
82
|
+
/** 创业板指日/周 K */
|
|
83
|
+
getCybKline(options) {
|
|
84
|
+
return fetchCybKline(options, this.stockSdk);
|
|
85
|
+
}
|
|
86
|
+
/** 上证指数日/周 K */
|
|
87
|
+
getSseKline(options) {
|
|
88
|
+
return fetchSseKline(options, this.stockSdk);
|
|
89
|
+
}
|
|
90
|
+
/** 纳斯达克指数日/周 K */
|
|
91
|
+
getNasdaqKline(options) {
|
|
92
|
+
return fetchNasdaqKline(options, this.stockSdk);
|
|
93
|
+
}
|
|
94
|
+
/** 黄金 GC00Y 日/周 K */
|
|
95
|
+
getGoldKline(options) {
|
|
96
|
+
return fetchGoldKline(options, this.stockSdk);
|
|
97
|
+
}
|
|
98
|
+
// —— K 线卡片截图(Kimi WebBridge + /kline-list)——
|
|
99
|
+
/**
|
|
100
|
+
* A-share **individual stocks**: open `/kline-list` via WebBridge and save PNGs.
|
|
101
|
+
* `years` defaults to **2.5**.
|
|
102
|
+
*/
|
|
103
|
+
captureKlineScreenshots(options) {
|
|
104
|
+
return captureKlineScreenshots({
|
|
105
|
+
...options,
|
|
106
|
+
stockAppBaseUrl: options.stockAppBaseUrl ?? this.stockAppBaseUrl,
|
|
107
|
+
webbridgeBaseUrl: options.webbridgeBaseUrl ?? this.webbridgeBaseUrl,
|
|
108
|
+
fetch: options.fetch ?? this.fetchImpl,
|
|
109
|
+
});
|
|
110
|
+
}
|
|
111
|
+
/**
|
|
112
|
+
* Indices / gold / US: open `/market-kline-list` via WebBridge and save PNGs.
|
|
113
|
+
* `years` defaults to **2.5**.
|
|
114
|
+
*/
|
|
115
|
+
captureMarketKlineScreenshots(options = {}) {
|
|
116
|
+
return captureMarketKlineScreenshots({
|
|
117
|
+
...options,
|
|
118
|
+
stockAppBaseUrl: options.stockAppBaseUrl ?? this.stockAppBaseUrl,
|
|
119
|
+
webbridgeBaseUrl: options.webbridgeBaseUrl ?? this.webbridgeBaseUrl,
|
|
120
|
+
fetch: options.fetch ?? this.fetchImpl,
|
|
121
|
+
});
|
|
122
|
+
}
|
|
123
|
+
/** Fetch market K-line series (presets + `us:TICKER`) via stock-sdk. */
|
|
124
|
+
getMarketKlines(symbols, options) {
|
|
125
|
+
return fetchMarketKlines(symbols, options, this.stockSdk);
|
|
126
|
+
}
|
|
127
|
+
getMarketSymbolKline(symbol, options) {
|
|
128
|
+
return fetchMarketSymbolKline(symbol, options, this.stockSdk);
|
|
129
|
+
}
|
|
130
|
+
}
|
package/dist/config.d.ts
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/** Default Nest stock-api base URL (not the Next.js :9311 UI). */
|
|
2
|
+
export declare const DEFAULT_API_BASE_URL = "http://192.168.188.1:9301";
|
|
3
|
+
/** Default stock-app UI origin used by K-line screenshot capture. */
|
|
4
|
+
export declare const DEFAULT_STOCK_APP_BASE_URL = "http://192.168.188.1:9311";
|
|
5
|
+
/** Default Kimi WebBridge daemon origin. */
|
|
6
|
+
export declare const DEFAULT_WEBBRIDGE_BASE_URL = "http://127.0.0.1:10086";
|
|
7
|
+
export type AgentStockSdkOptions = {
|
|
8
|
+
/**
|
|
9
|
+
* Nest stock-api origin, e.g. `http://192.168.188.1:9301`.
|
|
10
|
+
* Trailing slash is stripped.
|
|
11
|
+
*/
|
|
12
|
+
apiBaseUrl?: string;
|
|
13
|
+
/**
|
|
14
|
+
* stock-app origin for `/kline-list` screenshots.
|
|
15
|
+
* @default 'http://192.168.188.1:9311'
|
|
16
|
+
*/
|
|
17
|
+
stockAppBaseUrl?: string;
|
|
18
|
+
/**
|
|
19
|
+
* Kimi WebBridge daemon origin.
|
|
20
|
+
* @default 'http://127.0.0.1:10086'
|
|
21
|
+
*/
|
|
22
|
+
webbridgeBaseUrl?: string;
|
|
23
|
+
/** Optional fetch implementation (defaults to global `fetch`). */
|
|
24
|
+
fetch?: typeof fetch;
|
|
25
|
+
/**
|
|
26
|
+
* Extra query string appended to Nest board endpoints
|
|
27
|
+
* (e.g. SuperTokens bypass used by the web app).
|
|
28
|
+
* @default 'superTokensDoNotDoInterception'
|
|
29
|
+
*/
|
|
30
|
+
nestQuery?: string | null;
|
|
31
|
+
};
|
|
32
|
+
export declare function normalizeApiBaseUrl(url: string): string;
|
|
33
|
+
export declare function resolveApiBaseUrl(options?: AgentStockSdkOptions): string;
|
|
34
|
+
//# sourceMappingURL=config.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,8BAA8B,CAAA;AAE/D,qEAAqE;AACrE,eAAO,MAAM,0BAA0B,8BAA8B,CAAA;AAErE,4CAA4C;AAC5C,eAAO,MAAM,0BAA0B,2BAA2B,CAAA;AAElE,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAExE"}
|
package/dist/config.js
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/** Default Nest stock-api base URL (not the Next.js :9311 UI). */
|
|
2
|
+
export const DEFAULT_API_BASE_URL = 'http://192.168.188.1:9301';
|
|
3
|
+
/** Default stock-app UI origin used by K-line screenshot capture. */
|
|
4
|
+
export const DEFAULT_STOCK_APP_BASE_URL = 'http://192.168.188.1:9311';
|
|
5
|
+
/** Default Kimi WebBridge daemon origin. */
|
|
6
|
+
export const DEFAULT_WEBBRIDGE_BASE_URL = 'http://127.0.0.1:10086';
|
|
7
|
+
export function normalizeApiBaseUrl(url) {
|
|
8
|
+
return url.replace(/\/+$/, '');
|
|
9
|
+
}
|
|
10
|
+
export function resolveApiBaseUrl(options) {
|
|
11
|
+
return normalizeApiBaseUrl(options?.apiBaseUrl ?? DEFAULT_API_BASE_URL);
|
|
12
|
+
}
|
package/dist/http.d.ts
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { AgentStockSdkOptions } from './config.js';
|
|
2
|
+
export declare class AgentStockSdkHttpError extends Error {
|
|
3
|
+
readonly status: number;
|
|
4
|
+
readonly url: string;
|
|
5
|
+
constructor(message: string, status: number, url: string);
|
|
6
|
+
}
|
|
7
|
+
export type HttpClient = {
|
|
8
|
+
getJson: <T>(path: string) => Promise<T>;
|
|
9
|
+
postJson: <T>(path: string, body: unknown) => Promise<T>;
|
|
10
|
+
};
|
|
11
|
+
export declare function createHttpClient(options?: AgentStockSdkOptions): HttpClient;
|
|
12
|
+
//# sourceMappingURL=http.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAGvD,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;gBAER,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAMzD;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IACxC,QAAQ,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;CACzD,CAAA;AAoBD,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,oBAAyB,GAAG,UAAU,CAgD/E"}
|
package/dist/http.js
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import { resolveApiBaseUrl } from './config.js';
|
|
2
|
+
export class AgentStockSdkHttpError extends Error {
|
|
3
|
+
status;
|
|
4
|
+
url;
|
|
5
|
+
constructor(message, status, url) {
|
|
6
|
+
super(message);
|
|
7
|
+
this.name = 'AgentStockSdkHttpError';
|
|
8
|
+
this.status = status;
|
|
9
|
+
this.url = url;
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
function buildNestUrl(baseUrl, path, nestQuery) {
|
|
13
|
+
const normalizedPath = path.startsWith('/') ? path : `/${path}`;
|
|
14
|
+
const url = new URL(`${baseUrl}${normalizedPath}`);
|
|
15
|
+
if (nestQuery) {
|
|
16
|
+
for (const part of nestQuery.split('&')) {
|
|
17
|
+
const [rawKey, ...rest] = part.split('=');
|
|
18
|
+
const key = rawKey?.trim();
|
|
19
|
+
if (!key)
|
|
20
|
+
continue;
|
|
21
|
+
url.searchParams.set(key, rest.join('=') || '');
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
return url;
|
|
25
|
+
}
|
|
26
|
+
export function createHttpClient(options = {}) {
|
|
27
|
+
const baseUrl = resolveApiBaseUrl(options);
|
|
28
|
+
const fetchImpl = options.fetch ?? globalThis.fetch;
|
|
29
|
+
const nestQuery = options.nestQuery === null
|
|
30
|
+
? ''
|
|
31
|
+
: (options.nestQuery ?? 'superTokensDoNotDoInterception');
|
|
32
|
+
if (typeof fetchImpl !== 'function') {
|
|
33
|
+
throw new Error('@t2b2c/agent-stock-sdk requires a fetch implementation (Node 18+ or pass options.fetch)');
|
|
34
|
+
}
|
|
35
|
+
return {
|
|
36
|
+
async getJson(path) {
|
|
37
|
+
const url = buildNestUrl(baseUrl, path, nestQuery);
|
|
38
|
+
const res = await fetchImpl(url.toString());
|
|
39
|
+
if (!res.ok) {
|
|
40
|
+
throw new AgentStockSdkHttpError(`Request failed (${res.status}) ${url.pathname}`, res.status, url.toString());
|
|
41
|
+
}
|
|
42
|
+
return (await res.json());
|
|
43
|
+
},
|
|
44
|
+
async postJson(path, body) {
|
|
45
|
+
const url = buildNestUrl(baseUrl, path, nestQuery);
|
|
46
|
+
const res = await fetchImpl(url.toString(), {
|
|
47
|
+
method: 'POST',
|
|
48
|
+
headers: {
|
|
49
|
+
Accept: 'application/json',
|
|
50
|
+
'Content-Type': 'application/json',
|
|
51
|
+
},
|
|
52
|
+
body: JSON.stringify(body),
|
|
53
|
+
});
|
|
54
|
+
if (!res.ok) {
|
|
55
|
+
throw new AgentStockSdkHttpError(`Request failed (${res.status}) ${url.pathname}`, res.status, url.toString());
|
|
56
|
+
}
|
|
57
|
+
return (await res.json());
|
|
58
|
+
},
|
|
59
|
+
};
|
|
60
|
+
}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
export { AgentStockSdk } from './client.js';
|
|
2
|
+
export type { AgentStockSdkClientOptions } from './client.js';
|
|
3
|
+
export { DEFAULT_API_BASE_URL, DEFAULT_STOCK_APP_BASE_URL, DEFAULT_WEBBRIDGE_BASE_URL, normalizeApiBaseUrl, resolveApiBaseUrl, } from './config.js';
|
|
4
|
+
export type { AgentStockSdkOptions } from './config.js';
|
|
5
|
+
export { AgentStockSdkHttpError, createHttpClient } from './http.js';
|
|
6
|
+
export type { HttpClient } from './http.js';
|
|
7
|
+
export { fetchGe7BoardThemes } from './board/ge7-themes.js';
|
|
8
|
+
export { fetchJiuyanLimitUpLadder, fetchLimitUpSnapshot, fetchMultiDayCompare, } from './board/limit-up-ladder.js';
|
|
9
|
+
export { buildLargeCapLimitUp3dBody, buildLargeCapTrendBody, buildLimitUp30dBody, buildSmallCapTrendA1Body, buildSmallCapTrendA2Body, } from './pool/query-bodies.js';
|
|
10
|
+
export { mergeSnapshotPoolByCode, pickSnapshotPoolItem, pickSnapshotPoolItems, } from './pool/pick-and-merge.js';
|
|
11
|
+
export { fetchLargeCapLimitUp3dPool } from './pool/large-cap-limit-up-3d.js';
|
|
12
|
+
export { fetchLargeCapTrendPool } from './pool/large-cap-trend.js';
|
|
13
|
+
export { fetchLimitUp30dPool } from './pool/limit-up-30d.js';
|
|
14
|
+
export { fetchSmallCapTrendPool } from './pool/small-cap-trend.js';
|
|
15
|
+
export { SNAPSHOT_QUERY_PATH, postSnapshotQuery } from './pool/snapshot-query.js';
|
|
16
|
+
export { fetchCybKline, fetchGoldKline, fetchIndexKline, fetchNasdaqKline, fetchSseKline, } from './kline/fetch-kline.js';
|
|
17
|
+
export type { StockSdkLike } from './kline/fetch-kline.js';
|
|
18
|
+
export { normalizeKlineBars } from './kline/normalize.js';
|
|
19
|
+
export { captureKlineScreenshots } from './kline/capture-kline-screenshots.js';
|
|
20
|
+
export { captureMarketKlineScreenshots } from './kline/capture-market-kline-screenshots.js';
|
|
21
|
+
export { buildKlineListUrl, DEFAULT_KLINE_SCREENSHOT_YEARS, estimateVisibleBarsForYears, normalizeStockCodes, } from './kline/kline-list-url.js';
|
|
22
|
+
export { buildMarketKlineListUrl, defaultMarketSymbols, parseMarketSymbols, resolveMarketSymbolToken, } from './kline/market-symbols.js';
|
|
23
|
+
export type { MarketKlineMarket, ResolvedMarketSymbol, } from './kline/market-symbols.js';
|
|
24
|
+
export { isAShareStockCode, partitionKlineScreenshotTargets, resolveKlineScreenshotPage, } from './kline/screenshot-route.js';
|
|
25
|
+
export type { KlineScreenshotPage, PartitionedKlineScreenshotTargets, } from './kline/screenshot-route.js';
|
|
26
|
+
export { fetchMarketKlines, fetchMarketSymbolKline, } from './kline/fetch-market-kline.js';
|
|
27
|
+
export type { MarketKlineSeries } from './kline/fetch-market-kline.js';
|
|
28
|
+
export { createWebbridgeClient, WebbridgeError } from './kline/webbridge-client.js';
|
|
29
|
+
export type { Ge7BoardDayRow, Ge7BoardDayRowsJson, JiuyanLimitUpLadderFirstToSecond, JiuyanLimitUpLadderJson, JiuyanLimitUpLadderMultiDay, JiuyanLimitUpLadderStock, JiuyanLimitUpLadderTier, JiuyanLimitUpLadderTodayYesterday, } from './types/board.js';
|
|
30
|
+
export type { SnapshotPoolItem, SnapshotPoolQueryPaging, SnapshotPoolResult, SnapshotQueryResponse, } from './types/snapshot-pool.js';
|
|
31
|
+
export { INDEX_KLINE_SYMBOLS, } from './types/kline.js';
|
|
32
|
+
export type { FetchKlineOptions, IndexKlineSymbol, KlineBar, KlinePeriod, } from './types/kline.js';
|
|
33
|
+
export type { CaptureKlineScreenshotsOptions, CaptureKlineScreenshotsResult, KlineCardScreenshot, KlineScreenshotPeriod, WebbridgeCommandFn, } from './types/kline-screenshot.js';
|
|
34
|
+
export type { CaptureMarketKlineScreenshotsOptions } from './types/market-kline-screenshot.js';
|
|
35
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
export { AgentStockSdk } from './client.js';
|
|
2
|
+
export { DEFAULT_API_BASE_URL, DEFAULT_STOCK_APP_BASE_URL, DEFAULT_WEBBRIDGE_BASE_URL, normalizeApiBaseUrl, resolveApiBaseUrl, } from './config.js';
|
|
3
|
+
export { AgentStockSdkHttpError, createHttpClient } from './http.js';
|
|
4
|
+
export { fetchGe7BoardThemes } from './board/ge7-themes.js';
|
|
5
|
+
export { fetchJiuyanLimitUpLadder, fetchLimitUpSnapshot, fetchMultiDayCompare, } from './board/limit-up-ladder.js';
|
|
6
|
+
export { buildLargeCapLimitUp3dBody, buildLargeCapTrendBody, buildLimitUp30dBody, buildSmallCapTrendA1Body, buildSmallCapTrendA2Body, } from './pool/query-bodies.js';
|
|
7
|
+
export { mergeSnapshotPoolByCode, pickSnapshotPoolItem, pickSnapshotPoolItems, } from './pool/pick-and-merge.js';
|
|
8
|
+
export { fetchLargeCapLimitUp3dPool } from './pool/large-cap-limit-up-3d.js';
|
|
9
|
+
export { fetchLargeCapTrendPool } from './pool/large-cap-trend.js';
|
|
10
|
+
export { fetchLimitUp30dPool } from './pool/limit-up-30d.js';
|
|
11
|
+
export { fetchSmallCapTrendPool } from './pool/small-cap-trend.js';
|
|
12
|
+
export { SNAPSHOT_QUERY_PATH, postSnapshotQuery } from './pool/snapshot-query.js';
|
|
13
|
+
export { fetchCybKline, fetchGoldKline, fetchIndexKline, fetchNasdaqKline, fetchSseKline, } from './kline/fetch-kline.js';
|
|
14
|
+
export { normalizeKlineBars } from './kline/normalize.js';
|
|
15
|
+
export { captureKlineScreenshots } from './kline/capture-kline-screenshots.js';
|
|
16
|
+
export { captureMarketKlineScreenshots } from './kline/capture-market-kline-screenshots.js';
|
|
17
|
+
export { buildKlineListUrl, DEFAULT_KLINE_SCREENSHOT_YEARS, estimateVisibleBarsForYears, normalizeStockCodes, } from './kline/kline-list-url.js';
|
|
18
|
+
export { buildMarketKlineListUrl, defaultMarketSymbols, parseMarketSymbols, resolveMarketSymbolToken, } from './kline/market-symbols.js';
|
|
19
|
+
export { isAShareStockCode, partitionKlineScreenshotTargets, resolveKlineScreenshotPage, } from './kline/screenshot-route.js';
|
|
20
|
+
export { fetchMarketKlines, fetchMarketSymbolKline, } from './kline/fetch-market-kline.js';
|
|
21
|
+
export { createWebbridgeClient, WebbridgeError } from './kline/webbridge-client.js';
|
|
22
|
+
export { INDEX_KLINE_SYMBOLS, } from './types/kline.js';
|