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_excel('earning_days.xlsx')
fearnings.output_csv('earning_days')
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)
Credit
Developed by Tianning Li. Feel free to give comments or suggestions.
Metadata
Release files for finvizfinance 1.6.0
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.0.tar.gz | 46.3 kB | Without provenance | Details for finvizfinance-1.6.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| finvizfinance-1.6.0-py3-none-any.whl | Python 3 | none | any | Details for finvizfinance-1.6.0-py3-none-any.whl |
Total release size: 106.0 kB
Release files / finvizfinance-1.6.0.tar.gz
| Download URL | finvizfinance-1.6.0.tar.gz |
|---|---|
| Size | 46.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e5f4f0b0ff2241e2769bf90d88cd4d5094f48708d14a88671a2bc90024eed401
|
|
BLAKE2b-256 checksum How to use checksums |
7ee5d7598d7dbfb94384f4a2a712eacbabde035e561b46ef1340c91fc9fc761b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.8
|
Release files / finvizfinance-1.6.0-py3-none-any.whl
| Download URL | finvizfinance-1.6.0-py3-none-any.whl |
|---|---|
| Size | 59.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7ed16f71176bb26c0632fade51852c8ac6e9705e6410f1e8d23805dac27cd90f
|
|
BLAKE2b-256 checksum How to use checksums |
540a8e281df33db166385446b47533f869e4304513293ffcedb53eab47078088
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.8
|
Security for finvizfinance 1.6.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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.