Skip to content
CAI
Software that uses CAICheck a score

ranaroussi/yfinance

62.9

Adequate · 16 November 2026

12.8k

lines of production code

Python

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.