# ranaroussi/yfinance

Download market data from Yahoo! Finance's API

Repository: https://github.com/ranaroussi/yfinance
Canonical: https://ross.abutalabs.com/products/yfinance
Homepage: https://ranaroussi.github.io/yfinance
Language: Python
License: Apache-2.0
License Family: permissive
Topics: python, pandas, yahoo-finance-api, yahoo-finance, stock-data, market-data, financial-data, fix-yahoo-finance
Last push: 2026-08-26T17:23:40+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 99, longevity 100
- inputs: {"age_days": 3391, "days_push": 7, "days_rel": 7, "gap_med": 15.5, "n_releases_24m": 35}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 25084, forks 3407 (observed 2026-08-28T04:11:37.841867+00:00)

## What it is
yfinance is a Python library that fetches financial and market data from Yahoo! Finance's publicly available APIs, returning data as pandas DataFrames. It supports ticker history, fundamentals, options, funds, screener queries, and live WebSocket streaming.

## Use cases
- download historical stock prices into pandas
- get company fundamentals and financial statements
- fetch options chains for a ticker
- stream live market quotes
- screen stocks by sector and industry
- download data for multiple tickers at once

## When to choose
- you need quick programmatic access to Yahoo Finance market data in Python
- you want pandas-friendly DataFrames for research or backtesting
- you need fundamentals, options, or screener data without an API key

## When to avoid
- you need guaranteed SLA or commercial licensing for market data
- you require real-time exchange-grade data feeds
- your use case must strictly comply with Yahoo's personal-use API terms

## Facets
- artifact type: library
- maturity: stable
- function: http-client, data-science, analytics
- domain: fintech, data-science, apis
- platform: python, cross-platform
- tags: yahoo-finance, market-data, stocks, pandas, financial-data, trading

## Member repositories
- ranaroussi/yfinance (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:37.841867+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:56:06.457865+00:00, confidence not recorded.
  - readme: https://github.com/ranaroussi/yfinance (fetched 2026-08-28T04:11:37.841867+00:00, sha 02a8fcce97d4)
  - homepage: https://ranaroussi.github.io/yfinance (fetched 2026-08-29T07:53:06.945310+00:00, sha d6d4628e1f3f)
  - registry_pypi: https://pypi.org/pypi/yfinance/json (fetched 2026-08-29T07:53:06.954308+00:00, sha 452492b3eaa9)
- Data as of 2026-08-30T08:39:29.467469+00:00.