stock-sdk 1.0.0

package/src/index.ts

@@ -0,0 +1,281 @@
+import axios, { AxiosInstance } from 'axios';
+import * as iconv from 'iconv-lite';
+import {
+  FullQuote,
+  SimpleQuote,
+  FundFlow,
+  PanelLargeOrder,
+  HKQuote,
+  USQuote,
+  FundQuote,
+} from './types';
+
+export * from './types';
+
+const BASE_URL = 'http://qt.gtimg.cn';
+
+function safeNumber(val: string | undefined): number {
+  if (!val || val === '') return 0;
+  const n = parseFloat(val);
+  return Number.isNaN(n) ? 0 : n;
+}
+
+function safeNumberOrNull(val: string | undefined): number | null {
+  if (!val || val === '') return null;
+  const n = parseFloat(val);
+  return Number.isNaN(n) ? null : n;
+}
+
+/**
+ * 解析响应文本，按 `;` 拆行，提取 `v_xxx="..."` 里的内容，返回 { key, fields }[]
+ */
+function parseResponse(text: string): { key: string; fields: string[] }[] {
+  const lines = text.split(';').map((l) => l.trim()).filter(Boolean);
+  const results: { key: string; fields: string[] }[] = [];
+  for (const line of lines) {
+    const eqIdx = line.indexOf('=');
+    if (eqIdx < 0) continue;
+    let key = line.slice(0, eqIdx).trim();
+    if (key.startsWith('v_')) key = key.slice(2);
+    let raw = line.slice(eqIdx + 1).trim();
+    if (raw.startsWith('"') && raw.endsWith('"')) {
+      raw = raw.slice(1, -1);
+    }
+    const fields = raw.split('~');
+    results.push({ key, fields });
+  }
+  return results;
+}
+
+export class TencentStockSDK {
+  private client: AxiosInstance;
+
+  constructor() {
+    this.client = axios.create({
+      baseURL: BASE_URL,
+      responseType: 'arraybuffer',
+      timeout: 10000,
+    });
+  }
+
+  private async fetch(params: string): Promise<{ key: string; fields: string[] }[]> {
+    const resp = await this.client.get('/', { params: { q: params } });
+    const text = iconv.decode(Buffer.from(resp.data), 'gbk');
+    return parseResponse(text);
+  }
+
+  // ---------- 实时全量行情 ----------
+  /**
+   * 获取 A 股 / 指数 全量行情
+   * @param codes 如 ['sz000858', 'sh600000']
+   */
+  async getFullQuotes(codes: string[]): Promise<FullQuote[]> {
+    const data = await this.fetch(codes.join(','));
+    return data.map((d) => this.parseFullQuote(d.fields));
+  }
+
+  private parseFullQuote(f: string[]): FullQuote {
+    const bid: { price: number; volume: number }[] = [];
+    for (let i = 0; i < 5; i++) {
+      bid.push({ price: safeNumber(f[9 + i * 2]), volume: safeNumber(f[10 + i * 2]) });
+    }
+    const ask: { price: number; volume: number }[] = [];
+    for (let i = 0; i < 5; i++) {
+      ask.push({ price: safeNumber(f[19 + i * 2]), volume: safeNumber(f[20 + i * 2]) });
+    }
+    return {
+      marketId: f[0] ?? '',
+      name: f[1] ?? '',
+      code: f[2] ?? '',
+      price: safeNumber(f[3]),
+      prevClose: safeNumber(f[4]),
+      open: safeNumber(f[5]),
+      volume: safeNumber(f[6]),
+      outerVolume: safeNumber(f[7]),
+      innerVolume: safeNumber(f[8]),
+      bid,
+      ask,
+      time: f[30] ?? '',
+      change: safeNumber(f[31]),
+      changePercent: safeNumber(f[32]),
+      high: safeNumber(f[33]),
+      low: safeNumber(f[34]),
+      volume2: safeNumber(f[36]),
+      amount: safeNumber(f[37]),
+      turnoverRate: safeNumberOrNull(f[38]),
+      pe: safeNumberOrNull(f[39]),
+      circulatingMarketCap: safeNumberOrNull(f[44]),
+      totalMarketCap: safeNumberOrNull(f[45]),
+      pb: safeNumberOrNull(f[46]),
+      limitUp: safeNumberOrNull(f[47]),
+      limitDown: safeNumberOrNull(f[48]),
+      raw: f,
+    };
+  }
+
+  // ---------- 简要行情 ----------
+  /**
+   * 获取简要行情
+   * @param codes 如 ['s_sz000858', 's_sh000001']
+   */
+  async getSimpleQuotes(codes: string[]): Promise<SimpleQuote[]> {
+    const data = await this.fetch(codes.join(','));
+    return data.map((d) => this.parseSimpleQuote(d.fields));
+  }
+
+  private parseSimpleQuote(f: string[]): SimpleQuote {
+    return {
+      marketId: f[0] ?? '',
+      name: f[1] ?? '',
+      code: f[2] ?? '',
+      price: safeNumber(f[3]),
+      change: safeNumber(f[4]),
+      changePercent: safeNumber(f[5]),
+      volume: safeNumber(f[6]),
+      amount: safeNumber(f[7]),
+      marketCap: safeNumberOrNull(f[9]),
+      marketType: f[10] ?? '',
+      raw: f,
+    };
+  }
+
+  // ---------- 资金流向 ----------
+  /**
+   * 获取资金流向
+   * @param codes 如 ['ff_sz000858']
+   */
+  async getFundFlow(codes: string[]): Promise<FundFlow[]> {
+    const data = await this.fetch(codes.join(','));
+    return data.map((d) => this.parseFundFlow(d.fields));
+  }
+
+  private parseFundFlow(f: string[]): FundFlow {
+    return {
+      code: f[0] ?? '',
+      mainInflow: safeNumber(f[1]),
+      mainOutflow: safeNumber(f[2]),
+      mainNet: safeNumber(f[3]),
+      mainNetRatio: safeNumber(f[4]),
+      retailInflow: safeNumber(f[5]),
+      retailOutflow: safeNumber(f[6]),
+      retailNet: safeNumber(f[7]),
+      retailNetRatio: safeNumber(f[8]),
+      totalFlow: safeNumber(f[9]),
+      name: f[12] ?? '',
+      date: f[13] ?? '',
+      raw: f,
+    };
+  }
+
+  // ---------- 盘口大单占比 ----------
+  /**
+   * 获取盘口大单占比
+   * @param codes 如 ['s_pksz000858']
+   */
+  async getPanelLargeOrder(codes: string[]): Promise<PanelLargeOrder[]> {
+    const data = await this.fetch(codes.join(','));
+    return data.map((d) => this.parsePanelLargeOrder(d.fields));
+  }
+
+  private parsePanelLargeOrder(f: string[]): PanelLargeOrder {
+    return {
+      buyLargeRatio: safeNumber(f[0]),
+      buySmallRatio: safeNumber(f[1]),
+      sellLargeRatio: safeNumber(f[2]),
+      sellSmallRatio: safeNumber(f[3]),
+      raw: f,
+    };
+  }
+
+  // ---------- 港股扩展行情 ----------
+  /**
+   * 获取港股扩展行情
+   * @param codes 如 ['r_hk09988']
+   */
+  async getHKQuotes(codes: string[]): Promise<HKQuote[]> {
+    const data = await this.fetch(codes.join(','));
+    return data.map((d) => this.parseHKQuote(d.fields));
+  }
+
+  private parseHKQuote(f: string[]): HKQuote {
+    return {
+      marketId: f[0] ?? '',
+      name: f[1] ?? '',
+      code: f[2] ?? '',
+      price: safeNumber(f[3]),
+      prevClose: safeNumber(f[4]),
+      open: safeNumber(f[5]),
+      volume: safeNumber(f[6]),
+      time: f[30] ?? '',
+      change: safeNumber(f[31]),
+      changePercent: safeNumber(f[32]),
+      high: safeNumber(f[33]),
+      low: safeNumber(f[34]),
+      amount: safeNumber(f[36]),
+      lotSize: safeNumberOrNull(f[40]),
+      circulatingMarketCap: safeNumberOrNull(f[46]),
+      totalMarketCap: safeNumberOrNull(f[47]),
+      currency: f[f.length - 3] ?? '',
+      raw: f,
+    };
+  }
+
+  // ---------- 美股简要行情 ----------
+  /**
+   * 获取美股简要行情
+   * @param codes 如 ['s_usBABA']
+   */
+  async getUSQuotes(codes: string[]): Promise<USQuote[]> {
+    const data = await this.fetch(codes.join(','));
+    return data.map((d) => this.parseUSQuote(d.fields));
+  }
+
+  private parseUSQuote(f: string[]): USQuote {
+    return {
+      marketId: f[0] ?? '',
+      name: f[1] ?? '',
+      code: f[2] ?? '',
+      price: safeNumber(f[3]),
+      change: safeNumber(f[4]),
+      changePercent: safeNumber(f[5]),
+      volume: safeNumber(f[6]),
+      amount: safeNumber(f[7]),
+      marketCap: safeNumberOrNull(f[8]),
+      raw: f,
+    };
+  }
+
+  // ---------- 公募基金行情 ----------
+  /**
+   * 获取公募基金行情
+   * @param codes 如 ['jj000001']
+   */
+  async getFundQuotes(codes: string[]): Promise<FundQuote[]> {
+    const data = await this.fetch(codes.join(','));
+    return data.map((d) => this.parseFundQuote(d.fields));
+  }
+
+  private parseFundQuote(f: string[]): FundQuote {
+    return {
+      code: f[0] ?? '',
+      name: f[1] ?? '',
+      nav: safeNumber(f[5]),
+      accNav: safeNumber(f[6]),
+      change: safeNumber(f[7]),
+      navDate: f[8] ?? '',
+      raw: f,
+    };
+  }
+
+  // ---------- 批量混合查询 ----------
+  /**
+   * 批量混合查询，返回原始解析结果（key + fields）
+   * @param params 如 'sz000858,s_sh000001,jj000001'
+   */
+  async batchRaw(params: string): Promise<{ key: string; fields: string[] }[]> {
+    return this.fetch(params);
+  }
+}
+
+export default TencentStockSDK;
+

