gangtise-openapi-cli 0.17.2 → 0.19.0

package/README.md

@@ -4,6 +4,28 @@
 
 ## Changelog
 
+### v0.19.0 — 2026-06-24
+
+**新增接口（Indicator · 证券级数据指标 EDE）**
+- `indicator search` — 按名称搜索证券级数据指标，返回 `indicatorCode` 及可传参数 `parameterList`（含 `required` 必填标记与枚举）；取数前必先 search 拿 code，绝不猜编码
+- `indicator cross-section` — 指标截面数据（多指标 × 多证券，单日快照）：`--indicator` / `--security`（均可重复）/ `--date` / `--currency` / `--scale` / `--indicator-param`
+- `indicator time-series` — 指标时间序列（多指标 × 单证券 或 单指标 × 多证券，按区间）：另有 `--start-date` / `--end-date` / `--calendar-type`（`ND`/`TD`/`WD`）
+- 复权等指标专属参数用 `--indicator-param "code:key=value"`，参数 key 与取值以 search 的 `parameterList` 为准（行情复权键为 `adjustmentType`：`1` 不复权 / `2` 前复权 / `3` 后复权）
+- 很多指标有必填参数，默认调用会报 `410106`（缺必填参数）：N 期统计补 `periodNum`、区间/周期类补 `startDate`、年度/分红类补 `fiscalYear`；`999999` 多为「该证券公司类型/报告期无数据」而非系统故障。详见 `gangtise-openapi/references/commands/indicator.md`
+
+**修复**
+- `vault stock-pool-stocks --pool-id <id>` 过滤失效：此前因选项默认值 `["all"]` 泄漏，传具体 pool id 仍返回全部股票池证券；现已修复——传 id 精确过滤，省略则默认全量
+- `auth` 缺凭证报错补充跨 shell（bash/zsh/fish）的 `export` 提示
+
+**文档**
+- README / SKILL 补充 indicator 命令组与取数最佳实践；`official-account` 命令文档补全
+
+### v0.18.0 — 2026-06-17
+
+**新增接口（Insight · 产业公众号资讯）**
+- `insight official-account list` — 查询公众号资讯列表：支持 `--keyword`（需用数据中的具体词，非整句白话）/ `--account-id`（公众号 ID）/ `--security` / `--category`（文章类型枚举：`news`/`law`/`report`/`view`/`data`/`event`/`meeting`/`notice`/`recruit`/`investEdu`/`brand`/`notes`/`other`）/ `--industry`（`citicIndustry`/`swIndustry` 行业 ID）/ `--search-type`（`1` 标题 / `2` 全文）/ `--rank-type`（`1` 综合 / `2` 时间倒序）；返回含模型生成摘要 `summary` 及关联行业/题材/证券列表
+- `insight official-account download --article-id <id>` — 下载公众号文章：`--file-type 1` txt（默认）/ `2` HTML
+
 ### v0.17.0 — 2026-06-15
 
 **接口变更（Breaking）**
@@ -217,6 +239,7 @@ gangtise-openapi/
     │   ├── ai.md                     #   AI 能力命令（one-pager / earnings-review / viewpoint-debate 等）
     │   ├── alternative.md            #   行业指标数据库（EDB search / EDB data）
     │   ├── fundamental.md            #   财务数据命令（A股/港股三大报表 / 估值 / 盈利预测 / 股东）
+    │   ├── indicator.md              #   证券级数据指标 EDE（search / 截面 / 时序）
     │   ├── insight.md                #   投研内容命令（研报 / 观点 / 纪要 / 公告 / 外资）
     │   ├── quote.md                  #   行情命令（A股/港股/指数 K 线）
     │   ├── reference-and-lookup.md   #   GTS Code 搜索与枚举速查
@@ -272,6 +295,7 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 | | `announcement-hk list` / `download` | 港股公告（含下载） |
 | | `foreign-opinion list` | 外资机构观点 |
 | | `independent-opinion list` / `download` | 外资独立分析师观点（含原文/翻译HTML下载） |
+| | `official-account list` / `download` | 产业公众号资讯（含 txt/HTML 下载） |
 | **Reference** | `securities-search` | GTS Code 搜索（按名称/代码/拼音匹配） |
 | | `constant-category` | 常量分类列表（含各分类适用的接口与参数） |
 | | `constant-list` | 按分类导出常量值全量列表（行业/城市/公告分类/区域等） |
