finvizfinance
finvizfinance is a package which collects financial information from FinViz website. The package provides the information of the following:
- Stock charts, fundamental & technical information, insider information and stock news
- Forex charts and performance
- Crypto charts and performance
Screener and Group provide dataframes for comparing stocks according to different filters and trading signals.
Docs: https://finvizfinance.readthedocs.io/en/latest/
Downloads
To download the latest version from GitHub:
$ git clone https://github.com/lit26/finvizfinance.git
Or install from PyPi:
$ pip install finvizfinance
Quote
Getting information (fundament, description, outer rating, stock news, inside trader) of an individual stock.
from finvizfinance.quote import finvizfinance
stock = finvizfinance('tsla')
Chart
stock.ticker_charts()
Fundament
stock_fundament = stock.ticker_fundament()
# result
# stock_fundament = {'Company': 'Tesla, Inc.', 'Sector': 'Consumer Cyclical',
# 'Industry': 'Auto Manufacturers', 'Country': 'USA', 'Index': '-', 'P/E': '849.57',
# 'EPS (ttm)': '1.94', 'Insider Own': '0.10%', 'Shs Outstand': '186.00M',
# 'Perf Week': '13.63%', 'Market Cap': '302.10B', 'Forward P/E': '106.17',
# ...}
Description
stock_description = stock.ticker_description()
# stock_description
# stock_description = 'Tesla, Inc. designs, develops, manufactures, ...'
Peer
stock_peer = stock.ticker_peer()
# stock_peer
# stock_peer = ['LI', 'XPEV', 'NIO', 'RIVN', 'LCID', 'TM', 'HMC', 'GM', 'STLA', 'F']
ETF Holders
stock_etf_holders = stock.ticker_etf_holders()
# stock_etf_holders
# stock_etf_holders = ['VTI', 'VOO', 'IVV', 'SPY', 'VUG', 'QQQ', 'VGT', 'IWF', 'XLK', 'SPLG']
Outer Ratings
outer_ratings_df = stock.ticker_outer_ratings()
Options Chain
options_df = stock.ticker_options() # nearest expiry
options_df = stock.ticker_options(expiry="2026-12-18")
expiries = stock.info["option_expiries"]
Stock News
news_df = stock.ticker_news()
Inside Trader
inside_trader_df = stock.ticker_inside_trader()
News
Getting recent financial news from finviz.
from finvizfinance.news import News
fnews = News()
all_news = fnews.get_news()
Finviz News include 'news' and 'blogs'.
all_news['news'].head()
all_news['blogs'].head()
Insider
Getting insider trading information.
from finvizfinance.insider import Insider
finsider = Insider(option='top owner trade')
# option: latest, top week, top owner trade
# default: latest
insider_trader = finsider.get_insider()
Screener (Overview, Valuation, Financial, Ownership, Performance, Technical)
Getting multiple tickers' information according to the filters.
Example: Overview
from finvizfinance.screener.overview import Overview
foverview = Overview()
filters_dict = {'Index':'S&P 500','Sector':'Basic Materials'}
foverview.set_filter(filters_dict=filters_dict)
df = foverview.screener_view()
df.head()
Example: From a finviz URL
Instead of translating each criterion into a filters dict by hand, paste the URL
finviz puts in your address bar as you click filters in its UI. screener.from_url
reads the view (v) and reconstructs the filters (f), signal (s) and ticker
(t), returning the matching screener object:
from finvizfinance import screener
foverview = screener.from_url(
"https://finviz.com/screener.ashx?v=111&f=idx_sp500,sh_avgvol_o500"
)
df = foverview.screener_view()
df.head()
Sort order, pagination and custom columns are screener_view() arguments, so
they are ignored in the URL. Any filter/signal/view code that finvizfinance does
not recognize raises a ValueError naming the code, rather than silently
dropping it and returning the wrong stocks.
Screener (Ticker)
Getting list of tickers according to the filters.
Calendar
Getting the economic calendar (release datetime, impact, actual/expected/prior).
from finvizfinance.calendar import Calendar
fcalendar = Calendar()
df = fcalendar.calendar()
df.head()
Earnings
Partitioning tickers by their earnings dates for a period.
from finvizfinance.earnings import Earnings
# period: This Week (default), Next Week, Previous Week, This Month
fearnings = Earnings(period='This Week')
# mode: financial (default), overview, valuation, ownership, performance, technical
days = fearnings.partition_days(mode='financial')
# optionally export the partitioned tables
fearnings.output_csv('earning_days')
# Excel export needs the optional extra: pip install finvizfinance[excel]
fearnings.output_excel('earning_days.xlsx')
Future
Getting futures performance.
from finvizfinance.future import Future
ffuture = Future()
# timeframe: D (default), W, M, Q, HY, Y
df = ffuture.performance(timeframe='D')
df.head()
Misc (Proxy)
Optional proxy can be used for getting information from FinViz website. Accessible from finvizfinance it's an extension of requests library proxies
from finvizfinance.util import set_proxy
proxies={'http': 'http://127.0.0.1:8080'}
set_proxy(proxies)
set_proxy, set_timeout and set_session apply to the calling thread or
async task only — a web app can configure each request handler differently
without the settings bleeding into other callers. Threads that were given no
session get their own default one, since requests.Session is not thread-safe.
Credit
Developed by Tianning Li. Feel free to give comments or suggestions.
Metadata
Release files for finvizfinance 1.6.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| finvizfinance-1.6.1.tar.gz | 47.3 kB | With provenance | Details for finvizfinance-1.6.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| finvizfinance-1.6.1-py3-none-any.whl | Python 3 | none | any | Details for finvizfinance-1.6.1-py3-none-any.whl |
Total release size: 107.9 kB
Release files / finvizfinance-1.6.1.tar.gz
| Download URL | finvizfinance-1.6.1.tar.gz |
|---|---|
| Size | 47.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
48c46f96bea8b316558a0a02d26514ab62365b892f20855584156b899dcf91ba
|
|
BLAKE2b-256 checksum How to use checksums |
832b59607386d8c5cc6d3bdc0f67b652303860fdb1353010b8e93a1da799e8b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logRelease files / finvizfinance-1.6.1-py3-none-any.whl
| Download URL | finvizfinance-1.6.1-py3-none-any.whl |
|---|---|
| Size | 60.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
991905f7b90c8ad1df65119b06fda5874e59e8c9905fc47a85f764539baa304f
|
|
BLAKE2b-256 checksum How to use checksums |
cfde566825d9fd7ebd49c7feda78ff1fa9d5e4b80434fa4d1e3d96b23b8622a5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logSecurity for finvizfinance 1.6.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for finvizfinance-1.6.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.