@hithink-tech/hithink-finance-cli 0.1.0

package/dist/contracts/remote-capabilities.js

@@ -0,0 +1,667 @@
+import { z } from 'zod';
+const isoDate = z.string().regex(/^\d{4}-\d{2}-\d{2}$/u);
+const aShareCode = z.string().regex(/^\d{6}\.(SH|SZ|BJ)$/iu);
+const indexCode = z.string().regex(/^\d{6}\.(SH|SZ|BJ|TI)$/iu);
+const commaCodes = z.string().min(1);
+const record = z.record(z.string(), z.unknown());
+const itemOutput = z.object({ item: z.array(record) }).passthrough();
+const objectOutput = z.object({}).passthrough();
+const historyInput = z
+    .object({
+    thscode: aShareCode,
+    startMs: z.number().int().nonnegative(),
+    endMs: z.number().int().nonnegative(),
+    adjust: z.enum(['none', 'forward', 'backward']).default('forward'),
+})
+    .strict()
+    .refine((value) => value.endMs >= value.startMs, { message: 'end-ms must be >= start-ms' });
+const indexHistoryInput = z
+    .object({
+    thscode: indexCode,
+    startMs: z.number().int().nonnegative(),
+    endMs: z.number().int().nonnegative(),
+})
+    .strict()
+    .refine((value) => value.endMs >= value.startMs, { message: 'end-ms must be >= start-ms' });
+const financialInput = z
+    .object({
+    thscode: aShareCode,
+    period: z.enum(['annual', 'quarterly']).default('annual'),
+    limit: z.number().int().min(1).max(20).optional(),
+    startMs: z.number().int().nonnegative().optional(),
+    endMs: z.number().int().nonnegative().optional(),
+})
+    .strict()
+    .superRefine((value, context) => {
+    const hasStart = value.startMs !== undefined;
+    const hasEnd = value.endMs !== undefined;
+    if (hasStart !== hasEnd) {
+        context.addIssue({
+            code: 'custom',
+            message: 'start-ms and end-ms must be provided together',
+        });
+    }
+    if ((hasStart || hasEnd) && value.limit !== undefined) {
+        context.addIssue({ code: 'custom', message: 'limit and date range are mutually exclusive' });
+    }
+    if (hasStart && hasEnd && value.endMs < value.startMs) {
+        context.addIssue({ code: 'custom', message: 'end-ms must be >= start-ms' });
+    }
+});
+const financialOptions = [
+    {
+        flags: '--thscode <code>',
+        description: 'single A-share thscode',
+        type: 'string',
+        required: true,
+    },
+    {
+        flags: '--period <period>',
+        description: 'financial period',
+        type: 'string',
+        choices: ['annual', 'quarterly'],
+        defaultValue: 'annual',
+    },
+    { flags: '--limit <number>', description: 'recent report count (1-20)', type: 'integer' },
+    {
+        flags: '--start-ms <milliseconds>',
+        description: 'range start in milliseconds',
+        type: 'integer',
+        queryName: 'start',
+    },
+    {
+        flags: '--end-ms <milliseconds>',
+        description: 'range end in milliseconds',
+        type: 'integer',
+        queryName: 'end',
+    },
+];
+function financial(id, command, endpoint) {
+    return {
+        id,
+        command: ['financials', command],
+        description: `Query ${command} financial statements`,
+        endpoint,
+        method: 'GET',
+        inputSchema: financialInput,
+        outputSchema: itemOutput,
+        options: financialOptions,
+        paging: 'none',
+        window: 'ten-years',
+    };
+}
+export const remoteCapabilities = [
+    {
+        id: 'symbol.search',
+        command: ['symbol', 'search'],
+        description: 'Resolve a name or code to thscode',
+        endpoint: '/api/meta/tickers/search',
+        method: 'GET',
+        inputSchema: z
+            .object({
+            q: z.string().min(1),
+            exchange: z.enum(['SH', 'SZ', 'BJ']).optional(),
+            assetType: z.enum(['a-share', 'a-share-index']).optional(),
+            limit: z.number().int().min(1).max(50).default(10),
+        })
+            .strict(),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--q <query>',
+                description: 'name, ticker, or thscode',
+                type: 'string',
+                required: true,
+            },
+            {
+                flags: '--exchange <exchange>',
+                description: 'exchange filter',
+                type: 'string',
+                choices: ['SH', 'SZ', 'BJ'],
+            },
+            {
+                flags: '--asset-type <type>',
+                description: 'asset type',
+                type: 'string',
+                choices: ['a-share', 'a-share-index'],
+                queryName: 'asset_type',
+            },
+            {
+                flags: '--limit <number>',
+                description: 'maximum matches (1-50)',
+                type: 'integer',
+                defaultValue: 10,
+            },
+        ],
+        paging: 'none',
+        window: 'none',
+    },
+    {
+        id: 'symbol.list',
+        command: ['symbol', 'list'],
+        description: 'List symbols with bounded pagination',
+        endpoint: '/api/meta/tickers/list',
+        method: 'GET',
+        inputSchema: z
+            .object({
+            exchange: z.string().default('SH,SZ'),
+            assetType: z.enum(['a-share', 'a-share-index']).default('a-share'),
+            limit: z.number().int().min(1).max(10000).default(1000),
+            offset: z.number().int().nonnegative().default(0),
+        })
+            .strict(),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--exchange <exchanges>',
+                description: 'comma-separated exchanges',
+                type: 'string',
+                defaultValue: 'SH,SZ',
+            },
+            {
+                flags: '--asset-type <type>',
+                description: 'asset type',
+                type: 'string',
+                choices: ['a-share', 'a-share-index'],
+                defaultValue: 'a-share',
+                queryName: 'asset_type',
+            },
+            {
+                flags: '--limit <number>',
+                description: 'page size (1-10000)',
+                type: 'integer',
+                defaultValue: 1000,
+            },
+            { flags: '--offset <number>', description: 'row offset', type: 'integer', defaultValue: 0 },
+        ],
+        paging: 'offset',
+        window: 'none',
+    },
+    {
+        id: 'market.snapshot',
+        command: ['market', 'snapshot'],
+        description: 'Query A-share price snapshots',
+        endpoint: '/api/a-share/prices/snapshot',
+        method: 'GET',
+        inputSchema: z
+            .object({
+            thscodes: commaCodes.optional(),
+            limit: z.number().int().min(1).max(10000).default(100),
+            offset: z.number().int().nonnegative().default(0),
+        })
+            .strict(),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--thscodes <codes>',
+                description: 'comma-separated A-share thscodes',
+                type: 'string',
+            },
+            { flags: '--limit <number>', description: 'page size', type: 'integer', defaultValue: 100 },
+            { flags: '--offset <number>', description: 'row offset', type: 'integer', defaultValue: 0 },
+        ],
+        paging: 'offset',
+        window: 'none',
+    },
+    {
+        id: 'market.history',
+        command: ['market', 'history'],
+        description: 'Query daily A-share history',
+        endpoint: '/api/a-share/prices/historical',
+        method: 'GET',
+        inputSchema: historyInput,
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--thscode <code>',
+                description: 'single A-share thscode',
+                type: 'string',
+                required: true,
+            },
+            {
+                flags: '--start-ms <milliseconds>',
+                description: 'start timestamp',
+                type: 'integer',
+                required: true,
+                queryName: 'start',
+            },
+            {
+                flags: '--end-ms <milliseconds>',
+                description: 'end timestamp',
+                type: 'integer',
+                required: true,
+                queryName: 'end',
+            },
+            {
+                flags: '--adjust <mode>',
+                description: 'adjustment mode',
+                type: 'string',
+                choices: ['none', 'forward', 'backward'],
+                defaultValue: 'forward',
+            },
+        ],
+        paging: 'none',
+        window: 'ten-years',
+    },
+    {
+        id: 'market.corporate-actions',
+        command: ['market', 'corporate-actions'],
+        description: 'Query adjustment events',
+        endpoint: '/api/a-share/corporate-actions/adjustment-factors',
+        method: 'GET',
+        inputSchema: z
+            .object({ thscode: aShareCode, fromDate: isoDate.optional(), toDate: isoDate.optional() })
+            .strict(),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--thscode <code>',
+                description: 'single A-share thscode',
+                type: 'string',
+                required: true,
+            },
+            {
+                flags: '--from-date <date>',
+                description: 'first ex-date YYYY-MM-DD',
+                type: 'string',
+                queryName: 'from',
+            },
+            {
+                flags: '--to-date <date>',
+                description: 'last ex-date YYYY-MM-DD',
+                type: 'string',
+                queryName: 'to',
+            },
+        ],
+        paging: 'none',
+        window: 'none',
+    },
+    financial('financials.income', 'income', '/api/a-share/financials/income-statements'),
+    financial('financials.balance-sheet', 'balance-sheet', '/api/a-share/financials/balance-sheets'),
+    financial('financials.cash-flow', 'cash-flow', '/api/a-share/financials/cash-flow-statements'),
+    {
+        id: 'financials.indicators',
+        command: ['financials', 'indicators'],
+        description: 'Query financial indicators for a report',
+        endpoint: '/api/a-share/financials/indicators',
+        method: 'GET',
+        inputSchema: z
+            .object({ thscode: aShareCode, report: z.string().regex(/^\d{4}-[1-4]$/u) })
+            .strict(),
+        outputSchema: z.object({ abilities: z.array(record) }).passthrough(),
+        options: [
+            {
+                flags: '--thscode <code>',
+                description: 'single A-share thscode',
+                type: 'string',
+                required: true,
+            },
+            {
+                flags: '--report <period>',
+                description: 'report quarter YYYY-[1-4]',
+                type: 'string',
+                required: true,
+            },
+        ],
+        paging: 'none',
+        window: 'none',
+    },
+    {
+        id: 'market.calendar',
+        command: ['market', 'calendar'],
+        description: 'Query the one-year A-share trading calendar',
+        endpoint: '/api/a-share/calendar/trading-days',
+        method: 'GET',
+        inputSchema: z.object({}).strict(),
+        outputSchema: itemOutput,
+        options: [],
+        paging: 'none',
+        window: 'one-year',
+    },
+    {
+        id: 'index.catalog',
+        command: ['index', 'catalog'],
+        description: 'List THS indices by category',
+        endpoint: '/api/a-share-index/catalog/ths-index-list',
+        method: 'GET',
+        inputSchema: z
+            .object({ tag: z.enum(['cn_concept', 'region', 'tszs', 'industry']).default('cn_concept') })
+            .strict(),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--tag <tag>',
+                description: 'index category',
+                type: 'string',
+                choices: ['cn_concept', 'region', 'tszs', 'industry'],
+                defaultValue: 'cn_concept',
+            },
+        ],
+        paging: 'none',
+        window: 'none',
+    },
+    {
+        id: 'index.constituents',
+        command: ['index', 'constituents'],
+        description: 'Query index constituents',
+        endpoint: '/api/a-share-index/constituents/ths-stock-list',
+        method: 'GET',
+        inputSchema: z.object({ thscode: indexCode }).strict(),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--thscode <code>',
+                description: 'single index thscode',
+                type: 'string',
+                required: true,
+            },
+        ],
+        paging: 'none',
+        window: 'none',
+    },
+    {
+        id: 'index.snapshot',
+        command: ['index', 'snapshot'],
+        description: 'Query index price snapshots',
+        endpoint: '/api/a-share-index/prices/snapshot',
+        method: 'GET',
+        inputSchema: z.object({ thscodes: commaCodes }).strict(),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--thscodes <codes>',
+                description: 'comma-separated index thscodes',
+                type: 'string',
+                required: true,
+            },
+        ],
+        paging: 'none',
+        window: 'none',
+    },
+    {
+        id: 'index.history',
+        command: ['index', 'history'],
+        description: 'Query daily index history',
+        endpoint: '/api/a-share-index/prices/historical',
+        method: 'GET',
+        inputSchema: indexHistoryInput,
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--thscode <code>',
+                description: 'single index thscode',
+                type: 'string',
+                required: true,
+            },
+            {
+                flags: '--start-ms <milliseconds>',
+                description: 'start timestamp',
+                type: 'integer',
+                required: true,
+                queryName: 'start',
+            },
+            {
+                flags: '--end-ms <milliseconds>',
+                description: 'end timestamp',
+                type: 'integer',
+                required: true,
+                queryName: 'end',
+            },
+        ],
+        paging: 'none',
+        window: 'ten-years',
+    },
+    {
+        id: 'special.limit-up-pool',
+        command: ['special', 'limit-up-pool'],
+        description: 'Query the limit-up stock pool',
+        endpoint: '/api/a-share/special-data/limit-up-pool',
+        method: 'GET',
+        inputSchema: z
+            .object({
+            dateMs: z.number().int().nonnegative().optional(),
+            page: z.number().int().min(1).default(1),
+            size: z.number().int().min(1).max(200).default(50),
+            sortField: z
+                .enum(['last_price', 'continue_day_cnt', 'seal_money', 'limit_up_time'])
+                .default('last_price'),
+            sortDir: z.enum(['asc', 'desc']).default('desc'),
+        })
+            .strict(),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--date-ms <milliseconds>',
+                description: 'trade date at Asia/Shanghai midnight',
+                type: 'integer',
+                queryName: 'date_ms',
+            },
+            { flags: '--page <number>', description: 'page number', type: 'integer', defaultValue: 1 },
+            {
+                flags: '--size <number>',
+                description: 'page size (1-200)',
+                type: 'integer',
+                defaultValue: 50,
+            },
+            {
+                flags: '--sort-field <field>',
+                description: 'sort field',
+                type: 'string',
+                choices: ['last_price', 'continue_day_cnt', 'seal_money', 'limit_up_time'],
+                defaultValue: 'last_price',
+                queryName: 'sort_field',
+            },
+            {
+                flags: '--sort-dir <direction>',
+                description: 'sort direction',
+                type: 'string',
+                choices: ['asc', 'desc'],
+                defaultValue: 'desc',
+                queryName: 'sort_dir',
+            },
+        ],
+        paging: 'page',
+        window: 'none',
+    },
+    {
+        id: 'special.limit-up-ladder',
+        command: ['special', 'limit-up-ladder'],
+        description: 'Query the 30-day limit-up ladder',
+        endpoint: '/api/a-share/special-data/limit-up-ladder',
+        method: 'GET',
+        inputSchema: z.object({}).strict(),
+        outputSchema: itemOutput,
+        options: [],
+        paging: 'none',
+        window: 'none',
+    },
+    {
+        id: 'special.anomaly-list',
+        command: ['special', 'anomaly-list'],
+        description: 'Query today-only anomaly analysis rows',
+        endpoint: '/api/a-share/special-data/anomaly-analysis-list',
+        method: 'GET',
+        inputSchema: z
+            .object({
+            tagCodes: z
+                .string()
+                .refine((value) => value
+                .split(',')
+                .every((token) => [
+                'LIMIT_UP',
+                'LIMIT_DOWN',
+                'SHARP_RISE',
+                'SHARP_FALL',
+                'RAPID_RALLY',
+                'RAPID_DECLINE',
+            ].includes(token.toUpperCase()) && token.length > 0))
+                .optional(),
+        })
+            .strict(),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--tag-codes <codes>',
+                description: 'comma-separated anomaly tags',
+                type: 'string',
+                queryName: 'tag_codes',
+            },
+        ],
+        paging: 'none',
+        window: 'today-only',
+    },
+    {
+        id: 'special.anomaly-stock',
+        command: ['special', 'anomaly-stock'],
+        description: 'Query today-only anomalies for up to 50 raw code tokens',
+        endpoint: '/api/a-share/special-data/anomaly-analysis-stock',
+        method: 'GET',
+        inputSchema: z
+            .object({
+            thscodes: z.string().superRefine((value, context) => {
+                const tokens = value.split(',');
+                if (tokens.length > 50)
+                    context.addIssue({ code: 'custom', message: 'at most 50 raw tokens' });
+                if (tokens.some((token) => !/^\d{6}\.(SH|SZ|BJ)$/iu.test(token)))
+                    context.addIssue({ code: 'custom', message: 'invalid or empty A-share token' });
+            }),
+        })
+            .strict(),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--thscodes <codes>',
+                description: '1-50 comma-separated A-share thscodes',
+                type: 'string',
+                required: true,
+            },
+        ],
+        paging: 'none',
+        window: 'today-only',
+    },
+    {
+        id: 'special.skyrocket',
+        command: ['special', 'skyrocket'],
+        description: 'Query the skyrocket ranking',
+        endpoint: '/api/a-share/special-data/skyrocket-list',
+        method: 'GET',
+        inputSchema: z.object({ period: z.enum(['day', 'hour']).default('day') }).strict(),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--period <period>',
+                description: 'ranking period',
+                type: 'string',
+                choices: ['day', 'hour'],
+                defaultValue: 'day',
+            },
+        ],
+        paging: 'none',
+        window: 'none',
+    },
+    {
+        id: 'special.hot-stock',
+        command: ['special', 'hot-stock'],
+        description: 'Query the current hot-stock ranking',
+        endpoint: '/api/a-share/special-data/hot-stock-list',
+        method: 'GET',
+        inputSchema: z.object({ period: z.enum(['day', 'hour']).default('day') }).strict(),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--period <period>',
+                description: 'ranking period',
+                type: 'string',
+                choices: ['day', 'hour'],
+                defaultValue: 'day',
+            },
+        ],
+        paging: 'none',
+        window: 'none',
+    },
+    {
+        id: 'special.hot-stock-history',
+        command: ['special', 'hot-stock-history'],
+        description: 'Query a historical hot-stock ranking',
+        endpoint: '/api/a-share/special-data/hot-stock-list-history',
+        method: 'GET',
+        inputSchema: z.object({ date: isoDate }).strict(),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--date <date>',
+                description: 'trade date YYYY-MM-DD',
+                type: 'string',
+                required: true,
+            },
+        ],
+        paging: 'none',
+        window: 'one-year',
+    },
+    {
+        id: 'special.hot-stock-trend',
+        command: ['special', 'hot-stock-trend'],
+        description: 'Query one stock hot-rank trend',
+        endpoint: '/api/a-share/special-data/hot-stock-rank-trend',
+        method: 'GET',
+        inputSchema: z
+            .object({ thscode: aShareCode, startDate: isoDate, endDate: isoDate })
+            .strict()
+            .refine((value) => value.startDate <= value.endDate, {
+            message: 'start-date must be <= end-date',
+        }),
+        outputSchema: itemOutput,
+        options: [
+            {
+                flags: '--thscode <code>',
+                description: 'single A-share thscode',
+                type: 'string',
+                required: true,
+            },
+            {
+                flags: '--start-date <date>',
+                description: 'start date YYYY-MM-DD',
+                type: 'string',
+                required: true,
+                queryName: 'start_date',
+            },
+            {
+                flags: '--end-date <date>',
+                description: 'end date YYYY-MM-DD',
+                type: 'string',
+                required: true,
+                queryName: 'end_date',
+            },
+        ],
+        paging: 'none',
+        window: 'one-year',
+    },
+    {
+        id: 'special.dragon-tiger',
+        command: ['special', 'dragon-tiger'],
+        description: 'Query dragon-tiger board records',
+        endpoint: '/api/a-share/special-data/dragon-tiger-list',
+        method: 'GET',
+        inputSchema: z
+            .object({
+            boardType: z.enum(['all', 'org', 'hot_money']).default('all'),
+            date: isoDate.optional(),
+        })
+            .strict(),
+        outputSchema: objectOutput,
+        options: [
+            {
+                flags: '--board-type <type>',
+                description: 'board category',
+                type: 'string',
+                choices: ['all', 'org', 'hot_money'],
+                defaultValue: 'all',
+                queryName: 'board_type',
+            },
+            { flags: '--date <date>', description: 'optional trade date YYYY-MM-DD', type: 'string' },
+        ],
+        paging: 'none',
+        window: 'one-year',
+    },
+];
+//# sourceMappingURL=remote-capabilities.js.map

package/dist/domains/financials/types.d.ts

@@ -0,0 +1,6 @@
+export interface FinancialRecord {
+    thscode?: string;
+    period_end_ms?: number;
+    [field: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/domains/financials/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/domains/index/types.d.ts

@@ -0,0 +1,6 @@
+export interface IndexRecord {
+    thscode: string;
+    name?: string;
+    [field: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/domains/index/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/domains/market/types.d.ts

@@ -0,0 +1,6 @@
+export interface MarketBar {
+    thscode?: string;
+    date_ms?: number;
+    [field: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map