Alice — an open-source AI trading bot covering equities, crypto, commodities, forex, and macro
| 1 | """Market data fetching and caching.""" |
| 2 | |
| 3 | from __future__ import annotations |
| 4 | |
| 5 | import pandas as pd |
| 6 | import yfinance as yf |
| 7 | |
| 8 | |
| 9 | def fetch_ohlcv( |
| 10 | symbol: str, |
| 11 | period: str = "1y", |
| 12 | interval: str = "1d", |
| 13 | ) -> pd.DataFrame: |
| 14 | """Fetch OHLCV data for a symbol via yfinance. |
| 15 | |
| 16 | Args: |
| 17 | symbol: Ticker symbol (e.g. "AAPL", "BTC-USD"). |
| 18 | period: Data period ("1mo", "3mo", "6mo", "1y", "2y", "5y", "10y", "ytd", "max"). |
| 19 | interval: Bar interval ("1m", "5m", "15m", "1h", "1d", "1wk", "1mo"). |
| 20 | |
| 21 | Returns: |
| 22 | DataFrame with columns: Open, High, Low, Close, Volume. |
| 23 | """ |
| 24 | ticker = yf.Ticker(symbol) |
| 25 | raw = ticker.history(period=period, interval=interval, auto_adjust=True) |
| 26 | if raw.empty: |
| 27 | raise ValueError(f"No data returned for symbol: {symbol}") |
| 28 | df = pd.DataFrame(raw) |
| 29 | df.index = pd.DatetimeIndex(df.index).tz_localize(None) |
| 30 | return df |
| 31 | |
| 32 | |
| 33 | def add_returns(df: pd.DataFrame) -> pd.DataFrame: |
| 34 | """Add a simple daily returns column.""" |
| 35 | result = df.copy() |
| 36 | result["Return"] = result["Close"].pct_change() |
| 37 | return result |