yfinance
A Python library for downloading market data from Yahoo! Finance's public API.
What is yfinance?
yfinance is a Python library that provides a programmatic interface to download financial market data from Yahoo! Finance. It solves the problem of accessing historical stock prices, company information, and market metrics through a clean Python API instead of manual web scraping or using complex financial data services.
Python developers, quantitative analysts, researchers, and students who need reliable access to financial market data for analysis, backtesting trading strategies, or educational projects.
Developers choose yfinance because it offers a simple, well-documented Pythonic interface to Yahoo! Finance's data that's free to use, actively maintained by the community, and supports both historical data downloads and real-time streaming capabilities.
Overview
Download market data from Yahoo! Finance's API
Use Cases
Best For
- Downloading historical stock price data for backtesting trading algorithms
- Building financial dashboards that display market data
- Research projects requiring bulk financial data collection
- Educational tools for teaching financial analysis with Python
- Creating custom stock screeners and market scanners
- Developing quantitative finance models that need reliable price data
Not Ideal For
- Projects requiring high-frequency, institutional-grade data feeds with guaranteed uptime
- Commercial applications that need licensed financial data for compliance and legal safety
- Systems where API stability and official vendor support are critical for production use
- Real-time trading algorithms needing millisecond-precision data with low latency
Pros & Cons
Pros
Provides intuitive classes like Ticker and Tickers that abstract HTTP requests, allowing data fetching with minimal code, as shown in the clean API examples in the README.
Supports historical prices, dividends, splits, real-time streaming via WebSocket, and market screening tools, covering most financial analysis needs without requiring multiple libraries.
With high PyPI download counts and regular updates, the library is well-maintained by contributors, and the new documentation website indicates ongoing development.
Unlike paid services, yfinance is completely free to use and modify, lowering barriers for research and education, as emphasized in its Apache license.
Cons
Relies on Yahoo's publicly available APIs which can change or break without notice, leading to unexpected issues, as warned in the legal disclaimers about non-affiliation.
The README explicitly states it's for personal use only per Yahoo's terms, making it risky for commercial applications without proper licensing.
As a free service, data accuracy and timeliness are not guaranteed, which can impact sensitive financial decisions or backtesting results.
Frequently Asked Questions
Related Projects
openbbOpen Data Platform for analysts, quants and AI agents.
PathwayPython ETL framework for stream processing, real-time analytics, LLM pipelines, and RAG.
pandasFlexible and powerful data analysis / manipulation library for Python, providing labeled data structures similar to R data.frame objects, statistical functions, and much more
polarsExtremely fast Query Engine for DataFrames, written in Rust
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.