# lit26/finvizfinance architecture

> Architecture diagram of the GitHub repository lit26/finvizfinance, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lit26/finvizfinance
- Repository: https://github.com/lit26/finvizfinance

## Overview

finvizfinance is a Python client for collecting and parsing financial data from FinViz. The principal workflow is: an application requests a domain view, the package configures and sends a FinViz request, parses HTML or embedded JSON, and returns DataFrames, ticker lists, metadata, or chart files. Sampled code confirms shared transport, quote/screener/group parsing, calendar fallbacks, and earnings orchestration; several domain modules are represented from the repository tree and README capabilities without claiming unsampled internals.

Main entry points: [`finvizfinance/util.py`](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/util.py) (Shared Web Transport), [`finvizfinance/quote.py`](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/quote.py) (Quote Client), [`finvizfinance/screener/base.py`](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/screener/base.py) (Screener Base), [`finvizfinance/group/base.py`](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/group/base.py) (Group Views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_market["Market Data"]
  node_quote["Quote Client<br/>[quote.py]"]
  node_quote_result["Quote Results<br/>[quote.py]"]
  node_news["News Client<br/>[news.py]"]
  node_insider["Insider Client<br/>[insider.py]"]
  node_forex["Forex Client<br/>[forex.py]"]
  node_crypto["Crypto Client<br/>[crypto.py]"]
  node_future["Futures Client<br/>[future.py]"]
end

subgraph group_screen["Screening Groups"]
  node_screener["Screener Base<br/>[base.py]"]
  node_screener_modes["Screener Modes"]
  node_ticker_screen["Ticker Screener<br/>[ticker.py]"]
  node_group_base["Group Views<br/>[base.py]"]
  node_group_spectrum["Group Spectrum<br/>[spectrum.py]"]
  node_screen_result["Comparison Data<br/>[base.py]"]
end

subgraph group_calendar["Calendars Analytics"]
  node_calendar_client["Economic Calendar<br/>[calendar.py]"]
  node_earnings["Earnings Partitions<br/>[earnings.py]"]
  node_exports["CSV Excel Files<br/>[earnings.py]"]
end

subgraph group_transport["Transport Parsing"]
  node_transport["Shared Web Transport<br/>[util.py]"]
  node_parser["HTML JSON Parsers<br/>[util.py]"]
  node_charts["Chart Downloads<br/>[util.py]"]
end

node_user(("Application User"))
node_finviz["FinViz Website"]

node_user -->|"requests quote"| node_quote
node_user -->|"requests news"| node_news
node_user -->|"requests insider"| node_insider
node_user -->|"sets filters"| node_screener_modes
node_user -->|"selects group"| node_group_base
node_user -->|"requests calendar"| node_calendar_client
node_user -->|"selects period"| node_earnings
node_quote -->|"fetches page"| node_transport
node_quote -->|"parses quote"| node_parser
node_quote -->|"returns data"| node_quote_result
node_quote -->|"downloads charts"| node_charts
node_news -->|"fetches news"| node_transport
node_insider -->|"fetches trades"| node_transport
node_forex -->|"fetches performance"| node_transport
node_crypto -->|"fetches performance"| node_transport
node_future -->|"fetches performance"| node_transport
node_screener_modes -->|"uses base"| node_screener
node_screener -->|"fetches pages"| node_transport
node_screener -->|"parses tables"| node_parser
node_screener -->|"returns DataFrame"| node_screen_result
node_ticker_screen -->|"fetches pages"| node_transport
node_group_base -->|"fetches group"| node_transport
node_group_base -->|"parses table"| node_parser
node_group_spectrum -->|"fetches image"| node_transport
node_group_spectrum -->|"downloads spectrum"| node_charts
node_calendar_client -->|"fetches calendar"| node_transport
node_calendar_client -->|"parses JSON HTML"| node_parser
node_earnings -->|"queries earnings"| node_screener_modes
node_earnings -->|"writes reports"| node_exports
node_transport -->|"requests data"| node_finviz
node_parser -->|"reads response"| node_transport

click node_quote "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/quote.py"
click node_quote_result "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/quote.py"
click node_news "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/news.py"
click node_insider "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/insider.py"
click node_forex "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/forex.py"
click node_crypto "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/crypto.py"
click node_future "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/future.py"
click node_screener "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/screener/base.py"
click node_screener_modes "https://github.com/lit26/finvizfinance/tree/master/finvizfinance/screener"
click node_ticker_screen "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/screener/ticker.py"
click node_group_base "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/group/base.py"
click node_group_spectrum "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/group/spectrum.py"
click node_screen_result "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/screener/base.py"
click node_calendar_client "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/calendar.py"
click node_earnings "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/earnings.py"
click node_exports "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/earnings.py"
click node_transport "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/util.py"
click node_parser "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/util.py"
click node_charts "https://github.com/lit26/finvizfinance/blob/master/finvizfinance/util.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_quote,node_quote_result,node_news,node_insider,node_forex,node_crypto,node_future,node_user toneBlue
class node_screener,node_screener_modes,node_ticker_screen,node_group_base,node_group_spectrum,node_screen_result toneAmber
class node_calendar_client,node_earnings,node_exports toneMint
class node_transport,node_parser,node_charts toneRose
class node_finviz toneIndigo
```

## Components

### Market Data

- [Quote Client](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/quote.py): `finvizfinance/quote.py`
- [Quote Results](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/quote.py): `finvizfinance/quote.py`
- [News Client](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/news.py): `finvizfinance/news.py`
- [Insider Client](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/insider.py): `finvizfinance/insider.py`
- [Forex Client](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/forex.py): `finvizfinance/forex.py`
- [Crypto Client](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/crypto.py): `finvizfinance/crypto.py`
- [Futures Client](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/future.py): `finvizfinance/future.py`

### Screening Groups

- [Screener Base](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/screener/base.py): `finvizfinance/screener/base.py`
- [Screener Modes](https://github.com/lit26/finvizfinance/tree/master/finvizfinance/screener): `finvizfinance/screener`
- [Ticker Screener](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/screener/ticker.py): `finvizfinance/screener/ticker.py`
- [Group Views](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/group/base.py): `finvizfinance/group/base.py`
- [Group Spectrum](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/group/spectrum.py): `finvizfinance/group/spectrum.py`
- [Comparison Data](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/screener/base.py): `finvizfinance/screener/base.py`

### Calendars Analytics

- [Economic Calendar](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/calendar.py): `finvizfinance/calendar.py`
- [Earnings Partitions](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/earnings.py): `finvizfinance/earnings.py`
- [CSV Excel Files](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/earnings.py): `finvizfinance/earnings.py`

### Transport Parsing

- [Shared Web Transport](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/util.py): `finvizfinance/util.py`
- [HTML JSON Parsers](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/util.py): `finvizfinance/util.py`
- [Chart Downloads](https://github.com/lit26/finvizfinance/blob/master/finvizfinance/util.py): `finvizfinance/util.py`

### Other components

- **Application User**
- **FinViz Website**

## Connections

- Application User → Quote Client: requests quote
- Application User → News Client: requests news
- Application User → Insider Client: requests insider
- Application User → Screener Modes: sets filters
- Application User → Group Views: selects group
- Application User → Economic Calendar: requests calendar
- Application User → Earnings Partitions: selects period
- Quote Client → Shared Web Transport: fetches page
- Quote Client → HTML JSON Parsers: parses quote
- Quote Client → Quote Results: returns data
- Quote Client → Chart Downloads: downloads charts
- News Client → Shared Web Transport: fetches news
- Insider Client → Shared Web Transport: fetches trades
- Forex Client → Shared Web Transport: fetches performance
- Crypto Client → Shared Web Transport: fetches performance
- Futures Client → Shared Web Transport: fetches performance
- Screener Modes → Screener Base: uses base
- Screener Base → Shared Web Transport: fetches pages
- Screener Base → HTML JSON Parsers: parses tables
- Screener Base → Comparison Data: returns DataFrame
- Ticker Screener → Shared Web Transport: fetches pages
- Group Views → Shared Web Transport: fetches group
- Group Views → HTML JSON Parsers: parses table
- Group Spectrum → Shared Web Transport: fetches image
- Group Spectrum → Chart Downloads: downloads spectrum
- Economic Calendar → Shared Web Transport: fetches calendar
- Economic Calendar → HTML JSON Parsers: parses JSON HTML
- Earnings Partitions → Screener Modes: queries earnings
- Earnings Partitions → CSV Excel Files: writes reports
- Shared Web Transport → FinViz Website: requests data
- HTML JSON Parsers → Shared Web Transport: reads response
