ranaroussi /yfinance

Download market data from Yahoo! Finance's API

★ 25,928⑂ 3,497👁 269⑃ 1,068● 1,733▤ 116
PythonApache-2.0Created 2017-05-21ranaroussi.github.io/yfinance
下载:1.8.01.8.0 ↓1.8.02026-11-03
+10
日增长
+118
周增长
+446
月增长
25,928
stars
3,497
forks
269
watchers
1,068
prs
1,733
issues
116
releases

README

Download market data from Yahoo! Finance's API










yfinance offers a Pythonic way to fetch financial & market data from Yahoo!Ⓡ finance.

---

 [!IMPORTANT]  
 Yahoo!, Y!Finance, and Yahoo! finance are registered trademarks of Yahoo, Inc.

 yfinance is not affiliated, endorsed, or vetted by Yahoo, Inc. It's an open-source tool that uses Yahoo's publicly available APIs, and is intended for research and educational purposes.
 
 You should refer to Yahoo!'s terms of use (here, here, and here) for details on your rights to use the actual data downloaded.

 Remember - the Yahoo! finance API is intended for personal use only.

---

 [!TIP]
 THE NEW DOCUMENTATION WEBSITE IS NOW LIVE! 🤘
 
 Visit ranaroussi.github.io/yfinance

---

 Main components

- Ticker: single ticker data
- Tickers: multiple tickers' data
- download: download market data for multiple tickers
- Market: get information about a market
- WebSocket and AsyncWebSocket: live streaming data
- Search: quotes and news from search
- Sector and Industry: sector and industry information
- EquityQuery and Screener: build query to screen market

 [!NOTE]
 Prices are default adjusted for dividends (auto_adjust=True).

 Installation

Install yfinance from PYPI using pip:

 {.sourceCode .bash}
$ pip install yfinance


To install without curl_cffi for requests fallback, see Advanced ▸ Installation.

 yfinance relies on the community to investigate bugs and contribute code. Here's how you can help.

---

!Star History Chart

---

 Legal Stuff

yfinance is distributed under the Apache Software License. See
the LICENSE.txt file in the release for details.

AGAIN - yfinance is not affiliated, endorsed, or vetted by Yahoo, Inc. It's
an open-source tool that uses Yahoo's publicly available APIs, and is
intended for research and educational purposes. You should refer to Yahoo!'s terms of use
(here,
here, and
here) for
details on your rights to use the actual data downloaded.

---

 P.S.

Please drop me a note with any feedback you have.

Ran Aroussi

Top issues

Discussions

Latest release

1.8.0 1.8.0 2026-11-03
Features

- Force curl_cffi = 0.17 for security updates
- Tickers.calendar and Tickers.info (use at your own risk of being spam-blocked)
- Add methodology to EPS
- Price-split-repair improvement

Lots of fixes! Full changelog 3016 

Thanks @dwaddle @heykav @idpfaff @jackiectl2 @LeonxLJX @louis75aubin-prog @mehdyhaghy @monody0007 @ryanduguid @Shawn-Kim96 @spicysharkco @WatchTree-19 @wavebyrd

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON