yfinance documentation#

Download Market Data from Yahoo! Finance’s API#

IMPORTANT LEGAL DISCLAIMER

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.

Install#

$ pip install yfinance

Quick start#

Showing a small sample of yfinance API, the full API is much bigger and covered in API Reference.

import yfinance as yf
dat = yf.Ticker("MSFT")

One ticker symbol

dat = yf.Ticker("MSFT")
dat.info
dat.calendar
dat.analyst_price_targets
dat.quarterly_income_stmt
dat.history(period='1mo')
dat.option_chain(dat.options[0]).calls

Multiple ticker symbols

tickers = yf.Tickers('MSFT AAPL GOOG')
tickers.tickers['MSFT'].info
yf.download(['MSFT', 'AAPL', 'GOOG'], period='1mo')

Funds

spy = yf.Ticker('SPY').funds_data
spy.description
spy.top_holdings