{"repo":"ranaroussi/yfinance","free":true,"listed":false,"github":"https://github.com/ranaroussi/yfinance","clone":"git clone https://github.com/ranaroussi/yfinance.git","description":"Download market data from Yahoo! Finance's API","language":"Python","stars":24997,"topics":["financial-data","fix-yahoo-finance","market-data","pandas","python","stock-data","yahoo-finance","yahoo-finance-api"],"license":"Apache-2.0","category":"quant_analysis","readme_excerpt":"\n\n\n# Download market data from Yahoo! Finance's API\n\n\"Python\n\"PyPi\n\"PyPi\n\"PyPi\n\"Star\n\"Follow\n\n\"ranaroussi%2Fyfinance\n\n**yfinance** offers a Pythonic way to fetch financial & market data from [Yahoo!Ⓡ finance](https://finance.yahoo.com).\n\n---\n\n> [!IMPORTANT] \n> **Yahoo!, Y!Finance, and Yahoo! finance are registered trademarks of Yahoo, Inc.**\n>\n> 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.\n> \n> **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.\n>\n> Remember - the Yahoo! finance API is intended for personal use only.**\n\n---\n\n> [!TIP]\n> THE NEW DOCUMENTATION WEBSITE IS NOW LIVE! 🤘\n> \n> Visit [**ranaroussi.github.io/yfinance**](https://ranaroussi.github.io/yfinance)\n\n---\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 information about a market\n- `WebSocket` and `AsyncWebSocket`: live streaming data\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## Installation\n\nInstall `yfinance` from PYPI using `pip`:\n\n``` {.sourceCode .bash}\n$ pip install yfinance\n```\n\nTo install without `curl_cffi` for requests fallback, see [Advanced ▸ Installation](https://ranaroussi.github.io/yfinance/advanced/install.html).\n\n### [yfinance relies on the community to investigate bugs and contribute code. Here's how you can help.](https://github.com/ranaroussi/yfinance/blob/main/CONTRIBUTING.md)\n\n---\n\n![Star History Chart](https://api.star-history.com/svg?repos=ranaroussi/yfinance)\n\n---\n\n### Legal Stuff\n\n**yfinance** is distributed under the **Apache Software License**. See\nthe [LICENSE.txt](https://github.com/ranaroussi/yfinance/blob/main/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","default_branch":"main","files":219,"tree":[".github/FUNDING.yml",".github/ISSUE_TEMPLATE/bug_report.yaml",".github/dependabot.yml",".github/workflows/auto_close_default_issues.yml",".github/workflows/deploy_doc.yml",".github/workflows/pyright.yml",".github/workflows/pytest.yml.disabled",".github/workflows/python-publish.yml",".github/workflows/ruff.yml",".github/workflows/zizmor.yml",".gitignore",".travis.yml","CHANGELOG.md","CHANGELOG.rst","CODE_OF_CONDUCT.md","CONTRIBUTING.md","LICENSE.txt","README.md","doc/Makefile","doc/make.bat","doc/source/_static/images/repair-prices-100x.png","doc/source/_static/images/repair-prices-missing-div-adjust.png","doc/source/_static/images/repair-prices-missing-row.png","doc/source/_static/images/repair-prices-missing-split-adjust.png","doc/source/_static/images/repair-prices-missing-volume-daily.png","doc/source/_static/images/repair-prices-missing-volume-intraday.png","doc/source/_static/logo-dark.webp","doc/source/_static/logo-light.webp","doc/source/_static/yfinance.css","doc/source/_templates/autosummary/class.rst","doc/source/advanced/caching.rst","doc/source/advanced/config.rst","doc/source/advanced/index.rst","doc/source/advanced/install.rst","doc/source/advanced/logging.rst","doc/source/advanced/multi_level_columns.rst","doc/source/advanced/price_repair.rst","doc/source/conf.py","doc/source/development/assets/branches.png","doc/source/development/code.rst","doc/source/development/documentation.rst","doc/source/development/index.rst","doc/source/development/running.rst","doc/source/development/testing.rst","doc/source/index.rst","doc/source/reference/examples/auth.py","doc/source/reference/examples/calendars.py","doc/source/reference/examples/download.py","doc/source/reference/examples/funds_data.py","doc/source/reference/examples/live_async.py","doc/source/reference/examples/live_sync.py","doc/source/reference/examples/lookup.py","doc/source/reference/examples/market.py","doc/source/reference/examples/proxy.py","doc/source/reference/examples/search.py","doc/source/reference/examples/sector_industry.py","doc/source/reference/examples/sector_industry_ticker.py","doc/source/reference/examples/ticker.py","doc/source/reference/examples/tickers.py","doc/source/reference/index.rst","doc/source/reference/yfinance.analysis.rst","doc/source/reference/yfinance.auth.rst","doc/source/reference/yfinance.calendars.rst","doc/source/reference/yfinance.financials.rst","doc/source/reference/yfinance.functions.rst","doc/source/reference/yfinance.funds_data.rst","doc/source/reference/yfinance.market.rst","doc/source/reference/yfinance.price_history.rst","doc/source/reference/yfinance.screener.rst","doc/source/reference/yfinance.search.rst","doc/source/reference/yfinance.sector_industry.rst","doc/source/reference/yfinance.stock.rst","doc/source/reference/yfinance.ticker_tickers.rst","doc/source/reference/yfinance.websocket.rst","doc/yfinance-gh-icon-dark.webp","doc/yfinance-gh-icon-light.webp","doc/yfinance-gh-logo-dark.webp","doc/yfinance-gh-logo-light.webp","meta.yaml","pyproject.toml","ruff.toml","tests/__init__.py","tests/context.py","tests/data/1398-HK-1d-bad-div-fixed.csv","tests/data/1398-HK-1d-bad-div.csv","tests/data/3988-HK-1d-bad-div-fixed.csv","tests/data/3988-HK-1d-bad-div.csv","tests/data/4063-T-1d-bad-div-fixed.csv","tests/data/4063-T-1d-bad-div.csv","tests/data/4063-T-1d-bad-stock-split-fixed.csv","tests/data/4063-T-1d-bad-stock-split.csv","tests/data/8TRA-DE-1d-missing-div-adjust-fixed.csv","tests/data/8TRA-DE-1d-missing-div-adjust.csv","tests/data/ABDP-L-1d-bad-div-fixed.csv","tests/data/ABDP-L-1d-bad-div.csv","tests/data/ADIG-L-1d-bad-div-fixed.csv","tests/data/ADIG-L-1d-bad-div.csv","tests/data/AET-L-1d-100x-error-fixed.csv","tests/data/AET-L-1d-100x-error.csv","tests/data/ALPHA-PA-1d-bad-stock-split-fixed.csv","tests/data/ALPHA-PA-1d-bad-stock-split.csv","tests/data/ASAI-L-1h-bad-unit-fixed.csv","tests/data/ASAI-L-1h-bad-unit.csv","tests/data/AV-L-1wk-bad-stock-split-fixed.csv","tests/data/AV-L-1wk-bad-stock-split.csv","tests/data/CALM-1d-no-bad-divs.csv","tests/data/CLC-L-1d-bad-div-fixed.csv","tests/data/CLC-L-1d-bad-div.csv","tests/data/CNE-L-1d-bad-stock-split-fixed.csv","tests/data/CNE-L-1d-bad-stock-split.csv","tests/data/DEX-AX-1d-bad-stock-split-fixed.csv","tests/data/DEX-AX-1d-bad-stock-split.csv","tests/data/DODFX-1d-cg-double-count-fixed.csv","tests/data/DODFX-1d-cg-double-count.csv","tests/data/EA-15m-no-bad-divs.csv","tests/data/ELCO-L-1d-bad-div-fixed.csv","tests/data/ELCO-L-1d-bad-div.csv","tests/data/EWG-1d-no-bad-divs.csv","tests/data/HSBK-IL-1d-no-bad-divs.csv","tests/data/IBE-MC-1d-no-bad-divs.csv","tests/data/JENYX-1d-cg-double-count-fixed.csv","tests/data/JENYX-1d-cg-double-count.csv","tests/data/KAP-IL-1d-bad-div-fixed.csv","tests/data/KAP-IL-1d-bad-div.csv","tests/data/KEN-TA-1d-bad-div-fixed.csv","tests/data/KEN-TA-1d-bad-div.csv","tests/data/KME-MI-1d-bad-div-fixed.csv","tests/data/KME-MI-1d-bad-div.csv","tests/data/KMR-L-1d-no-bad-divs.csv","tests/data/LA-V-1d-bad-stock-split-fixed.csv","tests/data/LA-V-1d-bad-stock-split.csv","tests/data/LSC-L-1d-bad-div-fixed.csv","tests/data/LSC-L-1d-bad-div.csv","tests/data/MOB-ST-1d-bad-stock-split-fixed.csv","tests/data/MOB-ST-1d-bad-stock-split.csv","tests/data/NVT-L-1d-bad-div-fixed.csv","tests/data/NVT-L-1d-bad-div.csv","tests/data/PSH-L-1d-bad-div-fixed.csv","tests/data/PSH-L-1d-bad-div.csv","tests/data/REL-L-1d-bad-div-fixed.csv","tests/data/REL-L-1d-bad-div.csv","tests/data/RGL-L-1d-bad-div-fixed.csv","tests/data/RGL-L-1d-bad-div.csv","tests/data/SAND-1d-bad-div-fixed.csv","tests/data/SAND-1d-bad-div.csv","tests/data/SCR-TO-1d-bad-div-fixed.csv","tests/data/SCR-TO-1d-bad-div.csv","tests/data/SERE-L-1d-bad-div-fixed.csv","tests/data/SERE-L-1d-bad-div.csv","tests/data/SPM-MI-1d-bad-stock-split-fixed.csv","tests/data/SPM-MI-1d-bad-stock-split.csv","tests/data/SSNLF-1d-bad-div-fixed.csv","tests/data/SSNLF-1d-bad-div.csv","tests/data/SSW-JO-1d-100x-error-fixed.csv","tests/data/SSW-JO-1d-100x-error.csv","tests/data/TEM-L-1d-bad-div-fixed.csv","tests/data/TEM-L-1d-bad-div.csv","tests/data/TENT-L-1d-bad-div-fixed.csv","tests/data/TENT-L-1d-bad-div.csv","tests/data/TEP-PA-1d-bad-div-fixed.csv","tests/data/TEP-PA-1d-bad-div.csv","tests/data/TISG-MI-1d-no-bad-divs.csv","tests/data/VWILX-1d-cg-double-count-fixed.csv","tests/data/VWILX-1d-cg-double-count.csv","tests/test_auth.py","tests/test_cache.py","tests/test_cache_noperms.py","tests/test_calendars.py","tests/test_data.py","tests/test_download_concurrency.py","tests/test_http.py","tests/test_live.py","tests/test_lookup.py","tests/test_market.py","tests/test_multi.py","tests/test_price_repair.py","tests/test_prices.py","tests/test_screener.py","tests/test_search.py","tests/test_sector_region.py","tests/test_ticker.py","tests/test_ticker_locale.py","tests/test_utils.py","yfinance/__init__.py","yfinance/_http.py","yfinance/base.py","yfinance/cache.py","yfinance/calendars.py","yfinance/config.py","yfinance/const.py","yfinance/data.py","yfinance/domain/__init__.py","yfinance/domain/domain.py","yfinance/domain/industry.py","yfinance/domain/market.py","yfinance/domain/sector.py","yfinance/exceptions.py","yfinance/live.py","yfinance/lookup.py","yfinance/multi.py","yfinance/pricing.proto","yfinance/pricing_pb2.py","yfinance/scrapers/__init__.py","yfinance/scrapers/analysis.py","yfinance/scrapers/fundamentals.py","yfinance/scrapers/funds.py","yfinance/scrapers/history.py","yfinance/scrapers/holders.py","yfinance/scrapers/quote.py","yfinance/scrapers/yahoo-keys.txt","yfinance/screener/__init__.py","yfinance/screener/query.py","yfinance/screener/screener.py","yfinance/search.py","yfinance/shared.py","yfinance/ticker.py","yfinance/tickers.py","yfinance/utils.py","yfinance/version.py"],"storefront":"/r/ranaroussi","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/ranaroussi/yfinance/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}