yfinance

Download market data from Yahoo! Finance API

yfinance Permissive license Apache-2.0 Active ★ 24,985 v1.6.0 released 2026-08-13

Install

yfinance on PyPI

pip

pip install yfinance

uv

uv add yfinance

poetry

poetry add yfinance

Package facts

License	Apache-2.0 (permissive)
Python support	not specified
Install friction	low — pure-Python wheel
Runtime dependencies	12 — beautifulsoup4, curl_cffi, lxml, multitasking, numpy, pandas, peewee, platformdirs, protobuf, pytz, requests, websockets
Maintenance	actively maintained — 0 days since the last release
Last repo commit	2026-08-13
First released	2019-05-26
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: yfinance-1.6.0-py3-none-any.whl

Keywords: pandas, yahoo finance, pandas datareader

Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Office/Business :: FinancialTopic :: Office/Business :: Financial :: InvestmentTopic :: Scientific/Engineering :: Interface Engine/Protocol TranslatorTopic :: Software Development :: LibrariesTopic :: Software Development :: Libraries :: Python Modules

About yfinance

from the package's own PyPI description — quoted content, verbatim

Download market data from Yahoo! Finance's API

<a target="new" href="https://pypi.python.org/pypi/yfinance"><img border=0 src="https://img.shields.io/badge/python-2.7,%203.6+-blue.svg?style=flat" alt="Python version"></a> <a target="new" href="https://pypi.python.org/pypi/yfinance"><img border=0 src="https://img.shields.io/pypi/v/yfinance.svg?maxAge=60%" alt="PyPi version"></a> <a target="new" href="https://pypi.python.org/pypi/yfinance"><img border=0 src="https://img.shields.io/pypi/status/yfinance.svg?maxAge=60" alt="PyPi status"></a> <a target="new" href="https://pypi.python.org/pypi/yfinance"><img border=0 src="https://img.shields.io/pypi/dm/yfinance.svg?maxAge=86400&label=installs&color=%2327B1FF" alt="PyPi downloads"></a> <a target="new" href="https://github.com/ranaroussi/yfinance"><img border=0 src="https://img.shields.io/github/stars/ranaroussi/yfinance.svg?style=social&label=Star&maxAge=60" alt="Star this repo"></a> <a target="new" href="https://x.com/intent/follow?screen_name=aroussi"><img border=0...

Read as markdown · JSON record · Source repository · Homepage · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

yfinance fetches financial and market data from Yahoo! Finance's API, providing Pythonic access to ticker information, historical prices, and live streaming data for research and educational purposes.

Low friction: pure-Python wheel with 12 runtime dependencies. Active maintenance with recent release (2026-08-13) signals strong ongoing support.

Apache-2.0 permissive license allows commercial and private use with minimal restrictions. However, you must comply with Yahoo!'s terms of use for the underlying data, which restricts use to personal, research, and educational purposes.

Usage

pip install yfinance

import yfinance as yf
data = yf.Ticker('AAPL')
print(data.info)

Yahoo! Finance API is intended for personal use only; commercial use may violate Yahoo!'s terms of service.

Verdict: yfinance is actively maintained with strong community adoption (top_1000 tier, 24985 stars) and zero known vulnerabilities. Its permissive Apache-2.0 license poses no technical barrier, but users must independently verify compliance with Yahoo!'s terms of use, which restrict the data itself to personal and educational use.

Needs verification

Whether curl_cffi is required or optional for production use (documentation mentions fallback option)
Current rate-limiting or API stability guarantees from Yahoo! Finance
Whether the package actively maintains compatibility with Python 3.6–3.7 or has de facto dropped support

yahoo finance data downloadstock market data pythonticker price historyfinancial data api wrapperlive market data streamingstock quote fetchermarket data research