# ranaroussi/yfinance

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/ranaroussi-yfinance).**

21,639 stars · 3,090 forks · Python · apache-2.0

## Links

- GitHub: https://github.com/ranaroussi/yfinance
- Homepage: https://ranaroussi.github.io/yfinance
- awesome-repositories: https://awesome-repositories.com/repository/ranaroussi-yfinance.md

## Topics

`financial-data` `fix-yahoo-finance` `market-data` `pandas` `python` `stock-data` `yahoo-finance` `yahoo-finance-api`

## Description

This library is a Python-based tool for retrieving historical and real-time financial market data from public sources. It functions as a programmatic interface for downloading stock prices, dividends, financial statements, and corporate calendars, allowing users to perform automated research and analysis on various market assets.

The project distinguishes itself by structuring retrieved financial time series directly into tabular data frames, which facilitates mathematical analysis and manipulation of market metrics. It supports efficient data retrieval through multi-threaded batch downloading and lazy-loading object proxying, which minimizes unnecessary network requests by fetching asset attributes only when they are accessed.

Beyond basic price retrieval, the library provides capabilities for derivative pricing analysis by extracting call and put option chains, as well as investment portfolio tracking through the retrieval of fund details and top holdings. Users can also search for ticker symbols, screen equities based on custom criteria, and establish persistent connections to monitor live market activity.

## Tags

### Data & Databases

- [Market Data Providers](https://awesome-repositories.com/f/data-databases/market-data-providers.md) — Provides a Python library for retrieving historical and real-time financial data and fundamental metrics. ([source](https://cdn.jsdelivr.net/gh/ranaroussi/yfinance@main/README.md))
- [Financial Data Connectors](https://awesome-repositories.com/f/data-databases/financial-data-connectors.md) — Facilitates the retrieval of historical and real-time market data, fundamental metrics, and option chains from public financial sources.
- [Fundamental Data Retrieval](https://awesome-repositories.com/f/data-databases/fundamental-data-retrieval.md) — Fetches fundamental metrics and historical price data for individual financial assets using ticker symbols. ([source](https://ranaroussi.github.io/yfinance))
- [Market Data Access APIs](https://awesome-repositories.com/f/data-databases/market-data-access-apis.md) — Establishes persistent connections to receive real-time price updates and market activity. ([source](https://cdn.jsdelivr.net/gh/ranaroussi/yfinance@main/README.md))
- [Time Series Analysis Tools](https://awesome-repositories.com/f/data-databases/time-series-analysis-tools.md) — Structures financial time series into tabular formats to enable efficient calculation and manipulation of market metrics.
- [Derivative Option Chains](https://awesome-repositories.com/f/data-databases/derivative-option-chains.md) — Extracts call and put option chains to analyze market sentiment and calculate derivative pricing. ([source](https://ranaroussi.github.io/yfinance))
- [Fund Composition Data](https://awesome-repositories.com/f/data-databases/information-retrieval/fund-composition-data.md) — Fetches descriptive information and top holdings for exchange-traded and mutual funds. ([source](https://ranaroussi.github.io/yfinance))
- [Tabular Data Frames](https://awesome-repositories.com/f/data-databases/time-series-data-modeling/tabular-data-frames.md) — Structures retrieved financial time series into tabular data frames to facilitate efficient mathematical analysis.
- [Data Scraping Tools](https://awesome-repositories.com/f/data-databases/data-scraping-tools.md) — Programmatically extracts structured financial data from raw HTML and JSON web responses.
- [Equity Screeners](https://awesome-repositories.com/f/data-databases/market-data-providers/equity-screeners.md) — Identifies specific financial assets by applying custom criteria to build personalized investment lists. ([source](https://cdn.jsdelivr.net/gh/ranaroussi/yfinance@main/README.md))

### Business & Productivity Software

- [Investment Research Terminals](https://awesome-repositories.com/f/business-productivity-software/financial-operational-management/billing-financial-systems/financial-analysis-tools/investment-research-terminals.md) — Provides an integrated programmatic interface for querying financial market data and performing quantitative analysis on equities and funds.
- [Portfolio Trackers](https://awesome-repositories.com/f/business-productivity-software/financial-operational-management/billing-financial-systems/financial-analysis-tools/investment-research-terminals/portfolio-trackers.md) — Monitors the composition and performance metrics of exchange-traded and mutual funds.
- [Derivative Pricing Models](https://awesome-repositories.com/f/business-productivity-software/price-list-management/derivative-pricing-models.md) — Calculates derivative pricing models using extracted call and put option chains.

### System Administration & Monitoring

- [Market Insight Monitors](https://awesome-repositories.com/f/system-administration-monitoring/market-insight-monitors.md) — Tracks financial fluctuations through persistent connections for real-time market monitoring.

### Artificial Intelligence & ML

- [Automated Research Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/automated-research-frameworks.md) — Automates the querying of ticker symbols and corporate calendars for financial research.