package/src/types.ts

@@ -0,0 +1,177 @@
+/**
+ * A 股 / 指数 全量行情
+ */
+export interface FullQuote {
+  /** 市场标识 */
+  marketId: string;
+  /** 名称 */
+  name: string;
+  /** 股票代码 */
+  code: string;
+  /** 最新价 */
+  price: number;
+  /** 昨收 */
+  prevClose: number;
+  /** 今开 */
+  open: number;
+  /** 成交量(手) */
+  volume: number;
+  /** 外盘 */
+  outerVolume: number;
+  /** 内盘 */
+  innerVolume: number;
+  /** 买一~买五 { price, volume }[] */
+  bid: { price: number; volume: number }[];
+  /** 卖一~卖五 { price, volume }[] */
+  ask: { price: number; volume: number }[];
+  /** 时间戳 yyyyMMddHHmmss */
+  time: string;
+  /** 涨跌额 */
+  change: number;
+  /** 涨跌幅% */
+  changePercent: number;
+  /** 最高 */
+  high: number;
+  /** 最低 */
+  low: number;
+  /** 成交量(手) (字段36) */
+  volume2: number;
+  /** 成交额(万) */
+  amount: number;
+  /** 换手率% */
+  turnoverRate: number | null;
+  /** 市盈率 */
+  pe: number | null;
+  /** 流通市值(亿) */
+  circulatingMarketCap: number | null;
+  /** 总市值(亿) */
+  totalMarketCap: number | null;
+  /** 市净率 */
+  pb: number | null;
+  /** 涨停价 */
+  limitUp: number | null;
+  /** 跌停价 */
+  limitDown: number | null;
+  /** 原始字段数组(供扩展使用) */
+  raw: string[];
+}
+
+/**
+ * 简要行情（股票 / 指数）
+ */
+export interface SimpleQuote {
+  marketId: string;
+  name: string;
+  code: string;
+  price: number;
+  change: number;
+  changePercent: number;
+  volume: number;
+  amount: number;
+  /** 总市值(亿) */
+  marketCap: number | null;
+  /** 市场类型标识 如 GP-A / ZS */
+  marketType: string;
+  raw: string[];
+}
+
+/**
+ * 资金流向
+ */
+export interface FundFlow {
+  code: string;
+  /** 主力流入 */
+  mainInflow: number;
+  /** 主力流出 */
+  mainOutflow: number;
+  /** 主力净流入 */
+  mainNet: number;
+  /** 主力净流入占比 */
+  mainNetRatio: number;
+  /** 散户流入 */
+  retailInflow: number;
+  /** 散户流出 */
+  retailOutflow: number;
+  /** 散户净流入 */
+  retailNet: number;
+  /** 散户净流入占比 */
+  retailNetRatio: number;
+  /** 总资金流 */
+  totalFlow: number;
+  name: string;
+  date: string;
+  raw: string[];
+}
+
+/**
+ * 盘口大单占比
+ */
+export interface PanelLargeOrder {
+  /** 买盘大单占比 */
+  buyLargeRatio: number;
+  /** 买盘小单占比 */
+  buySmallRatio: number;
+  /** 卖盘大单占比 */
+  sellLargeRatio: number;
+  /** 卖盘小单占比 */
+  sellSmallRatio: number;
+  raw: string[];
+}
+
+/**
+ * 港股扩展行情
+ */
+export interface HKQuote {
+  marketId: string;
+  name: string;
+  code: string;
+  price: number;
+  prevClose: number;
+  open: number;
+  volume: number;
+  time: string;
+  change: number;
+  changePercent: number;
+  high: number;
+  low: number;
+  amount: number;
+  lotSize: number | null;
+  circulatingMarketCap: number | null;
+  totalMarketCap: number | null;
+  currency: string;
+  raw: string[];
+}
+
+/**
+ * 美股简要行情
+ */
+export interface USQuote {
+  marketId: string;
+  name: string;
+  code: string;
+  price: number;
+  change: number;
+  changePercent: number;
+  volume: number;
+  amount: number;
+  marketCap: number | null;
+  raw: string[];
+}
+
+/**
+ * 公募基金行情
+ */
+export interface FundQuote {
+  code: string;
+  name: string;
+  /** 最新单位净值 */
+  nav: number;
+  /** 累计净值 */
+  accNav: number;
+  /** 当日涨跌额 */
+  change: number;
+  /** 净值日期 */
+  navDate: string;
+  raw: string[];
+}
+

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "lib": ["ES2020"],
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "node"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}
+

package/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    testTimeout: 15000,
+  },
+});
+