{"repo":"lit26/finvizfinance","free":true,"listed":false,"github":"https://github.com/lit26/finvizfinance","clone":"git clone https://github.com/lit26/finvizfinance.git","description":"Finviz analysis python library.","language":"Jupyter Notebook","stars":1572,"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"],"license":"MIT","category":"financial_data_api","readme_excerpt":"![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 & 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#### Peer\n\n```python\nstock_peer = stock.ticker_peer()\n\n# stock_peer\n# stock_peer = ['LI', 'XPEV', 'NIO', 'RIVN', 'LCID', 'TM', 'HMC', 'GM', 'STLA', 'F']\n```\n#### ETF Holders\n\n```python\nstock_etf_holders = stock.ticker_etf_holders()\n\n# stock_etf_holders\n# stock_etf_holders = ['VTI', 'VOO', 'IVV', 'SPY', 'VUG', 'QQQ', 'VGT', 'IWF', 'XLK', 'SPLG']\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&P 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","default_branch":"master","files":88,"tree":[".circleci/config.yml",".coveralls.yml",".github/FUNDING.yml",".github/ISSUE_TEMPLATE/bug_report.yaml",".github/ISSUE_TEMPLATE/feature_request.md",".github/ISSUE_TEMPLATE/submit_question.yml",".github/pull_request_template.md",".gitignore",".readthedocs.yaml","CODE_OF_CONDUCT.md","CONTRIBUTING.md","Industry.jpg","LICENSE","README.md","__pycache__/runtest.cpython-37-pytest-6.2.2.pyc","asset/insider.png","asset/insider_trader.png","asset/news_blogs.png","asset/news_news.png","asset/outer_rating.png","asset/screen_overview.png","asset/stock_news.png","asset/tsla.jpg","docs/Makefile","docs/make.bat","docs/source/calendar.rst","docs/source/conf.py","docs/source/crypto.rst","docs/source/earnings.rst","docs/source/forex.rst","docs/source/future.rst","docs/source/group.rst","docs/source/index.rst","docs/source/insider.rst","docs/source/news.rst","docs/source/quote.rst","docs/source/screener.rst","example/audusd_d1_s.jpg","example/btcusd_m5_s.jpg","example/example.ipynb","example/tsla.jpg","finvizfinance/__init__.py","finvizfinance/calendar.py","finvizfinance/constants.py","finvizfinance/crypto.py","finvizfinance/earnings.py","finvizfinance/forex.py","finvizfinance/future.py","finvizfinance/group/__init__.py","finvizfinance/group/base.py","finvizfinance/group/custom.py","finvizfinance/group/overview.py","finvizfinance/group/performance.py","finvizfinance/group/spectrum.py","finvizfinance/group/util.py","finvizfinance/group/valuation.py","finvizfinance/insider.py","finvizfinance/news.py","finvizfinance/quote.py","finvizfinance/screener/__init__.py","finvizfinance/screener/base.py","finvizfinance/screener/custom.py","finvizfinance/screener/financial.py","finvizfinance/screener/overview.py","finvizfinance/screener/ownership.py","finvizfinance/screener/performance.py","finvizfinance/screener/technical.py","finvizfinance/screener/ticker.py","finvizfinance/screener/util.py","finvizfinance/screener/valuation.py","finvizfinance/util.py","release.md","requirements-coverage.txt","requirements-doc.txt","requirements-test.txt","requirements.txt","setup.py","test/__init__.py","test/test_calendar.py","test/test_crypto.py","test/test_forex.py","test/test_group.py","test/test_insider.py","test/test_news.py","test/test_quote.py","test/test_screener.py","test/test_util.py","tsla.jpg"],"storefront":"/r/lit26","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/lit26/finvizfinance/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}