How shner-elmo/tradingview-screener works
This Python library builds TradingView screener queries and returns matching market data, commonly as a pandas DataFrame. Users can choose a market-specific screener, select fields and timeframes, compose filters, set sorting and limits, then submit the query; cookies can be supplied for authenticated real-time data. Column builds filter expressions, while models defines the query and response shapes. Source excerpts establish query construction, HTTP submission, and screener factories; unsampled query methods and response-conversion details are represented only at the documented level.
Main entry points: query.py Query Builder · column.py Column Filters · screeners.py Market Screeners · models.py Query Schemas
Components 7
Query Construction
- Query Builder
src/tradingview_screener/query.py - Column Filters
src/tradingview_screener/column.py
Screener Catalog
- Market Screeners
src/tradingview_screener/screeners.py
Data Contracts
- Query Schemas
src/tradingview_screener/models.py
Other components
- Library User
- TradingView API
- Pandas DataFrame
Connections 9
- Library User → Market Screeners: chooses market
README.md - Library User → Query Builder: builds query
README.md - Market Screeners → Query Builder: creates
src/tradingview_screener/screeners.py - Query Builder → Column Filters: uses fields
src/tradingview_screener/query.py - Column Filters → Query Schemas: types filters
src/tradingview_screener/column.py - Query Builder → Query Schemas: types payload
src/tradingview_screener/query.py - Query Builder → TradingView API: POSTs scan
src/tradingview_screener/query.py - TradingView API → Query Builder: returns results
README.md - Query Builder → Pandas DataFrame: builds DataFrame
src/tradingview_screener/query.py