ranaroussi/yfinance
62.9
Adequate · 16 November 2026
12.8k
lines of production code
Python
primary language
5
measurements over time
What this system is
Features
Added Sphinx documentation build infrastructure
The project now includes the necessary build scripts (Makefile and make.bat) to generate documentation using Sphinx. This enables users and developers to build the documentation locally by running 'make html' (or 'make.bat html' on Windows), provided Sphinx is installed.
doc · high confidence
Initial Sphinx-based documentation structure
The project documentation has been migrated to Sphinx using reStructuredText. This change introduces a new configuration file (conf.py) that sets up the build environment with extensions for autodoc and Napoleon, selects the pydata\_sphinx\_theme, and configures the HTML output to display the project logo. An initial index page (index.rst) has been added to provide installation instructions, quick-start code examples for tickers and funds, and a legal disclaimer regarding Yahoo! Finance trademarks.
doc/source · high confidence
Introduce Screener API for filtering stocks, funds, and ETFs
Users can now filter financial instruments using the new \yf.screen()\ function, which supports both predefined queries (such as 'day\_gainers' and 'undervalued\_growth\_stocks') and custom logic built with \EquityQuery\, \FundQuery\, and \ETFQuery\ classes. These query classes allow users to construct complex filters using operators like \EQ\, \GT\, \BTWN\, and logical combinators \AND\/\OR\ against valid fields and values specific to equities, mutual funds, and ETFs.
yfinance/screener · high confidence
New documentation examples for expanded API capabilities
Added a comprehensive set of reference examples in doc/source/reference/examples demonstrating new and existing features, including authentication (Auth class with cookie management and subscription tiers), live market data via synchronous and asynchronous WebSockets, financial data lookup (Lookup module), market summaries and status (Market class), sector and industry analysis, fund data, search functionality, and calendar events (earnings, IPOs, splits).
doc/source/reference/examples · high confidence
New domain objects for Market, Sector, and Industry data
Users can now access structured financial data through new domain classes: \Market\ provides market status and summary information with validation for supported regions (US, GB, ASIA, EUROPE, etc.); \Sector\ allows retrieval of top ETFs, top mutual funds, and a list of industries within a specific sector; and \Industry\ provides details on top performing and top growth companies within an industry, including the parent sector information. All domain objects support regional scoping via a \region\ parameter to tailor data to specific Yahoo Finance markets.
yfinance/domain · high confidence
Removals
Removal of deprecated Selenium-based Yahoo Finance downloader
The \fix\_yahoo\_finance\ module, which previously provided a \get\_data\_yahoo\ function using Selenium and a headless Chrome browser to scrape Yahoo Finance data, has been completely removed. This change eliminates the dependency on browser automation for data retrieval, aligning with the deprecation of the pandas-datareader override mechanism that this library was designed to support.
_fix\_yahoo\finance · high confidence
Architecture
Major architectural refactor: new modular structure and HTTP backend
The library has been restructured into a modular architecture with dedicated files for HTTP handling (\_http.py), configuration (config.py), caching (cache.py), and data retrieval (data.py). The HTTP layer now prefers curl\cffi for browser TLS impersonation with a graceful fallback to the requests library. A new centralized configuration system (YfConfig) manages network and debug settings, replacing previous ad-hoc approaches. The timezone cache has been migrated from CSV to a thread-safe SQLite database using Peewee, and the main entry point (\\init\\_.py) now exposes the new Screener, Calendars, and Config modules alongside the existing Ticker and download functionality.
yfinance · high confidence
Major refactoring of data scrapers into modular lazy-loaded components
The \yfinance/scrapers\ package has been restructured from a monolithic design into distinct, lazy-loaded modules for specific data types: \analysis\ (earnings estimates, analyst targets, growth trends), \fundamentals\ (income, balance sheet, cash flow with chunked API fallbacks), \funds\ (ETF/mutual fund profiles and holdings), \history\ (price data with lazy metadata loading), \holders\ (institutional and insider ownership), and \quote\ (including the \FastInfo\ dict-like interface). This change improves performance by deferring API calls until data is actually accessed and enhances maintainability by isolating scraping logic. Additionally, \yahoo-keys.txt\ containing decryption keys has been added to the package.
yfinance/scrapers · high confidence
Behavioural changes
1 commit (0 fixes) modifying maintainer
A change to existing behaviour in maintainer — 1 commit, 2 files: “Update GH actions”.
maintainer · medium confidence · unverified
Custom styling for documentation navigation
A new CSS file (yfinance.css) has been added to the documentation static assets to hide the "Section Navigation" title in the sidebar, providing a cleaner look for the documentation interface.
_doc/source/\static · high confidence
Project rebranding from fix-yahoo-finance to yfinance and license migration
The library has been renamed from fix-yahoo-finance to yfinance, accompanied by a migration of the license from the GNU Lesser General Public License v3 (LGPL) to the Apache License 2.0. This change includes the removal of the legacy setup.py and README.rst files, the addition of a new README.md, and the introduction of a Code of Conduct and Contributing guidelines to support the rebranded open-source project.
(repo-wide) · high confidence
Test coverage
Added test fixtures for bad dividend repair; Comprehensive test suite for authentication, data handling, and price repair.
Dependencies
Migrate packaging to pyproject.toml and update dependencies
The project has migrated its build configuration from a legacy requirements.txt to a modern pyproject.toml file, aligning with current Python packaging standards. This change introduces several dependency updates: curl\_cffi is now required (version \>=0.15) to replace older HTTP handling, requests is bumped to \>=2.31, and pandas is raised to \>=1.3.0. Additionally, the deprecated appdirs package has been replaced with platformdirs, and peewee is added for thread-safe database operations. The old requirements.txt, which included selenium and pyvirtualdisplay, has been removed.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 63 → 63 (-0.2)
- Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 62 → 61 (-1.3)
- Architecture 97 → 97 (+0.2)
- Maturity 53 → 55 (+2.3)
- Readiness 73 → 66 (-7.3)
- Security 72 → 72 (+0.0)
- Domain Modelling 100 → 100 (+0.0)
- Performance 100 → 100 (+0.0)
Resolved (2)
- Duplicated block (5 lines × 4) (yfinance/scrapers/history.py)
- Off-boarding risk: anonymized user #1
New (19)
- Edited copies of one member (3 members, 10+ corresponding lines) (yfinance/scrapers/quote.py)
- Edited copies of one member (3 members, 15+ corresponding lines) (yfinance/cache.py)
- Edited copies of one member (3 members, 15+ corresponding lines) (yfinance/scrapers/quote.py)
- Edited copies of one member (3 members, 19+ corresponding lines) (yfinance/cache.py)
- Edited copies of one member (3 members, 19+ corresponding lines) (yfinance/domain/domain.py)
- Edited copies of one member (4 members, 19+ corresponding lines) (yfinance/live.py)
- Edited copy of a member (12 corresponding lines) (yfinance/live.py)
- Edited copy of a member (13 corresponding lines) (yfinance/scrapers/quote.py)
- Edited copy of a member (13 corresponding lines) (yfinance/screener/query.py)
- Edited copy of a member (15 corresponding lines) (yfinance/scrapers/analysis.py)
- Edited copy of a member (17 corresponding lines) (yfinance/utils.py)
- Edited copy of a member (24 corresponding lines) (yfinance/data.py)
- Edited copy of a member (25 corresponding lines) (yfinance/domain/industry.py)
- Edited copy of a member (27 corresponding lines) (yfinance/cache.py)
- Edited copy of a member (5 corresponding lines) (yfinance/base.py)
- Edited copy of a member (6 corresponding lines) (yfinance/screener/query.py)
- Orphaned file (yfinance/domain/domain.py)
- Orphaned file (yfinance/domain/industry.py)
- Orphaned file (yfinance/domain/sector.py)
Changes since last survey
- 2 commits — 1 feature/other, 1 fixes
By area
- (repo) — 1 commit
- (root) — 1 commit
Notable commits
- fix: Merge pull request #3037 from VictorPimentaDev/fix/readme-python-badge
- change: docs: drop Python 2.7 from the README version badge
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
ranaroussi/yfinance was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 16 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 2492a853aee975b4f39f230ad763298f039e37ae — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.73+preprod-52de90b74216.