gangtise-openapi-cli 0.13.0 → 0.14.0

package/README.md

@@ -4,6 +4,16 @@
 
 ## Changelog
 
+### v0.14.0 — 2026-05-22
+
+**新增接口**
+- `quote realtime` — 个股实时行情快照，单接口同时覆盖 A 股 / 港股 / 美股；支持代码混合传入或市场关键字（`aShares` / `hkStocks` / `usStocks`）批量查询全市场
+- `quote day-kline-us` — 美股历史日 K 线，数据范围 NYSE / NASDAQ / AMEX；支持 `--security all` 全市场（CLI 自动按 2 天/片切分并发拉取）
+
+**接口变更**
+- `quote day-kline` / `quote day-kline-hk` 明确仅返回**历史**日 K 线，不包含盘中实时数据；当日数据入库时间：A 股 ~15:30 / 港股 ~16:30（北京时间）。盘中实时请走 `quote realtime`
+- `fundamental valuation-analysis` 返回字段移除 `p10` / `p25` / `p75` / `p90`（仍保留 `value` / `percentileRank` / `average` / `median` / `upper1Std` / `lower1Std`）
+
 ### v0.13.0 — 2026-05-15
 
 **新增接口**
@@ -129,11 +139,12 @@ gangtise-openapi/
 └── references/
     ├── commands/                     # 按命令组拆分的详细参数文档（agent 按需 Read）
     │   ├── ai.md                     #   AI 能力命令（one-pager / earnings-review / viewpoint-debate 等）
-    │   ├── fundamental.md            #   财务数据命令（三大报表 / 估值 / 盈利预测 / 股东）
+    │   ├── alternative.md            #   行业指标数据库（EDB search / EDB data）
+    │   ├── fundamental.md            #   财务数据命令（A股/港股三大报表 / 估值 / 盈利预测 / 股东）
     │   ├── insight.md                #   投研内容命令（研报 / 观点 / 纪要 / 公告 / 外资）
     │   ├── quote.md                  #   行情命令（A股/港股/指数 K 线）
     │   ├── reference-and-lookup.md   #   GTS Code 搜索与枚举速查
-    │   └── vault.md                  #   云盘/录音/会议/群消息
+    │   └── vault.md                  #   云盘/录音/会议/群消息/股票池
     ├── examples.md                   # 典型场景的端到端示例
     ├── fields.md                     # K线/财务字段中英文对照速查表
     ├── lookup-ids.md                 # 常用 ID 速查表（行业/券商/机构/公告分类等）
@@ -186,11 +197,13 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 | | `foreign-opinion list` | 外资机构观点 |
 | | `independent-opinion list` / `download` | 外资独立分析师观点（含原文/翻译HTML下载） |
 | **Reference** | `securities-search` | GTS Code 搜索（按名称/代码/拼音匹配） |
-| **Quote** | `day-kline` / `day-kline-hk` | A股/港股日K线 |
+| **Quote** | `day-kline` / `day-kline-hk` / `day-kline-us` | A股/港股/美股历史日K线 |
 | | `index-day-kline` | 沪深京指数日K线 |
 | | `minute-kline` | A股分钟K线 |
-| **Fundamental** | `income-statement` / `balance-sheet` / `cash-flow` | 三大财务报表（累计） |
-| | `income-statement-quarterly` / `cash-flow-quarterly` | 利润表/现金流量表（单季度） |
+| | `realtime` | 个股实时行情快照（A股/港股/美股） |
+| **Fundamental** | `income-statement` / `balance-sheet` / `cash-flow` | A股三大财务报表（累计） |
+| | `income-statement-quarterly` / `cash-flow-quarterly` | A股利润表/现金流量表（单季度） |
+| | `income-statement-hk` / `balance-sheet-hk` / `cash-flow-hk` | 港股三大财务报表（中国会计准则） |
 | | `main-business` | 主营构成（按地区/产品拆分） |
 | | `valuation-analysis` | 估值分析 |
 | | `earning-forecast` | 盈利预测（一致预期） |
@@ -212,6 +225,9 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 | | `record-list` / `record-download` | 录音速记列表与下载 |
 | | `my-conference-list` / `my-conference-download` | 我的会议列表与下载 |
 | | `wechat-message-list` / `wechat-chatroom-list` | 群消息列表与群ID查询 |
