@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
|
@@ -0,0 +1,237 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Executable demo: fetch snapshot stock pools via Nest `POST /stocks/snapshot/query`.
|
|
3
|
+
*
|
|
4
|
+
* Prerequisites:
|
|
5
|
+
* stock-api reachable (default http://192.168.188.1:9301)
|
|
6
|
+
*
|
|
7
|
+
* Run from monorepo root:
|
|
8
|
+
* pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools
|
|
9
|
+
*
|
|
10
|
+
* Options:
|
|
11
|
+
* pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools -- \
|
|
12
|
+
* --pool=all --page-size=100 --out=./tmp/snapshot-pools
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import { mkdir, writeFile } from 'node:fs/promises'
|
|
16
|
+
import { resolve } from 'node:path'
|
|
17
|
+
import {
|
|
18
|
+
AgentStockSdk,
|
|
19
|
+
AgentStockSdkHttpError,
|
|
20
|
+
type SnapshotPoolItem,
|
|
21
|
+
type SnapshotPoolResult,
|
|
22
|
+
} from '../src/index.js'
|
|
23
|
+
|
|
24
|
+
type PoolKind =
|
|
25
|
+
| 'trend'
|
|
26
|
+
| 'limitup'
|
|
27
|
+
| 'large-trend'
|
|
28
|
+
| 'large-limitup'
|
|
29
|
+
| 'both'
|
|
30
|
+
| 'all'
|
|
31
|
+
|
|
32
|
+
const POOL_KINDS = new Set<PoolKind>([
|
|
33
|
+
'trend',
|
|
34
|
+
'limitup',
|
|
35
|
+
'large-trend',
|
|
36
|
+
'large-limitup',
|
|
37
|
+
'both',
|
|
38
|
+
'all',
|
|
39
|
+
])
|
|
40
|
+
|
|
41
|
+
function printUsage(): void {
|
|
42
|
+
console.log(`Usage:
|
|
43
|
+
pnpm --filter @t2b2c/agent-stock-sdk example:snapshot-pools -- [options]
|
|
44
|
+
|
|
45
|
+
Options:
|
|
46
|
+
--pool=trend|limitup|large-trend|large-limitup|both|all
|
|
47
|
+
Which pool(s) (default: all)
|
|
48
|
+
--page=0 Query page (default: 0)
|
|
49
|
+
--page-size=100 Query pageSize (default: 100)
|
|
50
|
+
--api=URL Nest stock-api origin (default: http://192.168.188.1:9301)
|
|
51
|
+
--out=DIR Write JSON summaries under DIR (optional)
|
|
52
|
+
--codes-only Print only codes, one per line
|
|
53
|
+
--help Show this help
|
|
54
|
+
|
|
55
|
+
Pools:
|
|
56
|
+
trend 小市值找趋势股(A1∪A2)
|
|
57
|
+
limitup 近 30 自然日涨停活跃(打板二波 / 中军)
|
|
58
|
+
large-trend 大市值趋势(≥500 亿)
|
|
59
|
+
large-limitup 大市值涨停观察(≥300 亿,异动近 3 日)
|
|
60
|
+
both trend + limitup
|
|
61
|
+
all 以上全部
|
|
62
|
+
`)
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
function parseArgs(argv: string[]) {
|
|
66
|
+
const opts: {
|
|
67
|
+
pool: PoolKind
|
|
68
|
+
page: number
|
|
69
|
+
pageSize: number
|
|
70
|
+
apiBaseUrl?: string
|
|
71
|
+
out?: string
|
|
72
|
+
codesOnly: boolean
|
|
73
|
+
help: boolean
|
|
74
|
+
} = {
|
|
75
|
+
pool: 'all',
|
|
76
|
+
page: 0,
|
|
77
|
+
pageSize: 100,
|
|
78
|
+
codesOnly: false,
|
|
79
|
+
help: false,
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
for (const arg of argv) {
|
|
83
|
+
if (arg === '--') continue
|
|
84
|
+
if (arg === '--help' || arg === '-h') {
|
|
85
|
+
opts.help = true
|
|
86
|
+
continue
|
|
87
|
+
}
|
|
88
|
+
if (arg === '--codes-only') {
|
|
89
|
+
opts.codesOnly = true
|
|
90
|
+
continue
|
|
91
|
+
}
|
|
92
|
+
const m = /^--([^=]+)=(.*)$/.exec(arg)
|
|
93
|
+
if (!m) {
|
|
94
|
+
console.warn(`Ignoring unknown argument: ${arg}`)
|
|
95
|
+
continue
|
|
96
|
+
}
|
|
97
|
+
const [, key, value] = m
|
|
98
|
+
switch (key) {
|
|
99
|
+
case 'pool':
|
|
100
|
+
if (!POOL_KINDS.has(value as PoolKind)) {
|
|
101
|
+
throw new Error(`Invalid --pool=${value}`)
|
|
102
|
+
}
|
|
103
|
+
opts.pool = value as PoolKind
|
|
104
|
+
break
|
|
105
|
+
case 'page': {
|
|
106
|
+
const n = Number(value)
|
|
107
|
+
if (!Number.isInteger(n) || n < 0) throw new Error(`Invalid --page=${value}`)
|
|
108
|
+
opts.page = n
|
|
109
|
+
break
|
|
110
|
+
}
|
|
111
|
+
case 'page-size': {
|
|
112
|
+
const n = Number(value)
|
|
113
|
+
if (!Number.isInteger(n) || n <= 0) throw new Error(`Invalid --page-size=${value}`)
|
|
114
|
+
opts.pageSize = n
|
|
115
|
+
break
|
|
116
|
+
}
|
|
117
|
+
case 'api':
|
|
118
|
+
opts.apiBaseUrl = value
|
|
119
|
+
break
|
|
120
|
+
case 'out':
|
|
121
|
+
opts.out = resolve(process.cwd(), value)
|
|
122
|
+
break
|
|
123
|
+
default:
|
|
124
|
+
console.warn(`Ignoring unknown option: --${key}`)
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
return opts
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
function wants(
|
|
132
|
+
pool: PoolKind,
|
|
133
|
+
kind: 'trend' | 'limitup' | 'large-trend' | 'large-limitup',
|
|
134
|
+
): boolean {
|
|
135
|
+
if (pool === 'all') return true
|
|
136
|
+
if (pool === 'both') return kind === 'trend' || kind === 'limitup'
|
|
137
|
+
return pool === kind
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
function summarizeItem(row: SnapshotPoolItem): string {
|
|
141
|
+
const bits = [
|
|
142
|
+
row.code,
|
|
143
|
+
row.name ?? '',
|
|
144
|
+
row.jiuyanFieldName ? `题材=${row.jiuyanFieldName}` : '',
|
|
145
|
+
row.jiuyanActDate ? `异动=${row.jiuyanActDate}` : '',
|
|
146
|
+
row.jiuyanLimitUpTotalDays != null ? `涨停天=${row.jiuyanLimitUpTotalDays}` : '',
|
|
147
|
+
row.dayReturn20d != null ? `20d=${row.dayReturn20d}` : '',
|
|
148
|
+
row.dayReturn40d != null ? `40d=${row.dayReturn40d}` : '',
|
|
149
|
+
row.dayReturn60d != null ? `60d=${row.dayReturn60d}` : '',
|
|
150
|
+
row.floatMarketCapYuan != null
|
|
151
|
+
? `流通=${(row.floatMarketCapYuan / 1e8).toFixed(1)}亿`
|
|
152
|
+
: '',
|
|
153
|
+
row.fundHoldingsCount != null ? `基金=${row.fundHoldingsCount}` : '',
|
|
154
|
+
].filter(Boolean)
|
|
155
|
+
return bits.join(' ')
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
function printPool(label: string, pool: SnapshotPoolResult, codesOnly: boolean): void {
|
|
159
|
+
console.log(`\n=== ${label} ===`)
|
|
160
|
+
console.log(` count: ${pool.items.length}`)
|
|
161
|
+
console.log(` sourceTotals: ${JSON.stringify(pool.sourceTotals)}`)
|
|
162
|
+
if (pool.dataVersion != null) console.log(` dataVersion: ${pool.dataVersion}`)
|
|
163
|
+
if (pool.stale != null) console.log(` stale: ${pool.stale}`)
|
|
164
|
+
|
|
165
|
+
for (const row of pool.items) {
|
|
166
|
+
console.log(codesOnly ? row.code : ` ${summarizeItem(row)}`)
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
async function writePool(
|
|
171
|
+
out: string | undefined,
|
|
172
|
+
filename: string,
|
|
173
|
+
pool: SnapshotPoolResult,
|
|
174
|
+
): Promise<void> {
|
|
175
|
+
if (!out) return
|
|
176
|
+
const path = resolve(out, filename)
|
|
177
|
+
await writeFile(path, `${JSON.stringify(pool, null, 2)}\n`, 'utf8')
|
|
178
|
+
console.log(` wrote: ${path}`)
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
async function main(): Promise<void> {
|
|
182
|
+
const opts = parseArgs(process.argv.slice(2))
|
|
183
|
+
if (opts.help) {
|
|
184
|
+
printUsage()
|
|
185
|
+
return
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
const sdk = new AgentStockSdk({ apiBaseUrl: opts.apiBaseUrl })
|
|
189
|
+
const paging = { page: opts.page, pageSize: opts.pageSize }
|
|
190
|
+
|
|
191
|
+
console.log('Fetching snapshot pools…')
|
|
192
|
+
console.log(` api: ${sdk.apiBaseUrl}`)
|
|
193
|
+
console.log(` pool: ${opts.pool}`)
|
|
194
|
+
console.log(` page: ${paging.page}`)
|
|
195
|
+
console.log(` pageSize: ${paging.pageSize}`)
|
|
196
|
+
|
|
197
|
+
if (opts.out) {
|
|
198
|
+
await mkdir(opts.out, { recursive: true })
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
if (wants(opts.pool, 'trend')) {
|
|
202
|
+
const trend = await sdk.getSmallCapTrendPool(paging)
|
|
203
|
+
printPool('小市值趋势股 (A1∪A2)', trend, opts.codesOnly)
|
|
204
|
+
await writePool(opts.out, 'small-cap-trend-pool.json', trend)
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
if (wants(opts.pool, 'limitup')) {
|
|
208
|
+
const limitUp = await sdk.getLimitUp30dPool(paging)
|
|
209
|
+
printPool('近30自然日涨停活跃 (打板二波/中军)', limitUp, opts.codesOnly)
|
|
210
|
+
await writePool(opts.out, 'limit-up-30d-pool.json', limitUp)
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
if (wants(opts.pool, 'large-trend')) {
|
|
214
|
+
const largeTrend = await sdk.getLargeCapTrendPool(paging)
|
|
215
|
+
printPool('大市值趋势 (≥500亿)', largeTrend, opts.codesOnly)
|
|
216
|
+
await writePool(opts.out, 'large-cap-trend-pool.json', largeTrend)
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
if (wants(opts.pool, 'large-limitup')) {
|
|
220
|
+
const largeLimitUp = await sdk.getLargeCapLimitUp3dPool(paging)
|
|
221
|
+
printPool('大市值涨停观察 (≥300亿, 异动近3日)', largeLimitUp, opts.codesOnly)
|
|
222
|
+
await writePool(opts.out, 'large-cap-limit-up-3d-pool.json', largeLimitUp)
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
console.log('\nDone.')
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
main().catch((err) => {
|
|
229
|
+
if (err instanceof AgentStockSdkHttpError) {
|
|
230
|
+
console.error(`\nHTTP ${err.status}: ${err.message}`)
|
|
231
|
+
console.error(` url: ${err.url}`)
|
|
232
|
+
console.error('Check stock-api is up (default :9301).')
|
|
233
|
+
} else {
|
|
234
|
+
console.error(err instanceof Error ? err.message : err)
|
|
235
|
+
}
|
|
236
|
+
process.exitCode = 1
|
|
237
|
+
})
|
package/package.json
CHANGED
|
@@ -1,6 +1,54 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@t2b2c/agent-stock-sdk",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Agent-facing stock SDK: dabang boards, snapshot trend/limit-up pools (Nest API), index/gold K-lines via stock-sdk, and K-line card screenshots via Kimi WebBridge",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "./dist/index.js",
|
|
7
|
+
"types": "./dist/index.d.ts",
|
|
8
|
+
"exports": {
|
|
9
|
+
".": {
|
|
10
|
+
"types": "./dist/index.d.ts",
|
|
11
|
+
"import": "./dist/index.js",
|
|
12
|
+
"default": "./dist/index.js"
|
|
13
|
+
}
|
|
14
|
+
},
|
|
15
|
+
"files": [
|
|
16
|
+
"dist",
|
|
17
|
+
"README.md",
|
|
18
|
+
"docs",
|
|
19
|
+
"examples"
|
|
20
|
+
],
|
|
21
|
+
"publishConfig": {
|
|
22
|
+
"access": "public"
|
|
23
|
+
},
|
|
24
|
+
"scripts": {
|
|
25
|
+
"build": "tsc -p tsconfig.json",
|
|
26
|
+
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
27
|
+
"test": "vitest run",
|
|
28
|
+
"example:kline-shot": "tsx examples/capture-kline-screenshots.ts",
|
|
29
|
+
"example:market-kline-shot": "tsx examples/capture-market-kline-screenshots.ts",
|
|
30
|
+
"example:snapshot-pools": "tsx examples/fetch-snapshot-pools.ts",
|
|
31
|
+
"prepublishOnly": "pnpm run build"
|
|
32
|
+
},
|
|
33
|
+
"engines": {
|
|
34
|
+
"node": ">=18"
|
|
35
|
+
},
|
|
36
|
+
"keywords": [
|
|
37
|
+
"stock",
|
|
38
|
+
"sdk",
|
|
39
|
+
"limit-up",
|
|
40
|
+
"kline",
|
|
41
|
+
"agent"
|
|
42
|
+
],
|
|
43
|
+
"license": "UNLICENSED",
|
|
44
|
+
"dependencies": {
|
|
45
|
+
"stock-sdk": "^2.4.6"
|
|
46
|
+
},
|
|
47
|
+
"devDependencies": {
|
|
48
|
+
"@t2b2c/shared-config": "workspace:*",
|
|
49
|
+
"@types/node": "^22.19.1",
|
|
50
|
+
"tsx": "^4.19.4",
|
|
51
|
+
"typescript": "^5.9.3",
|
|
52
|
+
"vitest": "catalog:"
|
|
53
|
+
}
|
|
54
|
+
}
|