tradingview-screener

TradingView Screener

Screen stocks, crypto, forex, bonds, futures, and coins using TradingView's market data. Zero auth required.

Setup (Run Once)

Before first use, run the install script to create a venv and install dependencies:

bash skills/tradingview-screener/install.sh

This creates .venv/ inside the skill directory with all required packages.

Execution

All scripts use the skill's own venv:

skills/tradingview-screener/.venv/bin/python3 skills/tradingview-screener/scripts/<script>.py [args]

Windows:

skills/tradingview-screener/.venv/Scripts/python.exe skills/tradingview-screener/scripts/<script>.py [args]

Modes

Mode	Description	Script
Screen	One-time scan with filters, columns, sort	screen.py
Signal	YAML-driven signal detection (pre-filters + computed signals)	signal-engine.py

Quick Start

Screen Mode

skills/tradingview-screener/.venv/bin/python3 skills/tradingview-screener/scripts/screen.py \
  --asset-class stock --limit 20 \
  --filters '[{"field":"MARKET_CAPITALIZATION","op":">","value":1000000000}]' \
  --columns NAME,PRICE,CHANGE_PERCENT,VOLUME \
  --sort-by VOLUME --sort-order desc

Signal Mode

# List available signals
skills/tradingview-screener/.venv/bin/python3 skills/tradingview-screener/scripts/signal-engine.py --list

# Run a signal
skills/tradingview-screener/.venv/bin/python3 skills/tradingview-screener/scripts/signal-engine.py --signal golden-cross

Asset Classes

Class	Screener	Field Enum
stock	StockScreener	StockField
crypto	CryptoScreener	CryptoField
forex	ForexScreener	ForexField
bond	BondScreener	BondField
futures	FuturesScreener	FuturesField
coin	CoinScreener	CoinField

Signal Types (Computed)

Type	Description	Key Params
crossover	Fast field crosses slow field	fast, slow, direction
threshold	Field crosses a value	field, op, value
expression	Pandas expression on DataFrame	expr
range	Field between min/max bounds	field, min, max

Filter Operators

>, >=, <, <=, ==, !=, between (value: [min, max]), isin (value: [...])

Common Stock Fields

NAME, PRICE, CHANGE_PERCENT, VOLUME, MARKET_CAPITALIZATION, SECTOR, SIMPLE_MOVING_AVERAGE_50, SIMPLE_MOVING_AVERAGE_200, RELATIVE_STRENGTH_INDEX_14, MACD_LEVEL_12_26, AVERAGE_VOLUME_30_DAY

Use StockField.search("keyword") in Python to discover more fields (13,000+ available).

Pre-built Signals

Signal	File	Description
Golden Cross	state/signals/golden-cross.yaml	SMA50 above SMA200 (bullish)
Oversold Bounce	state/signals/oversold-bounce.yaml	RSI < 30 + price rising
Volume Breakout	state/signals/volume-breakout.yaml	Volume > 2x avg + momentum

Output Format

**Stock Screener** | 15 results | Sorted by VOLUME desc

| NAME | PRICE | CHANGE_PERCENT | VOLUME |
|------|-------|----------------|--------|
| AAPL | 185.50 | 2.3 | 80000000 |
...

Timeframes

1, 5, 15, 30, 60, 120, 240, 1D, 1W, 1M

Pass --timeframe 60 to apply hourly interval to technical indicators.

References

• API Guide - Screener types, filters, field discovery
• Signals Guide - YAML schema, signal type configs
• Strategy Templates - Pre-built screening strategies
• Field Presets - Common field groups per asset class