Skip to main content

PyPI - Python Version PyPI PyPI - Wheel PyPI - License Read the Docs Downloads CodeFactor Donate PayPal Ruff

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()

Outer Ratings example

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()

stock news example

Inside Trader

inside_trader_df = stock.ticker_inside_trader()

insider trader example

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()

news example

all_news['blogs'].head()

news example

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()

insider example

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()

insider example

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.

Filters set on an instance stay on it between calls, so one screener object can be reused. screener_view() returns an empty DataFrame when a view has no matches — never None — and Ticker.screener_view() returns an empty list; a long run blocked mid-way keeps what it already fetched on err.partial and can be resumed with select_page=err.next_page.

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.

That also means a thread-pool worker starts with an empty context: a set_proxy or set_session call made in the parent thread is not visible inside ThreadPoolExecutor workers, and they fall back to a default session with the default timeout. Configure inside the worker, or carry the context over:

import contextvars
from concurrent.futures import ThreadPoolExecutor

from finvizfinance.util import set_proxy

set_proxy({"https": "http://127.0.0.1:8080"})
ctx = contextvars.copy_context()

with ThreadPoolExecutor() as pool:
    list(pool.map(lambda t: ctx.copy().run(scrape, t), tickers))

A session shared across workers also needs a big enough connection pool (HTTPAdapter(pool_maxsize=...)), because requests defaults to 10.

Credit

Developed by Tianning Li. Feel free to give comments or suggestions.

Metadata

Release files for finvizfinance 1.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for finvizfinance 1.7.0
File Size Uploaded Provenance Actions
finvizfinance-1.7.0.tar.gz 48.7 kB With provenance Details for finvizfinance-1.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for finvizfinance 1.7.0
File Interpreter ABI Platform Actions
finvizfinance-1.7.0-py3-none-any.whl Python 3 none any Details for finvizfinance-1.7.0-py3-none-any.whl

Total release size: 110.9 kB

Release files / finvizfinance-1.7.0.tar.gz

Download URL finvizfinance-1.7.0.tar.gz
Size 48.7 kB
Tags Source
SHA-256 checksum
How to use checksums
15795c8be0644a4ef1edd109936a81afba89f58f66a9b48457973f4cb9a2ab0f
BLAKE2b-256 checksum
How to use checksums
9df7f96e58784a9cd32df283e9e290ec98950fa431eef87a4e805a42ffec3115
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 16, 2026.

Transparency log

Release files / finvizfinance-1.7.0-py3-none-any.whl

Download URL finvizfinance-1.7.0-py3-none-any.whl
Size 62.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b21788ddccbb0b4855cef94cae5f2b67a89a3f74149f6206d6e573b4c9c50412
BLAKE2b-256 checksum
How to use checksums
b3e2e08bb34ae10c8703010d612a59f265a488c5328bd911de920006fa1c6c94
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 16, 2026.

Transparency log

Security for finvizfinance 1.7.0

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.

Select from 2 files

Attestation for finvizfinance-1.7.0.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 16, 2026.

Transparency log

A 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.

Release history Release notifications | RSS feed

This release

1.7.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page