Skip to main content

A library to retrieve data from Yahoo Finance

Project description

Yahoo Finance Data for Python

Build Status

Documentation Status

Python module to get data readily available from Yahoo Finance. The data is retrieved directly from the website with no data changes.

Warning: This package is undergoing development and implementation and interfaces may change drastically without notice.

Note: There is no guarantee that the data provided in this library is correct. Use at your own risk.


You can install the library using:

pip install yahoofinance

Note: There are a few packages with a similar name, make sure you type the right package name - yahoofinance


To export the Profile data to CSV, it is simple!

If we are looking to export Apple's Asset Profile we can do the following:

>>> import yahoofinance as yf
>>> profile = yf.AssetProfile('AAPL')
>>> profile.to_csv('AAPL-profile.csv')

You can now find the profile information in a CSV file called AAPL-profile.csv.

Next steps include exporting other to a Pandas Dataframe, which would be the main reason why this project exists!

Optional Usage

We can add in a locale to choose a specific region to query from. For example, from Australia, we can query from the Australian Yahoo Finance website to get marginally faster query times. Using the Asset Profile example previously:

>>> import yahoofinance as yf
>>> profile = yd.AssetProfile('AAPL', locale=Locale.AU)
>>> profile.to_csv('AAPL-profile.csv')

Current locales include:

  • Locale.AU (Australia)
  • Locale.CA (Canada)
  • Locale.US (United States)

Example Use Case

You can find an example use case in the following Google Colab notebook:


You can find the documentation here:


  1. Why did you make this? I felt that financial data information is often restricted.

  2. Can you make custom data manipulation filters to make the data more tailored to my use? I do not intend to. My ethos is to enable financial data users to retrieve the data and use it their own way. I do not want to steal the data provided and make my own flavour.

  3. What happens when their website data changes and/or this project breaks? Let me know with a feature request and I'll do my best to fix it. Or even better, fork and make a pull request!

  4. I want to contribute to this amazing project! Fork and make a pull request!

  5. I like you, I want to support you financially. I don't have a support link yet (because this project just started), but if enough people are interested, I'll set one up someday.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for yahoofinance, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size yahoofinance-0.0.2-py3-none-any.whl (18.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size yahoofinance-0.0.2.tar.gz (12.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page