ETF Analytics Dashboard

哪只 ETF？

一个 ETF 对比仪表板。它将涵盖广泛的美国上市基金范围筛选为候选清单，然后帮助比较费用、资产规模、流动性、收益率和历史回报。每项市场快照都会标明其来源和采集日期；缺失的费用会显示为未经核实，而不会进行猜测。

该界面是一个以决策为导向的数据设计示例。它不会推荐基金，也不提供投资建议。

功能

• 概览： 优先展示市场集中度、回报加权、流动性和类别层面的模式，而非原始基金数量汇总。
• 筛选器： 按代码、基金名称和发行方搜索；按类别、资产规模、收益率和已核实费用筛选；支持排序和分页。
• 对比： 并列展示最多 4 只基金，并呈现类似产品之间的重要差异。
• 基金详情： 从 Stooq 获取每日价格历史，并计算回报、波动率、回撤和夏普比率指标。此外，还会展示带日期的快照数据，以及可获取的、经核实的发行方公布费用。
• 类别分析： 比较符合条件的基金数量充足的类别的回报中位数。
• 表现最佳基金和风险回报： 按回报或收益率对基金排名，并展示 3 年与 5 年期的模式；在适用情况下排除杠杆型、反向型和规模较小的基金。
• 新闻情绪： 配置 API 密钥后，显示 Alpha Vantage 的主题级结果。

数据和限制

该目录包含通过 yfinance 从 Yahoo Finance 获取的 4,148 只基金数据，采集日期为 2025 年 5 月 25 日。其中的资产规模、收益率、成交量和回报字段均为历史数据，不应视为当前市场数据。仪表板会在这些字段出现的位置显示快照的时间。基金详情页会单独向 Stooq 请求每日历史数据；某些代码或某些时段可能无法获取数据。

部分常见对比基金的费率经过人工核实，数据来自发行方公布的信息。其他行会显示 n/a。新闻视图需要 Alpha Vantage 密钥。没有用户账户或个性化推荐。

本地运行

要求：Node.js 20.9 或更高版本。

git clone https://github.com/violettance/etf-dashboard.git
cd etf-dashboard
npm ci
npm run dev

打开 http://localhost:3000。筛选器和历史目录无需 API 密钥即可使用。要启用新闻情绪功能，请将 .env.example 复制为 .env.local，并设置 ALPHA_VANTAGE_API_KEY。密钥仅在服务器端读取。

检查

npm run typecheck
npm run lint
npm test -- --run
npm run build

技术栈

Next.js App Router、React、TypeScript、Tailwind CSS、Recharts、Zod 和 Vitest。

许可证

MIT。请参阅 LICENSE。