Repolode
Submit
deepentropy

deepentropy/tvscreener

Unofficial Python library that pulls stock, crypto, forex, bond, futures and other screener data from TradingView into Pandas DataFrames.

Open-source alternative to:TradingView

View on GitHub
Stars
1,723
Forks
242
Open issues
0
Last commit
6 days ago

Repolode describes open-source projects and does not give investment advice. Trading and investing can lose money: assess the risk yourself and follow the laws where you live before using this project.

What is it?

tvscreener is a Python client for TradingView's screener data. It lets you run screeners for stocks, ETFs, crypto, forex, bonds, futures, coins, indices and economic indicators, filter them by fields, markets and countries, and receive the results as a Pandas DataFrame.

Beyond basic screening, the library covers TradingView's built-in presets such as gainers and losers, earnings, dividend, IPO and economic calendars, multi-year financial statements, real-time quotes, news, filings and earnings call transcripts. It also supports OR and nested filters, a fluent select/where API, field search and curated field presets, and a streaming mode that refreshes results at a set interval.

The project is unofficial and not affiliated with TradingView. It also ships an MCP server so AI assistants can call its tools, and a web-based code generator for building screener queries visually.

Key features

  • 01Screeners for stocks, ETFs, crypto, forex, bonds, futures, coins, indices and economics
  • 02OR and nested filters with operators like has() and above_pct()
  • 03Financial statements, corporate events and seasonal returns for symbols
  • 04Real-time quotes streamed from TradingView
  • 05News, filings and earnings call transcript retrieval
  • 06Results returned as Pandas DataFrames, with auto-refresh streaming

Use cases

  • Screening stocks by valuation, dividend or momentum criteria in a Jupyter notebook
  • Monitoring crypto or forex movers with periodic refreshes
  • Pulling financial statements and earnings calendars for research
  • Giving AI assistants access to screener data through the MCP server

Quick start

  1. 1

    Install the library from PyPI

    pip install tvscreener
  2. 2

    Import the library and run a basic Stock Screener query

    python -c "import tvscreener as tvs; df = tvs.StockScreener().get(); print(df.head())"

Things to know

  • This is an unofficial, third-party library not affiliated with TradingView.
  • Use is subject to TradingView's terms of service and may break if TradingView changes its data.

Topics

#finance#tradingview#technical-analysis#stock-screener#pandas#python-library#quantitative-finance

FAQ

What is tvscreener?
Unofficial Python library that pulls stock, crypto, forex, bond, futures and other screener data from TradingView into Pandas DataFrames. tvscreener is a Python client for TradingView's screener data. It lets you run screeners for stocks, ETFs, crypto, forex, bonds, futures, coins, indices and economic indicators, filter them by fields, markets and countries, and receive the results as a Pandas DataFrame.
Is tvscreener free to use? What license does it have?
tvscreener is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is tvscreener still maintained?
Actively maintained. The last commit to tvscreener was on Nov 1, 2026.
What can I use tvscreener for?
Screening stocks by valuation, dividend or momentum criteria in a Jupyter notebook Monitoring crypto or forex movers with periodic refreshes Pulling financial statements and earnings calendars for research Giving AI assistants access to screener data through the MCP server
How do I install tvscreener?
Install the library from PyPI: pip install tvscreener Import the library and run a basic Stock Screener query: python -c "import tvscreener as tvs; df = tvs.StockScreener().get(); print(df.head())"
Where can I get tvscreener?
The source code and installation instructions are on GitHub: https://github.com/deepentropy/tvscreener

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects