Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
Query
✓ from tradingview_screener import Query
Correct import since v1.x.
Column
✓ from tradingview_screener import Column
✗ from tradingview_screener import column
Old name was lowercase 'column', now capitalized 'Column'. 'col' alias also available.
col
✓ from tradingview_screener import col
Convenience alias for Column, added in v3.0.0.
stocks
✓ from tradingview_screener import stocks
Pre-configured screener factories available since v3.2.0.
Basic usage: create a query, add filters with Column, scan and get DataFrame.
from tradingview_screener import Query, col
# Create a query to scan US stocks with price > 100 and volume > 1M
query = Query()
query = query.select('name', 'close', 'volume', 'market_cap_basic')
query = query.where(
col('close').above(100),
col('volume').above(1_000_000)
)
query = query.order_by('market_cap_basic', ascending=False)
count, df = query.get_scanner_data()
print(f"Found {count} stocks")
print(df.head())
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'tradingview_screener'
Library not installed. Common when using in a new environment.
fixRun: pip install tradingview-screener
AttributeError: 'Query' object has no attribute 'scan'
The 'scan()' method was removed in v3.0.0.
fixUse 'query.get_scanner_data()' instead.
ImportError: cannot import name 'column' from 'tradingview_screener'
The old lowercase 'column' name was removed in v3.0.0.
fixUse: from tradingview_screener import Column
Upgrade
Version history
3.2.0latest on PyPI · released May 7, 2026
Audit
Dependencies
No dependency data recorded yet.