@@ -307,6 +331,9 @@ cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
 | | `my-conference-list` / `my-conference-download` | 我的会议列表与下载 |
 | | `wechat-message-list` / `wechat-chatroom-list` | 群消息列表与群ID查询 |
 | | `stock-pool-list` / `stock-pool-stocks` | 自选股股票池列表与证券明细 |
+| **Indicator** | `search` | 证券级数据指标搜索（按名称匹配，返回 indicatorCode 及可传参数 parameterList） |
+| | `cross-section` | 指标截面数据（多指标 × 多证券，单日快照；前置 `search` 拿 code） |
+| | `time-series` | 指标时间序列（多指标 × 单证券 或 单指标 × 多证券，按区间） |
 | **Alternative** | `edb-search` | 行业指标搜索（按关键词匹配，返回 indicatorId 等元信息） |
 | | `edb-data` | 行业指标时序数据（批量拉取，最多10个指标） |
 | | `concept-info` | 题材指数基本信息（投资逻辑/行业空间/竞争格局/催化事件） |
@@ -378,6 +405,7 @@ gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
 - `insight announcement-hk list`
 - `insight foreign-opinion list`
 - `insight independent-opinion list`
+- `insight official-account list`
 - `ai security-clue`
 - `vault drive-list`
 - `vault record-list`
@@ -395,7 +423,7 @@ gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
 
 ## 智能文件命名
 
-下载命令（`summary download`、`research download`、`foreign-report download`、`announcement download`、`vault drive-download`、`vault record-download`、`vault my-conference-download`）省略 `--output` 时，自动使用真实标题作为文件名：
+下载命令（`summary download`、`research download`、`foreign-report download`、`announcement download`、`official-account download`、`vault drive-download`、`vault record-download`、`vault my-conference-download`）省略 `--output` 时，自动使用真实标题作为文件名：
 
 1. **缓存优先** — 如果之前执行过对应的 `list` 命令，标题已缓存在 `~/.config/gangtise/title-cache.json`，直接使用，无额外 API 调用
 2. **API 回查** — 缓存未命中时，自动查询最近 200 条记录匹配标题
@@ -455,6 +483,10 @@ gangtise insight foreign-opinion list --security APP.O --rating buy --format jso
 gangtise insight independent-opinion list --keyword "肿瘤" --industry 100800118 --format json
 gangtise insight independent-opinion download --independent-opinion-id 207051900018372 --file-type 2
 
+# 产业公众号资讯
+gangtise insight official-account list --keyword 泡泡玛特 --rank-type 2 --size 20 --format json
+gangtise insight official-account download --article-id 7286248 --file-type 2
+
 # 纪要下载（会议平台来源可选 HTML 格式）
 gangtise insight summary download --summary-id 4906813 --file-type 2
 ```
@@ -613,6 +645,34 @@ gangtise vault stock-pool-stocks --pool-id 808477293
 gangtise vault stock-pool-stocks
 ```
 
