# Download market data from Yahoo! Finance's API
<table border=1 cellpadding=10><tr><td>
#### \*\*\* 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.**
</td></tr></table>
---
<a target="new" href="https://pypi.python.org/pypi/yfinance"><img border=0 src="https://img.shields.io/badge/python-2.7,%203.6+-blue.svg?style=flat" alt="Python version"></a>
<a target="new" href="https://pypi.python.org/pypi/yfinance"><img border=0 src="https://img.shields.io/pypi/v/yfinance.svg?maxAge=60%" alt="PyPi version"></a>
<a target="new" href="https://pypi.python.org/pypi/yfinance"><img border=0 src="https://img.shields.io/pypi/status/yfinance.svg?maxAge=60" alt="PyPi status"></a>
<a target="new" href="https://pypi.python.org/pypi/yfinance"><img border=0 src="https://img.shields.io/pypi/dm/yfinance.svg?maxAge=2592000&label=installs&color=%2327B1FF" alt="PyPi downloads"></a>
<a target="new" href="https://www.codefactor.io/repository/github/ranaroussi/yfinance"><img border=0 src="https://www.codefactor.io/repository/github/ranaroussi/yfinance/badge" alt="CodeFactor"></a>
<a target="new" href="https://github.com/ranaroussi/yfinance"><img border=0 src="https://img.shields.io/github/stars/ranaroussi/yfinance.svg?style=social&label=Star&maxAge=60" alt="Star this repo"></a>
<a target="new" href="https://twitter.com/aroussi"><img border=0 src="https://img.shields.io/twitter/follow/aroussi.svg?style=social&label=Follow&maxAge=60" alt="Follow me on twitter"></a>
**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**
Raw data
{
"_id": null,
"home_page": "https://github.com/ranaroussi/yfinance",
"name": "yfinance",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "pandas, yahoo finance, pandas datareader",
"author": "Ran Aroussi",
"author_email": "ran@aroussi.com",
"download_url": "https://files.pythonhosted.org/packages/26/97/68270531d9f1bc62a50970f8860633baa013ac2fe9464c9ae5b3be675ddb/yfinance-0.2.52.tar.gz",
"platform": "any",
"description": "# Download market data from Yahoo! Finance's API\n\n<table border=1 cellpadding=10><tr><td>\n\n#### \\*\\*\\* IMPORTANT LEGAL DISCLAIMER \\*\\*\\*\n\n---\n\n**Yahoo!, Y!Finance, and Yahoo! finance are registered trademarks of\nYahoo, Inc.**\n\nyfinance is **not** affiliated, endorsed, or vetted by Yahoo, Inc. It's\nan open-source tool that uses Yahoo's publicly available APIs, and is\nintended for research and educational purposes.\n\n**You should refer to Yahoo!'s terms of use**\n([here](https://policies.yahoo.com/us/en/yahoo/terms/product-atos/apiforydn/index.htm),\n[here](https://legal.yahoo.com/us/en/yahoo/terms/otos/index.html), and\n[here](https://policies.yahoo.com/us/en/yahoo/terms/index.htm)) **for\ndetails on your rights to use the actual data downloaded. Remember - the\nYahoo! finance API is intended for personal use only.**\n\n</td></tr></table>\n\n---\n\n<a target=\"new\" href=\"https://pypi.python.org/pypi/yfinance\"><img border=0 src=\"https://img.shields.io/badge/python-2.7,%203.6+-blue.svg?style=flat\" alt=\"Python version\"></a>\n<a target=\"new\" href=\"https://pypi.python.org/pypi/yfinance\"><img border=0 src=\"https://img.shields.io/pypi/v/yfinance.svg?maxAge=60%\" alt=\"PyPi version\"></a>\n<a target=\"new\" href=\"https://pypi.python.org/pypi/yfinance\"><img border=0 src=\"https://img.shields.io/pypi/status/yfinance.svg?maxAge=60\" alt=\"PyPi status\"></a>\n<a target=\"new\" href=\"https://pypi.python.org/pypi/yfinance\"><img border=0 src=\"https://img.shields.io/pypi/dm/yfinance.svg?maxAge=2592000&label=installs&color=%2327B1FF\" alt=\"PyPi downloads\"></a>\n<a target=\"new\" href=\"https://www.codefactor.io/repository/github/ranaroussi/yfinance\"><img border=0 src=\"https://www.codefactor.io/repository/github/ranaroussi/yfinance/badge\" alt=\"CodeFactor\"></a>\n<a target=\"new\" href=\"https://github.com/ranaroussi/yfinance\"><img border=0 src=\"https://img.shields.io/github/stars/ranaroussi/yfinance.svg?style=social&label=Star&maxAge=60\" alt=\"Star this repo\"></a>\n<a target=\"new\" href=\"https://twitter.com/aroussi\"><img border=0 src=\"https://img.shields.io/twitter/follow/aroussi.svg?style=social&label=Follow&maxAge=60\" alt=\"Follow me on twitter\"></a>\n\n**yfinance** offers a Pythonic way to fetch financial & market data from [Yahoo!\u24c7 finance](https://finance.yahoo.com).\n\n## Main components\n\n- `Ticker`: single ticker data\n- `Tickers`: multiple tickers' data\n- `download`: download market data for multiple tickers\n- `Market`: get infomation about a market\n- `Search`: quotes and news from search\n- `Sector` and `Industry`: sector and industry information\n- `EquityQuery` and `Screener`: build query to screen market\n\n## **NEW DOCUMENTATION WEBSITE**: [ranaroussi.github.io/yfinance](https://ranaroussi.github.io/yfinance/index.html)\n\n## Installation\n\nInstall `yfinance` from PYPI using `pip`:\n\n``` {.sourceCode .bash}\n$ pip install yfinance\n```\n\nThe list of changes can be found in the [Changelog](https://github.com/ranaroussi/yfinance/blob/main/CHANGELOG.rst)\n\n## Developers: want to contribute?\n\n`yfinance` relies on community to investigate bugs, review code, and contribute code. Developer guide: https://github.com/ranaroussi/yfinance/discussions/1084\n\n---\n\n### Legal Stuff\n\n**yfinance** is distributed under the **Apache Software License**. See\nthe [LICENSE.txt](./LICENSE.txt) file in the release for details.\n\nAGAIN - yfinance is **not** affiliated, endorsed, or vetted by Yahoo, Inc. It's\nan open-source tool that uses Yahoo's publicly available APIs, and is\nintended for research and educational purposes. You should refer to Yahoo!'s terms of use\n([here](https://policies.yahoo.com/us/en/yahoo/terms/product-atos/apiforydn/index.htm),\n[here](https://legal.yahoo.com/us/en/yahoo/terms/otos/index.html), and\n[here](https://policies.yahoo.com/us/en/yahoo/terms/index.htm)) for\ndetails on your rights to use the actual data downloaded.\n\n---\n\n### P.S.\n\nPlease drop me a note with any feedback you have.\n\n**Ran Aroussi**\n\n",
"bugtrack_url": null,
"license": "Apache",
"summary": "Download market data from Yahoo! Finance API",
"version": "0.2.52",
"project_urls": {
"Homepage": "https://github.com/ranaroussi/yfinance"
},
"split_keywords": [
"pandas",
" yahoo finance",
" pandas datareader"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8d519f26741aeeb149fe75b30bceee389cf9920f9458d0f213539398aa217b99",
"md5": "8fcf060a190705c4e885d26ff7ee9500",
"sha256": "3ca150da85f56b999687e13b72304338499a417d5bad6af9da2aa13821992bd7"
},
"downloads": -1,
"filename": "yfinance-0.2.52-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "8fcf060a190705c4e885d26ff7ee9500",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 108479,
"upload_time": "2025-01-18T16:23:18",
"upload_time_iso_8601": "2025-01-18T16:23:18.588285Z",
"url": "https://files.pythonhosted.org/packages/8d/51/9f26741aeeb149fe75b30bceee389cf9920f9458d0f213539398aa217b99/yfinance-0.2.52-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "269768270531d9f1bc62a50970f8860633baa013ac2fe9464c9ae5b3be675ddb",
"md5": "1c520737740e998832ac238a79a4db2e",
"sha256": "d2c2ed9bc935596934cba99fca0f05beaa8384648f78105c77754e92f11bf72f"
},
"downloads": -1,
"filename": "yfinance-0.2.52.tar.gz",
"has_sig": false,
"md5_digest": "1c520737740e998832ac238a79a4db2e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 117683,
"upload_time": "2025-01-18T16:23:20",
"upload_time_iso_8601": "2025-01-18T16:23:20.834933Z",
"url": "https://files.pythonhosted.org/packages/26/97/68270531d9f1bc62a50970f8860633baa013ac2fe9464c9ae5b3be675ddb/yfinance-0.2.52.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-18 16:23:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ranaroussi",
"github_project": "yfinance",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pandas",
"specs": [
[
">=",
"1.3.0"
]
]
},
{
"name": "numpy",
"specs": [
[
">=",
"1.16.5"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.31"
]
]
},
{
"name": "multitasking",
"specs": [
[
">=",
"0.0.7"
]
]
},
{
"name": "lxml",
"specs": [
[
">=",
"4.9.1"
]
]
},
{
"name": "platformdirs",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "pytz",
"specs": [
[
">=",
"2022.5"
]
]
},
{
"name": "frozendict",
"specs": [
[
">=",
"2.3.4"
]
]
},
{
"name": "beautifulsoup4",
"specs": [
[
">=",
"4.11.1"
]
]
},
{
"name": "html5lib",
"specs": [
[
">=",
"1.1"
]
]
},
{
"name": "peewee",
"specs": [
[
">=",
"3.16.2"
]
]
},
{
"name": "requests_cache",
"specs": [
[
">=",
"1.0"
]
]
},
{
"name": "requests_ratelimiter",
"specs": [
[
">=",
"0.3.1"
]
]
},
{
"name": "scipy",
"specs": [
[
">=",
"1.6.3"
]
]
}
],
"lcname": "yfinance"
}
JSON
