SPB Git
4.5 KB · 50 lines json
1{2  "slug": "yfinance",3  "name": "yfinance",4  "aliases": ["yahoo-finance (Python)"],5  "vendor": { "name": "Ran Aroussi and contributors", "slug": "ranaroussi", "website": "https://ranaroussi.github.io/yfinance/" },6  "homepage_url": "https://ranaroussi.github.io/yfinance/",7  "docs_url": "https://ranaroussi.github.io/yfinance/",8  "repo_url": "https://github.com/ranaroussi/yfinance",9  "license_url": "https://github.com/ranaroussi/yfinance/blob/main/LICENSE.txt",10  "product_type": "library",11  "product_status": "active",12  "summary": "Open-source Python library that downloads price history, fundamentals, options chains and fund data from Yahoo Finance's unofficial endpoints for research and education",13  "description": "yfinance is an Apache-2.0 Python library by Ran Aroussi that retrieves data from Yahoo Finance's public but undocumented web endpoints. Through Ticker, Tickers and download() it returns price history at daily and intraday intervals, dividends and splits, company information and calendars, analyst targets, financial statements, options chains, holders and fund holdings as pandas objects, with caching and session handling to reduce rate-limit problems. Version 1.7.0 is current on PyPI at the time of writing.\n\nThe project states that it is intended for research and educational purposes, is not affiliated with or endorsed by Yahoo, and that users' rights to the data are governed by Yahoo's terms, which describe the API as intended for personal use. Because it scrapes an unofficial interface, breakage after Yahoo changes, throttling, gaps and silent data revisions are recurring issues, and the data should not be redistributed or used as the sole source for publishable results without verification against a licensed vendor.",14  "capabilities": ["Price history at daily and intraday intervals", "Dividends, splits and corporate actions", "Financial statements and company info", "Options chains", "Holders, analyst targets and fund holdings", "Batch download for many tickers", "pandas DataFrame output"],15  "workflows": ["Quick exploratory charts in a notebook", "Teaching data retrieval in an introductory finance course"],16  "advantages": ["Free and open source", "Simple pandas-based API", "Broad global ticker coverage"],17  "limitations": ["Unofficial endpoints; breaks when Yahoo changes", "Yahoo terms describe personal use only", "Rate limiting and data gaps", "Unsuitable as sole source for publishable research"],18  "prerequisites": ["Python with pandas"],19  "audiences": ["Students and hobbyists", "Researchers prototyping before buying licensed data"],20  "alternatives": ["alpha-vantage", "polygon-io", "firstrate-data", "databento"],21  "comparison_notes": "Alpha Vantage offers a licensed free tier with documented limits; Massive, FirstRate Data and Databento are paid vendors with defined licences and support. yfinance trades those guarantees for zero cost and convenience.",22  "categories": [{ "slug": "market-data-apis", "primary": true }],23  "tags": ["python", "market-data", "open-source", "scraping"],24  "use_cases": ["access-market-data"],25  "operating_systems": ["macos", "linux", "windows"],26  "execution_modes": ["local"],27  "interfaces": ["library"],28  "deployment_models": ["embedded"],29  "integrations": ["pandas", "requests/curl_cffi", "Jupyter"],30  "data_formats": ["pandas DataFrame", "JSON"],31  "languages": ["Python"],32  "source_model": "open-source",33  "license_spdx": "Apache-2.0",34  "pricing_model": ["free", "open-source"],35  "self_hostable": true,36  "sources": [37    { "url": "https://ranaroussi.github.io/yfinance/", "type": "official_docs", "title": "yfinance documentation", "supports": ["name", "summary", "capabilities", "limitations"], "checked_at": "2026-11-02", "note": "States not affiliated with Yahoo; Yahoo API intended for personal use" },38    { "url": "https://github.com/ranaroussi/yfinance", "type": "repository", "title": "ranaroussi/yfinance", "supports": ["repo_url", "vendor"], "checked_at": "2026-11-02" },39    { "url": "https://github.com/ranaroussi/yfinance/blob/main/LICENSE.txt", "type": "license_page", "title": "yfinance LICENSE.txt", "supports": ["license_spdx", "source_model"], "checked_at": "2026-11-02" },40    { "url": "https://ranaroussi.github.io/yfinance/index.html", "type": "official_site", "title": "yfinance", "supports": ["homepage_url"], "checked_at": "2026-11-02" }41  ],42  "confidence": "high",43  "discovery_method": "editorial-research",44  "depth": "standard",45  "editorial_status": "reviewed",46  "visibility": "public",47  "featured": false,48  "author": "batch-E"49}50
Files · laptop-initial-20261102
Menu

Theme