| 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+） |
四市合计总结内容
报告顶部输出一个汇总框，包含：
- 合计成交金额 — 四市总成交额（亿元）
- 前一交易日合计 — 四市前一交易日总成交额
- 增缩额 & 增缩比例 — 合计层面的量能变化
- 各市场占比 — 沪市 / 深市 / 创业板 / 北交所各自占总成交额的比例
- 成交最大/最小市场 — 标注四市中谁贡献最多、谁最少
- 市场情绪 — 三市上涨/下跌家数及涨跌比（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
