SuperAPI AI 工具集

track-equity-cumulative-return

数据与分析

查看项目

更新于 10-15 21:41

技能介绍

用途:计算股票或指数的累计收益率,支持多标的对比与指数成分股Top N排名,并生成可视化图表。所有分析固定以标普500(^GSPC)为基准,该设定硬编码不可更改;"vs Benchmark"为标的收益减标普500收益,正值代表跑赢(Alpha)。基准日取上一年最后一个交易日,累计收益率=((期末价/基准价)-1)×100%。

主要能力:支持四种场景——1.a指定股票单一年份、1.b指定股票从某年至今日、2.a指数成分股单一年份Top N、2.b指数成分股从某年至今日Top N。支持的指数有nasdaq100、sp100、dow30、sox。输出包括累计收益时间序列图、业绩排名表、JSON数据与Markdown报告,图表为暗色主题PNG。

使用方式:进入scripts目录后安装依赖 pip install pandas numpy yfinance matplotlib,再运行脚本。示例:python cumulative_return_analyzer.py --ticker NVDA AMD --year 2024 --year-only;python index_component_analyzer.py --index nasdaq100 --year 2022 --top 20;python visualize_cumulative.py --ticker NVDA AMD --year 2024 --year-only。关键参数:--year-only仅分析指定年份,不加则从该年至今日;--top N选择指数前N名;--index指定指数;--ticker可多个。

限制:指数成分股为当前成分,存在幸存者偏差;收益仅为价格收益,不含股息;Yahoo Finance为免费公开API,重度使用可能被限流,缓存有效期12小时,可用 python fetch_price_data.py --clear-cache 清除。收费、价格与平台信息暂未提供。