---
id: yfinance
version: "1.6.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# yfinance — Download market data from Yahoo! Finance API

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install yfinance
uv add yfinance
poetry add yfinance

## Description

<img src="./doc/yfinance-gh-logo-dark.webp#gh-dark-mode-only" height="100">
<img src="./doc/yfinance-gh-logo-light.webp#gh-light-mode-only" height="100">

# 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...

## AI interpretation — verify before relying

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.

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.

[View on SkillFed](https://skillfed.io/packages/yfinance) · [View on PyPI](https://pypi.org/project/yfinance/)