搜索

概览

本技能在本机调用 scripts/*.py，请求 Gangtise Open API（open.gangtise.com），得到结构化、可保存为 CSV 的结果（由 scripts/utils.py 中的 format_response 写入工作区 workspace/gangtise/ 下对应子目录）。

当前脚本覆盖：

• 估值分析（多指标并发、历史分位）：scripts/valuation.py
• A 股日 K（可选全市场、--adjust 不复权/前复权/后复权；前复权默认，复权因子来自独立接口）：scripts/quote.py
• 主营构成（按产品/行业/地区，可并发全维度）：scripts/main_business.py
• 股东结构（前十大股东/前十大流通股东）：scripts/shareholder.py
• 财务报表（利润表/资产负债表/现金流量表）：scripts/financial.py
• 盈利预测（券商一致预期多指标）：scripts/earning_forecast.py

使用场景：

• 需要精确数值、时间序列或宽表，并保存为 CSV 做后续分析或制图。
• 已具备或可查到 完整证券代码（本技能不做简称/键盘精灵解析）。

与其他技能的区别：

（中文说明：本技能解决「是多少、表格化」；要先列文件再下载用 gangtise-file；要读原文片段、问答用 gangtise-kb。）

授权：在 scripts/ 下放置 .authorization，内容为 long-term-token，或 accessKey + secretAccessKey（将自动换 token）。详见 scripts/utils.py。

调用脚本时若使用 -sd / -ed，请注意当前真实日期与年份。

报告期（财务 / 主营）：命令行统一使用 Q1 / Q2 / Q3 / Q4 / Q0（分别对应一季报、中报、三季报、年报、最新一期）；脚本内再映射为 Open API 所需枚举（详见各 references）。

调用各脚本前，请阅读对应 references 中的参数与返回说明。

使用说明

1. 估值数据（估值分析）

基于 open 估值分析接口，并发拉取 peTtm / psTtm / pbMrq / peg / pcfTtm / em，并组装为与后端类似的宽表列（含「在 N 年中所处分位」）。-sd/-ed 默认均为当天。

python3 scripts/valuation.py --securities 600519.SH,000858.SZ

python3 scripts/valuation.py --securities-file ./codes.csv -sd 2023-01-01 -ed 2026-12-31

详见 估值数据调用指导。

2. 行情数据（日 K）

基于 open 日 K 接口；-sd/-ed 默认均为当天；--all-market 时不传证券列表（数据量可能极大，需配合日期与 limit）。

python3 scripts/quote.py --securities 00700.HK -sd 2026-04-23 -ed 2026-04-23

python3 scripts/quote.py --securities-file ./codes.csv --limit 8000

详见 行情数据调用指导。

3. 主营构成

基于 open main-business 接口；不传 --breakdown 时并发拉取 product / industry / region 三种拆分。--period 仅支持 Q2（中报）或 Q4（年报）。

python3 scripts/main_business.py --securities 000651.SZ

python3 scripts/main_business.py --securities 600519.SH --breakdown product --period Q4

详见 主营构成调用指导。

4. 股东结构（前十大 / 前十大流通）

基于 open capital-structure/top-holders 接口；通过 --holder-type 切换 top10（前十大股东）与 top10Float（前十大流通股东）。支持日期区间筛选（-sd/-ed）或按财报年度筛选（--fiscal-year），并可叠加报告期筛选（--period）。

python3 scripts/shareholder.py --holder-type top10 --securities 600519.SH

python3 scripts/shareholder.py --holder-type top10Float --securities 600519.SH -sd 2025-01-01 -ed 2025-12-31 --period q3

python3 scripts/shareholder.py --holder-type top10 --securities-file ./codes.csv --fiscal-year 2024,2025 --period q1,q3

详见 股东结构调用指导。

5. 财务数据（三大报表）

基于 open financial-report 系列接口，支持 income/balance/cashflow；--period 使用 Q1~Q4,Q0（默认 Q0），--granularity 支持 accumulated|quarterly（默认 accumulated，仅利润表/现金流量表生效）；默认 fieldList=[] 返回全部科目。

python3 scripts/financial.py --securities 600519.SH

python3 scripts/financial.py --table-type balance --securities 600519.SH --period Q4

python3 scripts/financial.py --table-type income --granularity quarterly --securities 600519.SH --fiscal-year 2025 --period Q2 --field-list totalOpRev,totalOpCost,netProfit,basicEPS

python3 scripts/financial.py --securities-file ./codes.csv --field-list netProfit,basicEarningsPerShare

详见 财务数据调用指导。

6. 盈利预测（券商一致预期）

基于 open earning_forecast 接口，支持通过 --securities/--securities-file 并发查询多只证券在指定日期区间的券商一致预期；支持通过 --consensus-list 选择指标，不传则默认返回全部可选字段。-sd/-ed 默认均为当天。返回会展开为 security_code | date | 预测年份 | ... 的扁平表；若单日查询当日无数据，会仅向前回退一天重试一次。

python3 scripts/earning_forecast.py --securities 600519.SH,000858.SZ -sd 2026-03-20 -ed 2026-03-25

python3 scripts/earning_forecast.py --securities-file ./codes.csv -sd 2026-03-20 -ed 2026-03-25 --consensus-list netIncome,eps,pe

详见 盈利预测调用指导。