+| | `stock-pool-list` / `stock-pool-stocks` | 自选股股票池列表与证券明细 |
+| **Alternative** | `edb-search` | 行业指标搜索（按关键词匹配，返回 indicatorId 等元信息） |
+| | `edb-data` | 行业指标时序数据（批量拉取，最多10个指标） |
 | **Raw** | `call` | 原始接口调用（可访问任意 endpoint） |
 
 ## 命令概览
@@ -223,6 +239,7 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 - `gangtise fundamental ...`
 - `gangtise ai ...`
 - `gangtise vault ...`
+- `gangtise alternative ...`
 - `gangtise reference ...`
 - `gangtise raw call ...`
 
@@ -257,7 +274,7 @@ gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
 - **流式输出**：`jsonl`/`csv` 格式且 `--output` 指定时，超过 1000 行自动切换为逐行写盘，避免一次性构建百 MB 字符串。
 - **自动重试**：5xx / `ECONNRESET` / `ETIMEDOUT` / `999999` 系统错误自动指数退避重试 2 次。
 - **Token 自愈**：调用返回 8000014/8000015 时自动强制刷新 Token 并重试一次。
-- **K线自动分片**：`quote day-kline --security all` 等全市场查询自动按日期切分（A股 2 天/片、HK 3 天/片、指数 30 天/片），并发执行后合并结果。
+- **K线自动分片**：`quote day-kline --security all` 等全市场查询自动按日期切分（A股 / 美股 2 天/片、HK 3 天/片、指数 30 天/片），并发执行后合并结果。
 - **Token 内存缓存**：Token 在进程内存中缓存，避免每次请求读盘。
 - **`--verbose`**：打印每个请求的方法、路径、状态码、耗时和响应大小到 stderr，方便定位慢查询。
 
@@ -379,12 +396,22 @@ gangtise quote day-kline --security all --start-date 2026-04-01 --end-date 2026-
 gangtise quote day-kline-hk --security 00700.HK --start-date 2026-03-01 --end-date 2026-03-31
 # 港股全市场
 gangtise quote day-kline-hk --security all --start-date 2026-04-01 --end-date 2026-04-01 --limit 100 --format json
+# 美股日K线（NASDAQ/NYSE/AMEX，历史）
+gangtise quote day-kline-us --security AAPL.O --security MSFT.O --start-date 2026-04-22 --end-date 2026-05-22 --field tradeDate --field open --field close --field volume
+# 美股全市场（自动分片）
+gangtise quote day-kline-us --security all --start-date 2026-04-01 --end-date 2026-04-02 --field securityCode --field close --format json
 # 沪深京指数日K线
 gangtise quote index-day-kline --security 000001.SH --security 399001.SZ --start-date 2024-05-01 --end-date 2024-05-20 --field securityCode --field tradeDate --field close --field volume
 # A股分钟K线
 gangtise quote minute-kline --security 600519.SH --start-time "2026-04-15 09:30:00" --end-time "2026-04-15 15:00:00" --field open --field close --field volume
+# 实时行情：三大市场混合查询
+gangtise quote realtime --security 600519.SH --security 00700.HK --security AAPL.O --field securityCode --field tradeTime --field latestPrice --field pctChange --field volume --format json
+# 实时行情：全市场批量（建议配合 --field 精简字段）
+gangtise quote realtime --security aShares --field securityCode --field latestPrice --field pctChange --field volume --format json
 ```
 
+> **历史 vs 实时**：`day-kline*` 仅返回历史数据（当日数据入库时间：A 股 ~15:30 / 港股 ~16:30 / 美股 ~07:00 北京时间）。盘中需要最新成交价、振幅等实时字段必须走 `quote realtime`。
+
 ### Fundamental
 
 ```bash
@@ -413,6 +440,14 @@ gangtise fundamental cash-flow-quarterly --security-code 600519.SH --fiscal-year
 gangtise fundamental top-holders --security-code 600519.SH --holder-type top10 --fiscal-year 2025 --format json
 # 前十大流通股东（按日期范围）
 gangtise fundamental top-holders --security-code 600519.SH --holder-type top10Float --start-date 2025-01-01 --end-date 2025-12-31 --period q3 --format json
