---
id: tradingview-screener
version: "3.2.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# tradingview-screener — A package for creating stock screeners with the TradingView API

License: permissive · Maintenance: active · Downloads: 160.1K/mo

## What it is and what it does

tradingview-screener is a low-level Python wrapper around TradingView's official screener API that lets you programmatically query market data without web scraping. It supports stocks across 70 countries, crypto, options, forex, CFDs, futures, bonds, and more—retrieving OHLC data, technical indicators, fundamental metrics like P/E and EPS, and TradingView-specific fields. You build queries using a chainable API (select, where, order_by, limit) with SQL-like filtering syntax and can freely mix multiple timeframes (1m through 1M) per field.

The package depends on pandas for data handling and requests for HTTP communication. It returns results as pandas DataFrames, making it easy to integrate with analysis pipelines. Real-time data requires TradingView session authentication via cookies or API login; unauthenticated queries return delayed data. The library is designed to be forward-compatible and documents the full API surface, including screener functions for stocks, crypto, options, forex, and other instruments.

Use it for:

- Build automated stock screeners that filter by market cap, volume, technical indicators, and fundamental ratios without manual TradingView UI interaction.
- Retrieve historical OHLC and indicator data across multiple timeframes for backtesting trading strategies.
- Query crypto pairs, options chains, or forex instruments to monitor specific markets or build watchlists programmatically.
- Integrate TradingView data into a larger financial analysis or portfolio management system via pandas DataFrames.
- Access real-time streaming data for supported exchanges when authenticated with TradingView session credentials.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Query TradingView's screener API to retrieve market data across stocks, crypto, options, forex, futures, and other instruments with support for technical indicators, fundamental metrics, and multiple timeframes.

Yes. The package has low install friction, active maintenance, permissive MIT licensing, and no known vulnerabilities. It directly wraps TradingView's official API, eliminating the need for web scraping. Install it if you need programmatic access to TradingView market data; be aware that real-time data requires authentication and that unauthenticated queries return delayed data only.

## Install

pip install tradingview-screener
uv add tradingview-screener
poetry add tradingview-screener

## Installing tradingview-screener

Before you install: Low friction install with only two runtime dependencies (pandas, requests). Active maintenance with a recent release and 1130 GitHub stars. Supports Python 3.9 through 3.14.

License in practice: MIT license permits commercial and private use with minimal restrictions—you may use, modify, and distribute the package freely as long as you include the license notice.

Quickstart:

pip install tradingview-screener

from tradingview_screener import Query

x = (Query()
 .select('name', 'close', 'volume', 'market_cap_basic')
 .get_scanner_data())
print(x)

Requires TradingView session authentication (via cookies or API login) for real-time data; unauthenticated queries return delayed data only.

Verify before relying:

- Whether free tier access is sufficient for typical use cases or if a paid TradingView subscription is required
- Rate limiting and request throttling policies to avoid account bans or temporary blocks
- Exact number of supported data fields beyond the stated 3000+ figure

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 160.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tradingview api screener, stock market data python, technical indicators query, multi-asset market scanner, financial data retrieval api, crypto stocks options data, real-time market screener, financial-data, market-screener, tradingview-api

[View on SkillFed](https://skillfed.io/packages/tradingview-screener) · [View on PyPI](https://pypi.org/project/tradingview-screener/)