用途:通过 Yahoo Finance 获取某只股票的历史 OHLCV 行情数据,适用于用户询问价格历史、历史数据、过往表现、价格随时间变化,或需要为后续分析准备数据时。
主要能力:按股票代码拉取 OHLCV 数据,可指定时间周期与数据间隔,输出 JSON 结果,包含 symbol(代码)、period(所请求周期)、interval(数据间隔)以及 data 数组,数组元素为 {date, open, high, low, close, volume}。可用于总结关键价格波动、高低点与趋势。
使用方式:运行命令 uv run python scripts/history.py SYMBOL [--period PERIOD] [--interval INTERVAL]。若未安装 uv 或找不到 pyproject.toml,可将命令中的 uv run python 替换为 python。SYMBOL 为股票代码;--period 可选 1d、5d、1mo、3mo、6mo、1y、2y、5y、10y、ytd、max,默认 1mo;--interval 可选 1m、2m、5m、15m、30m、60m、90m、1h、1d、5d、1wk、1mo,默认 1d。
依赖与时区:依赖 yfinance。所有时间戳与基于时间的计算必须使用 America/New_York 时区;所有 JSON 输出必须包含 generated_at(纽约时间字符串)与 data_delay 字段。
限制:数据来自 Yahoo Finance,具体平台覆盖范围、可用性、延迟及费用等资料未提供;不同周期与间隔组合是否可用取决于数据源支持情况,资料未明确说明。