data.sources.yfinance

data.sources.yfinance

Yahoo Finance market data source (stocks, ETFs, indices).

ohlc = q.data.sources.yfinance.read(“AAPL”, “2024-01-01”, “2025-01-01”, “1d”)

Functions

Name Description
read Fetch OHLCV bars from Yahoo Finance (cached locally as parquet).

read

data.sources.yfinance.read(
    symbols,
    start_date,
    end_date,
    time_interval='1D',
    cache_dir=DEFAULT_CACHE_DIR,
)

Fetch OHLCV bars from Yahoo Finance (cached locally as parquet).

Fetched data is cached as parquet files named like {symbol}-{interval}-{start}-{end}.parquet under cache_dir, so repeated requests for the same range don’t hit the network. Only intervals supported by Yahoo are available (e.g. 1m, 5m, 1h, 1D); intraday data is limited to recent history by Yahoo.

Parameters

Name Type Description Default
symbols str | list[str] A single symbol, or a list of symbols. required
start_date str | datetime Start date (inclusive), YYYY-MM-DD or datetime. required
end_date str | datetime End date (inclusive), YYYY-MM-DD or datetime. required
time_interval str Pandas offset alias (e.g. "1h", "5min", "1D"). '1D'
cache_dir str | Path Directory for parquet OHLC caches. DEFAULT_CACHE_DIR

Returns

Name Type Description
pd.DataFrame | dict[str, pd.DataFrame] A single DataFrame if symbols is a string, otherwise a dict of
pd.DataFrame | dict[str, pd.DataFrame] DataFrames keyed by symbol (failed symbols are skipped with a
pd.DataFrame | dict[str, pd.DataFrame] warning, with a progress bar shown).
Back to top