+### Indicator（证券级数据指标 EDE）
+
+```bash
+# Step 1：按名称搜索，拿 indicatorCode（绝不猜编码）；--format json 看可传参数 parameterList 及 required
+gangtise indicator search --keyword 收盘价 --format table             # → qte_close
+gangtise indicator search --keyword 平均ROE --limit 5 --format json    # 看 parameterList
+
+# 截面：多指标 × 多证券，单日快照（行情类用交易日；财务类用报告期末，如 2026-03-31）
+gangtise indicator cross-section \
+  --indicator qte_close --indicator qte_vol --indicator qte_mkt_cptl \
+  --security 600519.SH --security 09992.HK \
+  --date 2026-05-18 --format table
+
+# 时间序列：多指标 × 单证券 或 单指标 × 多证券（不能多 × 多，否则报 410001）
+gangtise indicator time-series --indicator qte_close \
+  --security 600519.SH --security 09992.HK \
+  --start-date 2026-05-12 --end-date 2026-05-18 --format table
+
+# 复权 / 指标专属参数用 --indicator-param "code:key=value"，参数 key 以 search 的 parameterList 为准
+gangtise indicator cross-section --indicator qte_close --security 600519.SH \
+  --date 2026-05-18 --indicator-param "qte_close:adjustmentType=3"   # 1不复权/2前复权/3后复权
+
+# 必填参数：很多指标默认调用报 410106（缺必填参数），按 parameterList 的 required 补齐再取：
+#   N 期统计补 periodNum、区间/周期类（如 qte_amp_mo 月振幅）补 startDate、年度/分红类补 fiscalYear
+gangtise indicator cross-section --indicator finc_roe_avg_avg --security 600519.SH \
+  --date 2026-03-31 --indicator-param "finc_roe_avg_avg:periodNum=4"
+```
+
 ### Alternative（行业指标数据库 EDB）
 
 ```bash

package/dist/src/cli.js

@@ -3,7 +3,8 @@ import { Command, Option } from "commander";
 import { checkAsyncContent, pollAsyncContent, POLL_MAX_ATTEMPTS } from "./core/asyncContent.js";
 import { readTokenCache } from "./core/auth.js";
 import { collectKeyValue, collectList, collectNumberList, maybeArray, parseFrom, parseNumberOption, parseOptionalNumberOption, parseSize, parseTimestamp13 } from "./core/args.js";
-import { buildQuoteKlineBody, buildWechatChatroomListBody, buildWechatMessageListBody } from "./core/commandBodies.js";
+import { buildIndicatorCrossSectionBody, buildIndicatorTimeSeriesBody, buildQuoteKlineBody, buildStockPoolStocksBody, buildWechatChatroomListBody, buildWechatMessageListBody } from "./core/commandBodies.js";
+import { flattenCrossSection, flattenTimeSeries, unwrapIndicatorData } from "./core/indicatorMatrix.js";
 import { callKlineWithSharding } from "./core/quoteSharding.js";
 import { loadConfig } from "./core/config.js";
 import { resolveTitle, saveDownloadResult } from "./core/download.js";
@@ -131,6 +132,7 @@ const announcement = new Command("announcement");
 const announcementHk = new Command("announcement-hk");
 const foreignOpinion = new Command("foreign-opinion");
 const independentOpinion = new Command("independent-opinion");
+const officialAccount = new Command("official-account");
 addTimeFilters(opinion.command("list").option("--rank-type <number>", "Rank type", "1").option("--research-area <id>", "Research area ID", collectList, []).option("--chief <id>", "Chief ID", collectList, []).option("--security <code>", "Security code", collectList, []).option("--broker <id>", "Broker ID", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--concept <id>", "Concept ID", collectList, []).option("--llm-tag <tag>", "Semantic tag", collectList, []).option("--source <source>", "Source", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action((options) => emit(options, (client) => client.call("insight.opinion.list", {
     from: parseFrom(options.from), size: parseSize(options.size), startTime: options.startTime, endTime: options.endTime,
     rankType: parseNumberOption(options.rankType, "--rank-type", { integer: true, min: 1 }), keyword: options.keyword, researchAreaList: maybeArray(options.researchArea), chiefList: maybeArray(options.chief),
@@ -247,6 +249,16 @@ addTimeFilters(independentOpinion.command("list").option("--rank-type <number>",
     ratingList: maybeArray(options.rating), ratingChangeList: maybeArray(options.ratingChange),
 })));
 addDownloadCommand(independentOpinion, { endpointKey: "insight.independent-opinion.download", idOption: "--independent-opinion-id", idField: "independentOpinionId", fallbackPrefix: "independent-opinion", fileType: { description: "File type: 1=original HTML 2=CN-translated HTML", required: true } });
+addTimeFilters(officialAccount.command("list").option("--search-type <number>", "Search type: 1=title 2=fulltext", "1").option("--rank-type <number>", "Rank type: 1=composite 2=time desc", "1").option("--account-id <id>", "Official account ID", collectList, []).option("--security <code>", "Security code (e.g. 000001.SZ)", collectList, []).option("--category <type>", "Article type: news/law/report/view/data/event/meeting/notice/recruit/investEdu/brand/notes/other", collectList, []).option("--industry <id>", "Industry ID (constant-list citicIndustry/swIndustry)", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action((options) => emit(options, (client) => client.call("insight.official-account.list", {
+    from: parseFrom(options.from), size: parseSize(options.size),
+    startTime: options.startTime, endTime: options.endTime,
+    searchType: parseNumberOption(options.searchType, "--search-type", { integer: true, min: 1 }),
+    rankType: parseNumberOption(options.rankType, "--rank-type", { integer: true, min: 1 }),
+    keyword: options.keyword,
+    accountIdList: maybeArray(options.accountId), securityList: maybeArray(options.security),
+    categoryList: maybeArray(options.category), industryList: maybeArray(options.industry),
+}), { endpointKey: "insight.official-account.list", idField: "articleId" }));
+addDownloadCommand(officialAccount, { endpointKey: "insight.official-account.download", idOption: "--article-id", idField: "articleId", fallbackPrefix: "official-account", fileType: { description: "File type: 1=txt(default) 2=HTML", default: "1" }, titleListEndpoint: "insight.official-account.list" });
 insight.addCommand(opinion);
 insight.addCommand(summary);
 insight.addCommand(roadshow);
@@ -259,6 +271,7 @@ insight.addCommand(announcement);
 insight.addCommand(announcementHk);
 insight.addCommand(foreignOpinion);
 insight.addCommand(independentOpinion);
+insight.addCommand(officialAccount);
 program.addCommand(insight);
 const quote = new Command("quote").description("Quote APIs");
 const addKlineCommand = (name, endpointKey, securityHelp, shardDays) => quote.command(name)
@@ -421,7 +434,7 @@ addDownloadCommand(vault, { endpointKey: "vault.my-conference.download", name: "
 vault.command("wechat-message-list").option("--from <number>", "Starting offset", "0").option("--size <number>", "Total rows to return; omit to fetch all").option("--start-time <datetime>").option("--end-time <datetime>").option("--keyword <text>").option("--security <code>", "Security code (e.g. 000001.SZ)", collectList, []).option("--wechat-group-id <id>", "WeChat group ID", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--category <name>", "Message type: text/image/documents/url", collectList, []).option("--tag <name>", "Tag: roadShow/research/strategyMeeting/meetingSummary/industryComment/companyComment/earningsReview", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("vault.wechat-message.list", buildWechatMessageListBody(options))));
 vault.command("wechat-chatroom-list").option("--from <number>", "Starting offset", "0").option("--size <number>", "Rows to return", "20").option("--room-name <name>", "WeChat group name; repeat or comma-separate for multiple names", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("vault.wechat-chatroom.list", buildWechatChatroomListBody(options))));
 vault.command("stock-pool-list").option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("vault.stock-pool.list", {})));
-vault.command("stock-pool-stocks").option("--pool-id <id>", "Pool ID; repeat for multiple; use 'all' for all pools", collectList, ["all"]).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("vault.stock-pool.stocks", { poolIdList: options.poolId })));
+vault.command("stock-pool-stocks").option("--pool-id <id>", "Pool ID; repeat for multiple; omit (or 'all') for all pools", collectList).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => emit(options, (client) => client.call("vault.stock-pool.stocks", buildStockPoolStocksBody(options))));
 program.addCommand(vault);
 program.addCommand(ai);
 const alternative = new Command("alternative").description("Alternative data APIs");
@@ -448,6 +461,23 @@ alternative.command("edb-data").option("--indicator-id <id>", "Indicator ID (rep
 alternative.command("concept-info").requiredOption("--concept-id <id>", "Concept (theme index) ID, e.g. 121000130 机器人; discover via 'gangtise reference concept-search'").option("--format <format>", "Output format", "json").option("--output <path>").action((options) => emit(options, (client) => client.call("alternative.concept-info", { conceptId: options.conceptId })));
 alternative.command("concept-securities").requiredOption("--concept-id <id>", "Concept (theme index) ID, e.g. 121000130 机器人; discover via 'gangtise reference concept-search'").option("--format <format>", "Output format", "json").option("--output <path>").action((options) => emit(options, (client) => client.call("alternative.concept-securities", { conceptId: options.conceptId })));
 program.addCommand(alternative);
+const indicator = new Command("indicator").description("Data indicator (EDE) APIs: search codes, cross-section, time-series");
+indicator.command("search").requiredOption("--keyword <text>", "Search keyword, e.g. '收盘价' '成交量' '营业收入' (not free-form questions)").option("--limit <number>", "Max results (default: 50, max: 100)", "50").option("--format <format>", "Output format", "table").option("--output <path>").action((options) => withClient(async (client) => {
+    const raw = await client.call("indicator.search", {
+        keyword: options.keyword,
+        limit: parseNumberOption(options.limit, "--limit", { integer: true, min: 1 }),
+    });
+    await printData(unwrapIndicatorData(raw), parseOutputFormat(options.format), options.output);
+}));
+indicator.command("cross-section").option("--indicator <code>", "Indicator code, e.g. qte_close (repeat for multiple)", collectList, []).option("--security <code>", "Security code, e.g. 600519.SH (repeat for multiple)", collectList, []).requiredOption("--date <date>", "Data date (yyyy-MM-dd)").option("--currency <code>", "Currency: DFT/CNY/HKD/USD/EUR/GBP/JPY/TWD/MOP/AUD (default DFT)").option("--scale <code>", "Scale: 0=个 3=千 4=万 6=百万 8=亿 9=十亿 (default 0)").option("--indicator-param <spec>", "Per-indicator param 'code:key=value', e.g. qte_close:adjustmentType=2 for 前复权 (repeat)", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => withClient(async (client) => {
+    const raw = await client.call("indicator.cross-section", buildIndicatorCrossSectionBody(options));
+    await printData(flattenCrossSection(unwrapIndicatorData(raw)), parseOutputFormat(options.format), options.output);
+}));
+indicator.command("time-series").option("--indicator <code>", "Indicator code, e.g. qte_close (repeat for multiple)", collectList, []).option("--security <code>", "Security code, e.g. 600519.SH (repeat for multiple)", collectList, []).requiredOption("--start-date <date>", "Start date (yyyy-MM-dd)").requiredOption("--end-date <date>", "End date (yyyy-MM-dd)").option("--calendar-type <type>", "Calendar: ND=natural TD=trading WD=weekday (default TD)").option("--currency <code>", "Currency: DFT/CNY/HKD/USD/EUR/GBP/JPY/TWD/MOP/AUD (default DFT)").option("--scale <code>", "Scale: 0=个 3=千 4=万 6=百万 8=亿 9=十亿 (default 0)").option("--indicator-param <spec>", "Per-indicator param 'code:key=value', e.g. qte_close:adjustmentType=2 for 前复权 (repeat)", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action((options) => withClient(async (client) => {
+    const raw = await client.call("indicator.time-series", buildIndicatorTimeSeriesBody(options));
+    await printData(flattenTimeSeries(unwrapIndicatorData(raw)), parseOutputFormat(options.format), options.output);
+}));
+program.addCommand(indicator);
 program.command("raw").description("Raw API calls").addCommand(new Command("call").argument("<endpointKey>").option("--body <json>").option("--query <key=value>", "Query string pair", collectKeyValue, {}).option("--format <format>", "Output format", "json").option("--output <path>").action(async (endpointKey, options) => {
     const endpoint = ENDPOINTS[endpointKey];
     if (!endpoint) {

package/dist/src/core/args.js

@@ -79,3 +79,29 @@ export function parseTimestamp13(value, optionName) {
     }
     return parsed;
 }
+// Parse repeatable `--indicator-param "code:key=value"` specs into the nested
+// indicatorParamList the EDE cross-section / time-series endpoints expect.
+// Multiple specs for the same code accumulate into one group, first-seen order.
+export function parseIndicatorParams(specs) {
+    if (specs.length === 0)
+        return undefined;
+    const groups = new Map();
+    for (const spec of specs) {
+        const colon = spec.indexOf(":");
+        const rest = colon === -1 ? "" : spec.slice(colon + 1);
+        const eq = rest.indexOf("=");
+        const code = colon === -1 ? "" : spec.slice(0, colon).trim();
+        const paramKey = eq === -1 ? "" : rest.slice(0, eq).trim();
+        const paramValue = eq === -1 ? "" : rest.slice(eq + 1).trim();
+        if (!code || !paramKey) {
+            throw new ValidationError(`Invalid --indicator-param: expected "code:key=value", got "${spec}"`);
+        }
+        let group = groups.get(code);
+        if (!group) {
+            group = { indicatorCode: code, parameters: [] };
+            groups.set(code, group);
+        }
+        group.parameters.push({ paramKey, paramValue });
+    }
+    return [...groups.values()];
+}

package/dist/src/core/auth.js

@@ -30,7 +30,12 @@ export function normalizeToken(token) {
 }
 export function requireAccessCredentials(accessKey, secretKey) {
     if (!accessKey || !secretKey) {
-        throw new ConfigError("Missing GANGTISE_ACCESS_KEY or GANGTISE_SECRET_KEY");
+        const missing = [!accessKey && "GANGTISE_ACCESS_KEY", !secretKey && "GANGTISE_SECRET_KEY"].filter(Boolean).join(", ");
+        throw new ConfigError(`缺少环境变量: ${missing}（未导出到当前进程环境）\n`
+            + `注意：在 shell 里赋值还不够，必须"导出"，子进程才读得到：\n`
+            + `  bash/zsh:  export GANGTISE_ACCESS_KEY=... GANGTISE_SECRET_KEY=...\n`
+            + `  fish:      set -gx GANGTISE_ACCESS_KEY ...; set -gx GANGTISE_SECRET_KEY ...\n`
+            + `验证：env | grep GANGTISE（能列出对应行才算导出成功）`);
     }
     return { accessKey, secretKey };
 }

package/dist/src/core/commandBodies.js

@@ -1,4 +1,4 @@
-import { maybeArray, parseFrom, parseOptionalNumberOption, parseSize } from "./args.js";
+import { maybeArray, parseFrom, parseIndicatorParams, parseOptionalNumberOption, parseSize } from "./args.js";
 export function buildQuoteKlineBody(options) {
     return {
         securityList: maybeArray(options.security),
@@ -29,3 +29,30 @@ export function buildWechatChatroomListBody(options) {
         roomName: options.roomName.length > 0 ? options.roomName.join(",") : undefined,
     };
 }
+export function buildStockPoolStocksBody(options) {
+    return {
+        poolIdList: options.poolId?.length ? options.poolId : ["all"],
+    };
+}
+export function buildIndicatorCrossSectionBody(options) {
+    return {
+        indicatorCodeList: maybeArray(options.indicator),
+        securityCodeList: maybeArray(options.security),
+        date: options.date,
+        currency: options.currency,
+        scale: options.scale,
+        indicatorParamList: parseIndicatorParams(options.indicatorParam),
+    };
+}
+export function buildIndicatorTimeSeriesBody(options) {
+    return {
+        indicatorCodeList: maybeArray(options.indicator),
+        securityCodeList: maybeArray(options.security),
+        startDate: options.startDate,
+        endDate: options.endDate,
+        calendarType: options.calendarType,
+        currency: options.currency,
+        scale: options.scale,
+        indicatorParamList: parseIndicatorParams(options.indicatorParam),
+    };
+}

package/dist/src/core/endpoints.js

@@ -161,6 +161,21 @@ export const ENDPOINTS = {
         kind: "download",
         description: "Download foreign independent opinion file",
     },
+    "insight.official-account.list": {
+        key: "insight.official-account.list",
+        method: "POST",
+        path: "/application/open-insight/officialAccount/getList",
+        kind: "json",
+        description: "List WeChat official account articles",
+        pagination: { enabled: true, maxPageSize: 50 },
+    },
+    "insight.official-account.download": {
+        key: "insight.official-account.download",
+        method: "GET",
+        path: "/application/open-insight/officialAccount/download/file",
+        kind: "download",
+        description: "Download WeChat official account article (txt/HTML)",
+    },
     // ─── reference ───
     "reference.securities-search": {
         key: "reference.securities-search",
@@ -544,4 +559,26 @@ export const ENDPOINTS = {
         kind: "json",
         description: "Query concept (theme index) constituent securities, grouped",
     },
+    // ─── indicator (EDE: security-level data indicators) ───
+    "indicator.search": {
+        key: "indicator.search",
+        method: "POST",
+        path: "/application/open-indicator/EDE/search",
+        kind: "json",
+        description: "Search data indicators by keyword (returns indicatorCode + params)",
+    },
+    "indicator.cross-section": {
+        key: "indicator.cross-section",
+        method: "POST",
+        path: "/application/open-indicator/EDE/cross-section",
+        kind: "json",
+        description: "Get cross-section data (multi-indicator x multi-security, single date)",
+    },
+    "indicator.time-series": {
+        key: "indicator.time-series",
+        method: "POST",
+        path: "/application/open-indicator/EDE/time-series",
+        kind: "json",
+        description: "Get time-series data (multi-indicator x single-security OR single-indicator x multi-security)",
+    },
 };

package/dist/src/core/indicatorMatrix.js

@@ -0,0 +1,95 @@
+import { ApiError } from "./errors.js";
+// The EDE endpoints double-wrap on success: the shared client strips the outer
+// envelope but leaves an inner { code, status, data } around the real payload.
+// Peel that inner envelope so the list (search) / matrix (cross-section,
+// time-series) is reachable. Observed errors arrive single-enveloped (the
+// client throws on those), but a failure code carried only by the inner
+// envelope must still surface instead of rendering its null payload as success.
+export function unwrapIndicatorData(raw) {
+    if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+        const record = raw;
+        if ("data" in record && ("code" in record || "status" in record)) {
+            const code = record.code === undefined ? undefined : String(record.code);
+            const ok = record.status === true || code === "000000" || code === "0";
+            if (!ok) {
+                throw new ApiError(typeof record.msg === "string" && record.msg ? record.msg : "Indicator API request failed", code);
+            }
+            return record.data;
+        }
+    }
+    return raw;
+}
+function asStringArray(value) {
+    return Array.isArray(value) ? value.map((item) => String(item)) : undefined;
+}
+function rowOf(values, index) {
+    const row = values[index];
+    return Array.isArray(row) ? row : undefined;
+}
+// Build one column header per series. Prefer the human-readable name; on a
+// duplicate name append the code so a column is never silently overwritten.
+function buildHeaders(names, codes, count) {
+    const used = new Set();
+    const headers = [];
+    for (let i = 0; i < count; i++) {
+        const base = String(names?.[i] ?? codes?.[i] ?? `col${i}`);
+        let header = base;
+        let attempt = 1;
+        while (used.has(header)) {
+            const suffix = codes?.[i] ?? i;
+            header = attempt === 1 ? `${base} (${suffix})` : `${base} (${suffix})_${attempt}`;
+            attempt++;
+        }
+        used.add(header);
+        headers.push(header);
+    }
+    return headers;
+}
+// Cross-section: one row per security, one column per indicator. The live
+// `values` is a flat [numIndicators * numSecurities][1] array in
+// indicator-major order, so indicator i on security j is values[i*numSec+j][0].
+export function flattenCrossSection(data) {
+    if (!data || typeof data !== "object")
+        return data;
+    const d = data;
+    const securityCode = asStringArray(d.securityCode);
+    const indicators = asStringArray(d.indicators);
+    if (!Array.isArray(d.values) || !securityCode || !indicators)
+        return data;
+    const securityName = asStringArray(d.securityName);
+    const headers = buildHeaders(asStringArray(d.indicatorName), indicators, indicators.length);
+    const numSec = securityCode.length;
+    const list = securityCode.map((code, j) => {
+        const row = { date: d.date, security: code, name: securityName?.[j] };
+        for (let i = 0; i < indicators.length; i++) {
+            row[headers[i]] = rowOf(d.values, i * numSec + j)?.[0];
+        }
+        return row;
+    });
+    return { list, total: list.length };
+}
+// Time-series: one row per date. Columns are the indicators (single-security
+// case) or the securities (single-indicator case) — exactly one dimension
+// varies, per the API contract. `values` is a 2D [series][date] matrix.
+export function flattenTimeSeries(data) {
+    if (!data || typeof data !== "object")
+        return data;
+    const d = data;
+    const dates = asStringArray(d.dates);
+    const securityCode = asStringArray(d.securityCode);
+    const indicators = asStringArray(d.indicators);
+    if (!Array.isArray(d.values) || !dates || !securityCode || !indicators)
+        return data;
+    const seriesAreIndicators = securityCode.length <= 1;
+    const headers = seriesAreIndicators
+        ? buildHeaders(asStringArray(d.indicatorName), indicators, indicators.length)
+        : buildHeaders(asStringArray(d.securityName), securityCode, securityCode.length);
+    const list = dates.map((date, k) => {
+        const row = { date };
+        for (let i = 0; i < headers.length; i++) {
+            row[headers[i]] = rowOf(d.values, i)?.[k];
+        }
+        return row;
+    });
+    return { list, total: list.length };
+}

package/dist/src/version.js

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

package/package.json

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