{"id":13741139,"url":"https://github.com/lit26/finvizfinance","last_synced_at":"2025-05-15T10:03:11.505Z","repository":{"id":37934795,"uuid":"282070967","full_name":"lit26/finvizfinance","owner":"lit26","description":"Finviz analysis python library.","archived":false,"fork":false,"pushed_at":"2024-10-03T16:29:36.000Z","size":7231,"stargazers_count":650,"open_issues_count":7,"forks_count":108,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-05-13T03:50:48.327Z","etag":null,"topics":["crypto","earnings-calls","financial-analysis","forex","fundament","fundamental-analysis","inside-trader","outer-ratings","pandas","pypi","screener","stock-charts","stock-news","technical-analysis","web-scraping"],"latest_commit_sha":null,"homepage":"https://finvizfinance.readthedocs.io/en/latest/","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lit26.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["lit26"],"custom":["https://www.paypal.com/paypalme/TIANNINGL/"]}},"created_at":"2020-07-23T22:38:18.000Z","updated_at":"2025-05-11T11:38:03.000Z","dependencies_parsed_at":"2023-02-18T13:30:49.620Z","dependency_job_id":"45618a36-dd08-443b-9738-2705e97b0321","html_url":"https://github.com/lit26/finvizfinance","commit_stats":{"total_commits":254,"total_committers":6,"mean_commits":"42.333333333333336","dds":"0.18110236220472442","last_synced_commit":"fc2f13700315bc3c5640e7bc2257d8efc71cafe8"},"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lit26%2Ffinvizfinance","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lit26%2Ffinvizfinance/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lit26%2Ffinvizfinance/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lit26%2Ffinvizfinance/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lit26","download_url":"https://codeload.github.com/lit26/finvizfinance/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254319716,"owners_count":22051072,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crypto","earnings-calls","financial-analysis","forex","fundament","fundamental-analysis","inside-trader","outer-ratings","pandas","pypi","screener","stock-charts","stock-news","technical-analysis","web-scraping"],"created_at":"2024-08-03T04:00:55.887Z","updated_at":"2025-05-15T10:03:09.931Z","avatar_url":"https://github.com/lit26.png","language":"Jupyter Notebook","funding_links":["https://github.com/sponsors/lit26","https://www.paypal.com/paypalme/TIANNINGL/","https://www.paypal.me/TIANNINGL/"],"categories":["Python"],"sub_categories":["Visualization","数据可视化"],"readme":"![PyPI - Python Version](https://img.shields.io/pypi/pyversions/finvizfinance)\n![PyPI](https://img.shields.io/pypi/v/finvizfinance)\n![PyPI - Wheel](https://img.shields.io/pypi/wheel/finvizfinance)\n![PyPI - License](https://img.shields.io/pypi/l/finvizfinance?color=gre)\n[![Coverage Status](https://coveralls.io/repos/github/lit26/finvizfinance/badge.svg)](https://coveralls.io/github/lit26/finvizfinance)\n![Read the Docs](https://img.shields.io/readthedocs/finvizfinance)\n[![Downloads](https://pepy.tech/badge/finvizfinance)](https://pepy.tech/project/finvizfinance)\n[![CodeFactor](https://www.codefactor.io/repository/github/lit26/finvizfinance/badge/master)](https://www.codefactor.io/repository/github/lit26/finvizfinance/overview/master)\n[![Donate PayPal](https://img.shields.io/badge/Donate%20%24-PayPal-brightgreen.svg)](https://www.paypal.me/TIANNINGL/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n# finvizfinance\n\nfinvizfinance is a package which collects financial information from FinViz website. The package provides the information of the following:\n\n- Stock charts, fundamental \u0026 technical information, insider information and stock news\n- Forex charts and performance\n- Crypto charts and performance\n\nScreener and Group provide dataframes for comparing stocks according to different filters and trading signals.\n\nDocs: https://finvizfinance.readthedocs.io/en/latest/\n\n### Downloads\n\nTo download the latest version from GitHub:\n\n```\n$ git clone https://github.com/lit26/finvizfinance.git\n```\n\nOr install from PyPi:\n\n```\n$ pip install finvizfinance\n```\n\n### Quote\n\nGetting information (fundament, description, outer rating, stock news, inside trader) of an individual stock.\n\n```python\nfrom finvizfinance.quote import finvizfinance\n\nstock = finvizfinance('tsla')\n```\n\n#### Chart\n\n```python\nstock.ticker_charts()\n```\n\n#### Fundament\n\n```python\nstock_fundament = stock.ticker_fundament()\n\n# result\n# stock_fundament = {'Company': 'Tesla, Inc.', 'Sector': 'Consumer Cyclical',\n# 'Industry': 'Auto Manufacturers', 'Country': 'USA', 'Index': '-', 'P/E': '849.57',\n# 'EPS (ttm)': '1.94', 'Insider Own': '0.10%', 'Shs Outstand': '186.00M',\n# 'Perf Week': '13.63%', 'Market Cap': '302.10B', 'Forward P/E': '106.17',\n# ...}\n```\n\n#### Description\n\n```python\nstock_description = stock.ticker_description()\n\n# stock_description\n# stock_description = 'Tesla, Inc. designs, develops, manufactures, ...'\n```\n\n#### Outer Ratings\n\n```python\nouter_ratings_df = stock.ticker_outer_ratings()\n```\n\n![Outer Ratings example](asset/outer_rating.png)\n\n#### Stock News\n\n```python\nnews_df = stock.ticker_news()\n```\n\n![stock news example](asset/stock_news.png)\n\n#### Inside Trader\n\n```python\ninside_trader_df = stock.ticker_inside_trader()\n```\n\n![insider trader example](asset/insider_trader.png)\n\n### News\n\nGetting recent financial news from finviz.\n\n```python\nfrom finvizfinance.news import News\n\nfnews = News()\nall_news = fnews.get_news()\n```\n\nFinviz News include 'news' and 'blogs'.\n\n```python\nall_news['news'].head()\n```\n\n![news example](asset/news_news.png)\n\n```python\nall_news['blogs'].head()\n```\n\n![news example](asset/news_blogs.png)\n\n### Insider\n\nGetting insider trading information.\n\n```python\nfrom finvizfinance.insider import Insider\n\nfinsider = Insider(option='top owner trade')\n# option: latest, top week, top owner trade\n# default: latest\n\ninsider_trader = finsider.get_insider()\n```\n\n![insider example](asset/insider.png)\n\n### Screener (Overview, Valuation, Financial, Ownership, Performance, Technical)\n\nGetting multiple tickers' information according to the filters.\n\n#### Example: Overview\n\n```python\nfrom finvizfinance.screener.overview import Overview\n\nfoverview = Overview()\nfilters_dict = {'Index':'S\u0026P 500','Sector':'Basic Materials'}\nfoverview.set_filter(filters_dict=filters_dict)\ndf = foverview.screener_view()\ndf.head()\n```\n\n![insider example](asset/screen_overview.png)\n\n### Screener (Ticker)\n\nGetting list of tickers according to the filters.\n\n### Misc (Proxy)\n\nOptional proxy can be used for getting information from FinViz website. Accessible from finvizfinance\nit's an extension of requests library proxies\n\n```python\nfrom finvizfinance.util import set_proxy\n\nproxies={'http': 'http://127.0.0.1:8080'}\nset_proxy(proxies)\n```\n\n### Credit\n\nDeveloped by Tianning Li. Feel free to give comments or suggestions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flit26%2Ffinvizfinance","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flit26%2Ffinvizfinance","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flit26%2Ffinvizfinance/lists"}