+
+# 港股三大报表（中国会计准则，--security-code 用港股代码）
+gangtise fundamental income-statement-hk --security-code 09992.HK --fiscal-year 2025 --period annual --field netProfit --field basicEPS
+gangtise fundamental income-statement-hk --security-code 09992.HK --fiscal-year 2023 --fiscal-year 2024 --fiscal-year 2025 --period annual --field netProfit
+gangtise fundamental balance-sheet-hk --security-code 09992.HK --fiscal-year 2025 --period h1 --field totalCurrAssets --field totalNonCurrAssets --field totalCurrLiab --field totalNonCurrLiab
+gangtise fundamental cash-flow-hk --security-code 09992.HK --fiscal-year 2025 --period annual --field netOpCashFlows --field netInvCashFlows --field netFinCashFlows
+# 最新一期完整港股利润表
+gangtise fundamental income-statement-hk --security-code 09992.HK --format json
 ```
 
 ### AI
@@ -431,8 +466,11 @@ gangtise ai hot-topic --start-date 2026-03-22 --end-date 2026-03-27 --category m
 # 不传 --category 默认查全部类型（早报+午报+盘中快报+晚报），--with-related-securities 和 --with-close-reading 默认开启，可用 --no-with-related-securities / --no-with-close-reading 关闭
 gangtise ai hot-topic --start-date 2026-04-15 --end-date 2026-04-17
 gangtise ai research-outline --security-code 600519.SH
-# 管理层讨论-财报
+# 管理层讨论-财报（三个细分维度）
 gangtise ai management-discuss-announcement --report-date 2025-06-30 --security-code 000001.SZ --dimension businessOperation
+gangtise ai management-discuss-announcement --report-date 2025-12-31 --security-code 000001.SZ --dimension financialPerformance
+# 传入 all 返回完整管理层讨论内容（内容较长，谨慎使用）
+gangtise ai management-discuss-announcement --report-date 2025-12-31 --security-code 000001.SZ --dimension all
 # 管理层讨论-业绩会
 gangtise ai management-discuss-earnings-call --report-date 2025-06-30 --security-code 000001.SZ --dimension financialPerformance
 # 观点PK（异步，返回 dataId）
@@ -466,6 +504,39 @@ gangtise vault my-conference-download --conference-id 43319 --content-type asr
 # 群消息：先按群名称查群ID，再按群ID查消息
 gangtise vault wechat-chatroom-list --room-name "AI学习群,投研分享群" --size 50
 gangtise vault wechat-message-list --keyword AI应用 --wechat-group-id ueKEGyhdjFGkjyebh --category text --category url --tag roadShow --tag meetingSummary --size 50
+# 按证券代码过滤群消息
+gangtise vault wechat-message-list --security 000001.SZ --security 300750.SZ --size 50
+
+# 自选股股票池
+gangtise vault stock-pool-list
+# 查询指定股票池中的证券
+gangtise vault stock-pool-stocks --pool-id 808477293
+# 查询所有股票池中的全量证券（默认行为）
+gangtise vault stock-pool-stocks
+```
+
+### Alternative（行业指标数据库 EDB）
+
+```bash
+# Step 1：按关键词搜索指标，获取 indicatorId
+gangtise alternative edb-search --keyword 空调 --limit 50 --format table
+gangtise alternative edb-search --keyword "海尔销量"
+
+# Step 2：按 indicatorId 拉取时间序列数据（最多10个指标）
+gangtise alternative edb-data \
+  --indicator-id S14001618 \
+  --indicator-id S14001620 \
+  --start-date 2024-01-01 \
+  --end-date 2024-12-31 \
+  --format table
+
+# 导出为 CSV
+gangtise alternative edb-data \
+  --indicator-id S14001618 \
+  --start-date 2023-01-01 \
+  --end-date 2024-12-31 \
+  --format csv \
+  --output ./indicator.csv
 ```
 
 ### Raw

package/dist/src/cli.js

@@ -284,6 +284,10 @@ quote.command("day-kline-hk").option("--security <code>", "Security code (HK sto
     const client = await createClient();
     await printData(await callKlineWithSharding(client, "quote.day-kline-hk", buildQuoteKlineBody(options), { shardDays: 3 }), parseOutputFormat(options.format), options.output);
 });
