yfinance

1.2.0 · active · verified Sun Apr 05

yfinance is a popular open-source Python library designed to access and retrieve financial market data from Yahoo! Finance. It simplifies fetching historical prices, financial statements, dividends, splits, and other relevant information for stocks, indices, and securities. The library is actively maintained with frequent updates, enabling users to efficiently perform financial analyses and gain insights.

Warnings

breaking As of version 1.2.0, the DataFrame returned by `yf.history()` is consolidated, which might cause 'read-only' errors in existing code if you attempt to modify it in place.
Fix: If you need to modify the DataFrame, make a copy first: `df = yf.history().copy()` or use DataFrame methods that return a new DataFrame.
breaking Around version 0.2.51 (December 2024), the data structure for downloaded data changed, often introducing a Multi-Index DataFrame. Additionally, the explicit 'Adjusted Close' column was removed as Open, High, Low, and Close prices are now automatically adjusted for dividends and splits.
Fix: Adapt your code to handle Multi-Index DataFrames (e.g., using `.xs()` or `.droplevel()`) and rely on the automatically adjusted OHLC values. If migrating from older versions, verify your data processing logic.
deprecated Version 1.0 introduced deprecation warnings for the old configuration method.
Fix: Refer to the official yfinance documentation for the updated configuration methods (e.g., `https://ranaroussi.github.io/yfinance/advanced/config.html`).
gotcha yfinance is an unofficial library that scrapes data from Yahoo Finance. As such, its functionality is subject to breaking if Yahoo Finance changes its website layout or API endpoints. Issues like cookie reuse or DNS blocking have historically occurred.
Fix: Stay updated with the latest library versions and community discussions. Implement robust error handling (e.g., try-except blocks) in your code.
gotcha Intraday data (intervals less than 1 day) has significant limitations: 1-minute data is only available for the last 7 days, and any intraday interval data is only available for the last 60 days. End-of-day data typically has a much longer history.
Fix: Be aware of these time limitations when requesting intraday data. For longer historical periods, use daily or larger intervals.

Install

pip install yfinance Install latest version

Imports

yfinance
```
import yfinance as yf
```

Quickstart

This quickstart demonstrates how to download historical stock data for a given ticker symbol and how to access fundamental information about a company using the Ticker object.

import yfinance as yf
import pandas as pd

# Download historical data for a single ticker (e.g., Apple)
ticker_symbol = "AAPL"
data = yf.download(ticker_symbol, start="2023-01-01", end="2023-12-31")

print(f"Downloaded {len(data)} rows for {ticker_symbol}:")
print(data.head())

# Access information about a ticker
ticker = yf.Ticker(ticker_symbol)
info = ticker.info
print(f"\nMarket Cap for {ticker_symbol}: {info.get('marketCap')}")

view raw JSON →