https://github.com/ranaroussi/yfinance

Download market data from Yahoo! Finance's API
https://github.com/ranaroussi/yfinance

financial-data fix-yahoo-finance market-data pandas python stock-data yahoo-finance yahoo-finance-api

Last synced: 5 days ago
JSON representation

Download market data from Yahoo! Finance's API

• Host: GitHub
• URL: https://github.com/ranaroussi/yfinance
• Owner: ranaroussi
• License: apache-2.0
• Created: 2017-05-21T10:16:15.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2024-10-22T17:55:03.000Z (3 months ago)
• Last Synced: 2024-10-23T04:28:48.975Z (3 months ago)
• Topics: financial-data, fix-yahoo-finance, market-data, pandas, python, stock-data, yahoo-finance, yahoo-finance-api
• Language: Python
• Homepage: https://aroussi.com/post/python-yahoo-finance
• Size: 2.83 MB
• Stars: 13,720
• Watchers: 244
• Forks: 2,368
• Open Issues: 178
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.rst
  • Funding: .github/FUNDING.yml
  • License: LICENSE.txt
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-quant-cn - yfinace - - yahoo财经 (金融数据)
• awesome-systematic-trading - yfinance - with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg) | (Data Sources / General)
• awesome-systematic-trading - yfinance - yfinance offers a threaded and Pythonic way to download market data from Yahoo!Ⓡ finance. (Data Source / Stocks and General)
• awesome-python-machine-learning-resources - GitHub - 56% open · ⏱️ 11.07.2022): (金融数据处理)
• awesome-data - Yfinance
• Awesome_AI4Finance - yfinance
• awesome-quant - yfinance - Yahoo! Finance market data downloader (+faster Pandas Datareader) (Python / Data Sources)
• StarryDivineSky - ranaroussi/yfinance
• awesome - ranaroussi/yfinance - Download market data from Yahoo! Finance's API (Python)
• pytrade.org - yfinance - Download market data from Yahoo! Finance's API (Curated List / Data Libraries)
• awesome-finance - yfinance - Yahoo Finance market data downloader (Libraries & SDKs / Python)
• awesome-finance - yfinance - Yahoo Finance market data downloader (Libraries & SDKs / Python)

README

        
# 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](https://policies.yahoo.com/us/en/yahoo/terms/product-atos/apiforydn/index.htm),

[here](https://legal.yahoo.com/us/en/yahoo/terms/otos/index.html), and

[here](https://policies.yahoo.com/us/en/yahoo/terms/index.htm)) **for

details on your rights to use the actual data downloaded. Remember - the

Yahoo! finance API is intended for personal use only.**

---















**yfinance** offers a Pythonic way to fetch financial & market data from [Yahoo!Ⓡ finance](https://finance.yahoo.com).

## Main components

- `Ticker`: single ticker data

- `Tickers`: multiple tickers' data

- `download`: download market data for multiple tickers

- `Market`: get infomation about a market

- `Search`: quotes and news from search

- `Sector` and `Industry`: sector and industry information

- `EquityQuery` and `Screener`: build query to screen market

## **NEW DOCUMENTATION WEBSITE**: [ranaroussi.github.io/yfinance](https://ranaroussi.github.io/yfinance/index.html)

## Installation

Install `yfinance` from PYPI using `pip`:

``` {.sourceCode .bash}

$ pip install yfinance

```

The list of changes can be found in the [Changelog](https://github.com/ranaroussi/yfinance/blob/main/CHANGELOG.rst)

## Developers: want to contribute?

`yfinance` relies on community to investigate bugs, review code, and contribute code. Developer guide: https://github.com/ranaroussi/yfinance/discussions/1084

---

### Legal Stuff

**yfinance** is distributed under the **Apache Software License**. See

the [LICENSE.txt](./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](https://policies.yahoo.com/us/en/yahoo/terms/product-atos/apiforydn/index.htm),

[here](https://legal.yahoo.com/us/en/yahoo/terms/otos/index.html), and

[here](https://policies.yahoo.com/us/en/yahoo/terms/index.htm)) 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**