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:

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

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

ranaroussi/yfinance

README