cn-stock-volume

name	cn-stock-volume
version	1.4.0
description	获取中国股市四市（沪市、深市、创业板、北交所）指定日期的成交金额、增缩量及比例，并输出四市合计总结。支持查询三市（沪市/深市/北交所）上涨/下跌家数。**首选 Browser 方案**（东方财富网网页版），备用 API 方案（东方财富/新浪/腾讯）。

cn-stock-volume

获取中国 A 股四市（沪市 / 深市 / 创业板 / 北交所）指定日期的成交金额、增缩额、增缩比例，以及四市合计总结报告。

核心脚本

python3 scripts/fetch_volume.py <YYYY-MM-DD | YYYYMMDD>

• 不传日期参数 → 默认查今天
• 传入 --json → 输出原始 JSON（供 AI 进一步处理）
• 日期格式支持 2026-03-20、20260320、2026/03/20、2026.03.20

核心指标说明

字段	说明
成交金额（亿元）	主指标，股票买卖总金额，自动换算为亿元
前一交易日成交金额	与目标日期最近的前一个交易日数据
增缩额	今日成交金额 − 前一交易日成交金额（+/-标注）
增缩比例	增缩额占前一交易日成交金额的百分比，📈 放量 / 📉 缩量
四市合计总结	四市成交金额加总 + 合计环比变化 + 各市场占比
上涨/下跌家数	三市（沪市/深市/北交所）当日上涨、下跌、平盘股票数量（v1.2.0+）

四市合计总结内容

报告顶部输出一个汇总框，包含：

1. 合计成交金额 — 四市总成交额（亿元）
2. 前一交易日合计 — 四市前一交易日总成交额
3. 增缩额 & 增缩比例 — 合计层面的量能变化
4. 各市场占比 — 沪市 / 深市 / 创业板 / 北交所各自占总成交额的比例
5. 成交最大/最小市场 — 标注四市中谁贡献最多、谁最少
6. 市场情绪 — 三市上涨/下跌家数及涨跌比（v1.2.0+）

市场说明

市场	指数代码	指数名称	说明
沪市	000001	上证指数	上海证券交易所全部 A 股
深市	399001	深证成指	深圳证券交易所主板 + 中小板
创业板	399006	创业板指	深圳证券交易所创业板
北交所	899050	北证 50	北京证券交易所

使用示例

直接查询今日：

python3 scripts/fetch_volume.py

查询指定日期：

python3 scripts/fetch_volume.py 2026-03-20
python3 scripts/fetch_volume.py 20260320

JSON 输出（用于程序处理）：

python3 scripts/fetch_volume.py 2026-03-20 --json

输出示例（v1.2.0+ 包含涨跌家数）：

======================================================================
  📊 中国股市成交报告  |  日期：2026-03-20
======================================================================

  ╔══════════════════════════════════════════════════════════╗
  ║  📋 三市合计总结（不含重复计算）                           ║
  ╠══════════════════════════════════════════════════════════╣
  ║  合计成交金额：    23030.9亿                            ║
  ║  增缩比例    ：📈   +8.25%                            ║
  ╚══════════════════════════════════════════════════════════╝

  ╔══════════════════════════════════════════════════════════╗
  ║  📈 市场情绪（三市涨跌家数）                               ║
  ╠══════════════════════════════════════════════════════════╣
  ║  上涨家数  ：   673  ( 12.1%)                          ║
  ║  下跌家数  ：  4845  ( 87.2%)                          ║
  ║  平盘家数  ：    41                                      ║
  ║  市场情绪  ：🔴 弱势                                        ║
  ╚══════════════════════════════════════════════════════════╝

注意事项

• 周末/节假日传入会提示"非交易日"，并告知最近的有效交易日
• 北交所成立时间较晚（2021 年），早期日期可能无数据
• 多层降级策略：当首选数据源失败时，自动尝试备用方案

数据来源与降级策略

📊 数据源优先级（v1.3.0+）

优先级	数据源	类型	状态
1️⃣ 首选	东方财富网 K 线 API	API	✅ 正常
2️⃣ 备用 1	新浪财经 API	API	⚠️ 需优化 headers
3️⃣ 备用 2	腾讯财经 API	API	⚠️ 需调试 URL
4️⃣ 备用 3	Browser 工具	浏览器自动化	📝 脚本已创建

降级逻辑

东方财富 API → 失败 → 新浪财经 → 失败 → 腾讯财经 → 失败 → Browser 工具

• 自动重试：每个数据源重试 2 次
• 优雅降级：所有数据源失败时，输出"数据不足"而不是崩溃
• 涨跌家数：独立获取，不受成交金额影响

详见：BACKUP_PLAN.md