stock-sdk 1.0.0

package/dist/types.d.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[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/new-doc.md

@@ -0,0 +1,98 @@
+# qt.gtimg.cn 接口验证版（2025-12-10）
+
+> 本文基于实际请求 `qt.gtimg.cn`（2025-12-10 14:43 CST）验证所得，均为 GBK 编码返回，需先 GBK/GB2312 解码后再解析。所有示例均为实时数据，数值会随时间变化。
+
+## 通用说明
+- 请求：`GET http://qt.gtimg.cn/q=<参数串>`，多个标的用英文逗号`,`拼接。
+- 返回：若成功，为若干行 `v_<query>="字段~字段~..."`，字段以 `~` 分隔，行以 `;` 结束。
+- 解析建议：按 `;` 拆行 → 去掉前缀 `v_`、两端引号 → 按 `~` 拆字段；不同前缀对应不同字段布局。
+
+## 接口验证与修正
+
+### 1) 实时全量行情 `q=<market><code>`
+- 示例：`http://qt.gtimg.cn/q=sz000858`
+- 返回示例：
+  ```
+  v_sz000858="51~五 粮 液~000858~111.70~110.88~110.50~167220~88174~79034~111.69~57~111.68~190~...~20251210144239~0.82~0.74~111.75~109.51~111.70/167220/1856027539~167220~185603~0.43~15.25~~111.75~109.51~..."
+  ```
+- 已确认字段位置（仅列常用）：
+  - 0 市场标识；1 名称；2 代码
+  - 3 最新价；4 昨收；5 今开
+  - 6 成交量(手)；7 外盘；8 内盘
+  - 9–18 买一~买五价及量；19–28 卖一~卖五价及量
+  - 30 时间戳 `yyyyMMddHHmmss`
+  - 31 涨跌额；32 涨跌幅%
+  - 33 最高；34 最低
+  - 35 价格/成交量/成交额组合字段 `现价/量/额`
+  - 36 成交量(手)；37 成交额(万)
+  - 44 流通市值；45 总市值；46 市净率；47 涨停价；48 跌停价
+- 结论：与原文档描述基本一致，确认保留。
+
+### 2) 简要行情 `q=s_<market><code>`
+- 示例：`http://qt.gtimg.cn/q=s_sz000858`
+- 返回示例：`v_s_sz000858="51~五 粮 液~000858~111.69~0.81~0.73~167222~185605~~4335.37~GP-A";`
+- 字段顺序修正（对照原文档）：
+  - 0 市场标识；1 名称；2 代码；3 最新价
+  - 4 涨跌额；5 涨跌幅%
+  - 6 成交量(手)；7 成交额(万)
+  - 8、9 为空；10 可能为总市值(亿)；11 市场类型标识
+- 结论：原文档“8+ 其他”过于笼统，此处补充实际位置。
+
+### 3) 资金流向 `q=ff_<market><code>`
+- 示例：`http://qt.gtimg.cn/q=ff_sz000858`
+- 返回示例：`v_ff_sz000858="sz000858~0.00~0.00~0.00~0~0.00~0.00~0.00~0~0.00~98032.62~81719.27~五粮液~20200701~20191218^30622.71^18574.01~...~20200701085013";`
+- 字段修正：
+  - 0 代码；1 主力流入；2 主力流出；3 主力净流入；4 主力净流入占比
+  - 5 散户流入；6 散户流出；7 散户净流入；8 散户净流入占比
+  - 9 总资金流；10 日主力累计；11 日散户累计
+  - 12 名称；13 最新日期
+  - 14 以后为历史记录，形如 `YYYYMMDD^主力^散户`
+- 结论：与原文档字段描述一致，但补充了 10、11、14+ 的含义。
+
+### 4) 盘口大单占比 `q=s_pk<market><code>`
+- 示例：`http://qt.gtimg.cn/q=s_pksz000858`
+- 返回示例：`v_s_pksz000858="0.260~0.247~0.259~0.234";`
+- 字段：0 买盘大单占比；1 买盘小单占比；2 卖盘大单占比；3 卖盘小单占比
+- 结论：与原文档一致。
+
+### 5) 港股扩展行情 `q=r_hk<code>`
+- 示例：`http://qt.gtimg.cn/q=r_hk09988`
+- 返回示例（节选）：`v_r_hk09988="100~阿里巴巴-W~09988~152.800~150.900~150.500~44409902.0~...~2025/12/10 14:42:41~1.900~1.26~153.400~149.600~152.800~44409902.0~6732214501.100~...~HKD~1~30";`
+- 关键字段（实测）：
+  - 0 市场标识 100；1 名称；2 代码；3 最新价；4 昨收；5 今开
+  - 6 成交量(股)；30 时间 `YYYY/MM/DD HH:MM:SS`
+  - 31 涨跌额；32 涨跌幅%；33 最高；34 最低
+  - 36 成交额；40 每手股数；46 流通市值；47 总市值；尾部货币/精度等
+- 结论：原文档仅笼统描述，现补充关键字段与时间格式。
+
+### 6) 美股简要行情 `q=s_us<code>`
+- 示例：`http://qt.gtimg.cn/q=s_usBABA`
+- 返回示例：`v_s_usBABA="200~阿里巴巴~BABA.N~155.96~-2.17~-1.37~6458051~1005193830~3721.26216~";`
+- 字段顺序（实测）：
+  - 0 市场标识 200；1 名称；2 代码；3 最新价
+  - 4 涨跌额；5 涨跌幅%；6 成交量(股)；7 成交额
+  - 8 总市值(亿)；9 预留/空
+- 结论：补充了成交额、总市值的位置。
+
+### 7) 公募基金行情 `q=jj<六位代码>`
+- 示例：`http://qt.gtimg.cn/q=jj000001`
+- 返回示例：`v_jj000001="000001~华夏成长混合~0.0000~0.0000~~1.0590~3.6320~0.0945~2025-12-09~";`
+- 实测字段：
+  - 0 基金代码；1 名称
+  - 2、3 旧净值位（多数为 0）；4 为空
+  - 5 最新单位净值；6 累计净值；7 当日涨跌额；8 净值日期
+- 结论：原文档未给出具体索引，此处补齐。
+
+### 8) 指数简要行情 `q=s_<market><index>`
+- 示例：`http://qt.gtimg.cn/q=s_sh000001`
+- 返回示例：`v_s_sh000001="1~上证指数~000001~3902.76~-6.76~-0.17~457931830~67455017~~634972.69~ZS";`
+- 字段顺序（与股票简要类似）：
+  - 0 市场标识；1 名称；2 代码；3 指数点位
+  - 4 涨跌点；5 涨跌幅%；6 成交量(手)；7 成交额(万)
+  - 8、9 空；10 总市值或成交额扩展；11 市场/类型标识
+- 结论：补充了指数简要的字段位置说明。
+
+## 结论
+- 原文档总体方向正确，但简要行情、资金流向、港股扩展、美股简要、基金、指数简要的字段位置需按上表修正。
+- 所有接口均确认可多标的逗号批量查询，返回顺序与请求顺序一致。
+