申万一级行业指数数据获取与分析

自动抓取全部31个申万一级行业指数历史数据，生成统计报告。

快速开始

Step 1: 安装依赖

!pip install akshare openpyxl -q

Step 2: 抓取数据

方式一：命令行（适合快速导出 CSV）

python scripts/fetch_sw_index.py --start 2023-01-01 --output daily.csv --stats stats.csv

方式二：Python 直接调用（适合生成 Excel 报告）

import sys
sys.path.insert(0, "scripts")
from fetch_sw_index import fetch_all, compute_stats

# end_date 自动取今天，无需手动指定
df = fetch_all(start_date="2023-01-01", period="day")
stats = compute_stats(df)
print(stats)

Step 3: 生成 Excel 分析报告

import sys, pandas as pd, openpyxl
sys.path.insert(0, "scripts")
from fetch_sw_index import fetch_all, compute_stats

df = fetch_all(start_date="2023-01-01", period="day")
stats = compute_stats(df)

# 导出 CSV
df.to_csv("sw31_daily.csv", index=False, encoding="utf-8-sig")
stats.to_csv("sw31_stats.csv", index=False, encoding="utf-8-sig")

Excel 报告建议包含以下 Sheet：

封面 - 报告标题、数据区间、关键指标摘要、目录
统计汇总 - 31个行业核心指标对比（按收益率降序），红涨绿跌着色
涨跌幅排名 - 横向柱状图，红/绿按涨跌分色
日线数据 - 完整 OHLCV 数据
数据来源 - 数据说明与免责声明

风格：A 股惯例（红涨绿跌），主色调 #1F3864 深蓝。

核心参数

| 参数 | 默认值 | 说明 | |------|--------|------| | start_date | "2023-01-01" | 起始日期（包含）| | end_date | 今天（自动） | 结束日期（包含），不填则自动取当天 | | period | "day" | 频率：day 日线 / week 周线 / month 月线 |

compute_stats() 输出字段

| 字段 | 说明 | |------|------| | code | 指数代码 | | name | 行业名称 | | start_date / end_date | 数据区间 | | start_close / end_close | 期初 / 期末点位 | | total_return_pct | 区间收益率（%） | | high / high_date | 区间最高点及日期 | | low / low_date | 区间最低点及日期 | | ann_volatility_pct | 年化波动率（%） | | max_drawdown_pct / max_dd_date | 最大回撤及其发生日期 | | sharpe_ratio | 夏普比率（无风险利率默认 2%） |

指数代码参考

详见 references/sw_index_codes.md，共31个申万一级行业（2021版）。

注意事项

数据来自 akshare 接口，速率限制内置 0.3s 间隔
数据通常在交易日收盘后更新
本工具仅供学习和研究使用，不构成投资建议

参考链接

akshare 文档：https://www.akshare.xyz/reference/index_stock.html#id8
申万宏源研究所：https://www.swsresearch.com