# lit26/finvizfinance

Finviz analysis python library.

Repository: https://github.com/lit26/finvizfinance
Canonical: https://ross.abutalabs.com/products/finvizfinance
Homepage: https://finvizfinance.readthedocs.io/en/latest/
Language: Jupyter Notebook
License: MIT
License Family: permissive
Topics: web-scraping, fundamental-analysis, stock-news, technical-analysis, inside-trader, financial-analysis, pandas, stock-charts, fundament, screener, outer-ratings, pypi, crypto, forex, earnings-calls
Last push: 2026-08-26T17:37:31+00:00

## Health v2 (maintenance only)
Score: 79/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 40, longevity 100
- inputs: {"age_days": 2232, "days_push": 7, "days_rel": 242, "gap_med": 119, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1623, forks 272 (observed 2026-08-28T04:05:12.553358+00:00)

## What it is
A Python library that scrapes and downloads financial data from the FinViz website, returning stock fundamentals, technicals, charts, news, insider trading info, and screener results as pandas DataFrames. It also covers forex and crypto charts and performance data.

## Use cases
- scrape stock fundamentals from finviz
- download stock screener results as a dataframe
- get insider trading data for a ticker
- fetch stock news and analyst ratings in python
- compare stocks by financial filters
- pull crypto and forex performance data
- download ticker charts for analysis

## When to choose
- you want FinViz data programmatically in Python with pandas output
- you need screener, quote, insider, news, or chart data for research or backtesting
- you want a lightweight pip-installable scraper with docs

## When to avoid
- you need an official licensed data feed or guaranteed API stability
- you need real-time streaming market data
- you are not working in Python

## Facets
- artifact type: library
- maturity: active
- function: web-scraping, data-science, etl
- domain: fintech, data-science, analytics
- platform: python
- tags: finviz, stock-screener, fundamental-analysis, technical-analysis, pandas, finance, trading, cryptocurrency, forex

## Member repositories
- lit26/finvizfinance (main) score 79

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:12.553358+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:48:51.307762+00:00, confidence not recorded.
  - readme: https://github.com/lit26/finvizfinance (fetched 2026-08-28T04:05:12.553358+00:00, sha c2998ca02cc6)
  - registry_pypi: https://pypi.org/pypi/finvizfinance/json (fetched 2026-08-29T11:22:02.119482+00:00, sha b188bb073dd4)
- Data as of 2026-08-30T08:39:29.467469+00:00.