+quote.command("day-kline-us").option("--security <code>", "Security code (US stock: e.g. AAPL.O, or 'all' for full market)", collectList, []).option("--start-date <date>", "Start date (default: 1 year before end-date)").option("--end-date <date>", "End date (default: latest)").option("--limit <number>", "Max rows per request (default: 6000, max: 10000)").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await callKlineWithSharding(client, "quote.day-kline-us", buildQuoteKlineBody(options), { shardDays: 2 }), parseOutputFormat(options.format), options.output);
+});
 quote.command("index-day-kline").option("--security <code>", "Index code (.SH/.SZ/.BJ, or 'all' for full market)", collectList, []).option("--start-date <date>", "Start date (default: 1 year before end-date)").option("--end-date <date>", "End date (default: latest)").option("--limit <number>", "Max rows per request (default: 6000, max: 10000)").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
     const client = await createClient();
     await printData(await callKlineWithSharding(client, "quote.index-day-kline", buildQuoteKlineBody(options), { shardDays: 30 }), parseOutputFormat(options.format), options.output);
@@ -292,6 +296,10 @@ quote.command("minute-kline").option("--security <code>", "Security code (A-shar
     const client = await createClient();
     await printData(await client.call("quote.minute-kline", { securityCode: options.security, startTime: options.startTime, endTime: options.endTime, limit: parseOptionalNumberOption(options.limit, "--limit", { integer: true, min: 1 }), fieldList: maybeArray(options.field) }), parseOutputFormat(options.format), options.output);
 });
+quote.command("realtime").description("Realtime quote snapshot (A-share / HK / US)").option("--security <code>", "Security code (e.g. 600519.SH / 00700.HK / AAPL.O), or market keyword: aShares / hkStocks / usStocks", collectList, []).option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("quote.realtime", { securityList: maybeArray(options.security), fieldList: maybeArray(options.field) }), parseOutputFormat(options.format), options.output);
+});
 program.addCommand(quote);
 const fundamental = new Command("fundamental").description("Fundamental APIs");
 const addFinancialReport = (name, endpointKey, periodHelp = "Period") => fundamental.command(name).requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").option("--fiscal-year <year>", "Fiscal year", collectList, []).option("--period <period>", periodHelp, collectList, []).option("--report-type <type>", "Report type", collectList, []).option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {

package/dist/src/core/endpoints.js

@@ -217,14 +217,21 @@ export const ENDPOINTS = {
         method: "POST",
         path: "/application/open-quote/kline/daily",
         kind: "json",
-        description: "Query A-share daily kline (SH/SZ/BJ)",
+        description: "Query A-share historical daily kline (SH/SZ/BJ)",
     },
     "quote.day-kline-hk": {
         key: "quote.day-kline-hk",
         method: "POST",
         path: "/application/open-quote/kline-hk/daily",
         kind: "json",
-        description: "Query HK stock daily kline (HK)",
+        description: "Query HK stock historical daily kline (HK)",
+    },
+    "quote.day-kline-us": {
+        key: "quote.day-kline-us",
+        method: "POST",
+        path: "/application/open-quote/kline-us/daily",
+        kind: "json",
+        description: "Query US stock historical daily kline (NYSE/NASDAQ/AMEX)",
     },
     "quote.index-day-kline": {
         key: "quote.index-day-kline",
@@ -240,6 +247,13 @@ export const ENDPOINTS = {
         kind: "json",
         description: "Query A-share minute kline (SH/SZ/BJ)",
     },
+    "quote.realtime": {
+        key: "quote.realtime",
+        method: "POST",
+        path: "/application/open-quote/quote/realtime",
+        kind: "json",
+        description: "Query realtime quote snapshot (A-share / HK / US)",
+    },
     // ─── fundamental ───
     "fundamental.income-statement": {
         key: "fundamental.income-statement",

package/dist/src/version.js

@@ -1,2 +1,2 @@
 // Auto-generated — DO NOT EDIT
-export const CLI_VERSION = "0.13.0";
+export const CLI_VERSION = "0.14.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gangtise-openapi-cli",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "CLI for Gangtise OpenAPI",
   "license": "MIT",
   "repository": {