How ranaroussi/yfinance works
yfinance is a Python client for Yahoo Finance market data. Users access single- and multi-ticker data, historical prices, search, screening, market and sector/industry information, and live streams through its public APIs. The principal download path is ticker-oriented: ticker objects expose data capabilities implemented by scrapers, which use a shared data layer to make Yahoo requests and return parsed results. The README documents additional API branches; unsampled implementations are represented by their exact directories, and uncertain connections are omitted.
Main entry points: ticker.py Ticker · data.py Yahoo data access · screener.py Screener · tickers.py Tickers
Components 24
Public API
- Ticker
yfinance/ticker.py - Tickers
yfinance/tickers.py - Bulk download
yfinance/multi.py
Market Data Features
- Price history
yfinance/scrapers/history.py - Quote data
yfinance/scrapers/quote.py - Fund data
yfinance/scrapers/funds.py - Analysis data
yfinance/scrapers/analysis.py - Fundamentals
yfinance/scrapers/fundamentals.py - Holder data
yfinance/scrapers/holders.py - Search
yfinance/search.py - Symbol lookup
yfinance/lookup.py - Market info
yfinance/domain/market.py - Sector info
yfinance/domain/sector.py - Industry info
yfinance/domain/industry.py - Screener
yfinance/screener/screener.py - Screen queries
yfinance/screener/query.py - Live streams
yfinance/live.py - Calendars
yfinance/calendars.py
Data Transport
- Yahoo data access
yfinance/data.py - HTTP backend
yfinance/_http.py
Shared Support
- Response cache
yfinance/cache.py - Configuration
yfinance/config.py
Other components
- Python user
- Yahoo Finance
Connections 23
- Python user → Ticker: uses
README.md - Python user → Tickers: uses
README.md - Python user → Bulk download: downloads
README.md - Python user → Search: searches
README.md - Python user → Market info: queries
README.md - Python user → Sector info: queries
README.md - Python user → Industry info: queries
README.md - Python user → Screener: screens
README.md - Python user → Live streams: streams
README.md - Ticker → Price history: exposes
- Ticker → Quote data: exposes
- Ticker → Fund data: exposes
yfinance/ticker.py - Ticker → Analysis data: exposes
- Ticker → Fundamentals: exposes
- Ticker → Holder data: exposes
- Tickers → Bulk download: delegates
yfinance/tickers.py - Screener → Screen queries: accepts
yfinance/screener/screener.py - Screener → Yahoo data access: posts query
yfinance/screener/screener.py - Market info → Yahoo data access: uses
yfinance/domain/market.py - Sector info → Yahoo data access: uses
yfinance/domain/sector.py - Industry info → Yahoo data access: uses
yfinance/domain/industry.py - Yahoo data access → HTTP backend: uses
yfinance/data.py - Yahoo data access → Yahoo Finance: requests data
yfinance/data.py