Tradingview Reader

opencli TradingView Command Reference (Read-Only)

Complete read-only reference for the tradingview opencli adapter that lives in this repo's opencli-plugins/tradingview tree, scoped to financial research use cases.

Install: npm install -g @jackwener/opencli && opencli plugin install github:himself65/finance-skills/tradingview

This skill is read-only. No write operations, no trade execution.

Setup

The adapter connects to a running TradingView.app over Chrome DevTools Protocol (CDP) — no bot account, no API key, no Browser Bridge extension.

Requirements:

1. Node.js >= 24 (the tradingview plugin declares engines.node >= 24)

2. TradingView.app installed on macOS, logged in

3. App launched with --remote-debugging-port=9222 (the launch command handles this)

Launch with CDP:

opencli tradingview launch              # default port 9222
opencli tradingview launch --port 9333  # custom port

The launch step quits any running TradingView and reopens it with the debug port. Warn the user to save chart layouts first.

Verify connectivity:

opencli tradingview status

Read Operations

launch

Quits any running TradingView and re-launches it with --remote-debugging-port enabled. Polls /json/version until the app is reachable.

opencli tradingview launch
opencli tradingview launch --port 9333
opencli tradingview launch -f json

Output columns: port, pid, ready

status

Reports CDP connection state and lists active TradingView tabs (chart, symbol page, options page).

opencli tradingview status
opencli tradingview status -f json

Output columns: connected, tabs[] (each tab has id, type, url, title)

Use OPENCLI_CDP_TARGET=tradingview.com to disambiguate when multiple Electron CDP sessions are running on the host.

quote

Single-symbol spot quote, backed by scanner.tradingview.com/global/scan2.

opencli tradingview quote --ticker AAPL
opencli tradingview quote --ticker SPY --exchange NYSEARCA -f json
opencli tradingview quote --ticker BABA --exchange NYSE

Output columns: symbol, close, change, change_abs, currency, time

options-chain

Full options chain or filtered slice. Backed by scanner.tradingview.com/options/scan2. Returns one row per (expiry × strike × type) tuple — the response is the entire chain in one request, not paginated.

# Full chain (every expiry, every strike, calls + puts) — can be 3,000+ rows
opencli tradingview options-chain --ticker SNDK -f json

# One expiry, ATM ± 6 strikes, both call and put
opencli tradingview options-chain --ticker SNDK --expiry 2026-05-22 \
    --strikes-around-spot 6 -f json

# Calls only, full strike list, single expiry
opencli tradingview options-chain --ticker NVDA --expiry 2026-06-19 \
    --type call --strikes-around-spot 0 -f json

# CSV export for spreadsheet analysis
opencli tradingview options-chain --ticker AAPL --expiry 2026-05-15 -f csv

Output columns: expiry, dte, strike, type, bid, ask, mid, iv, delta, gamma, theta, vega, rho, theo, bid_iv, ask_iv, symbol

Symbol format: OPRA:<ROOT><YY><MM><DD><C|P><STRIKE> (OCC-style, e.g. OPRA:SNDK260522C2090.0).

Sample row (JSON):

{
  "expiry": "2026-05-22", "dte": 12, "strike": 2090, "type": "call",
  "bid": 12.9, "ask": 18.4, "mid": 15.65, "iv": 1.0953,
  "delta": 0.1035, "gamma": 0.000542, "theta": -2.177, "vega": 0.5456, "rho": 0.0552,
  "theo": 15.0, "bid_iv": 1.0546, "ask_iv": 1.1540,
  "symbol": "OPRA:SNDK260522C2090.0"
}

Common analyst workflows

• IV regime check: --strikes-around-spot 0 --expiry <next-monthly> → look at ATM IV vs IV at ±20%.

• Skew measurement: filter calls and puts at equidistant OTM strikes (e.g. ±10% from spot), compare IVs to quantify put skew.

• Liquidity scan before structure: sort by (ask - bid)/mid to flag wide spreads before placing a multi-leg order.

• Theoretical edge: compare mid to theo per row — large positive theo - mid suggests a market mispricing (or stale data — verify with the bid IV / ask IV envelope).

options-expiries

Lists every available expiration for a ticker with DTE and contract counts. Useful before pulling a full chain to know what's available.

opencli tradingview options-expiries --ticker SNDK
opencli tradingview options-expiries --ticker SPY --exchange NYSEARCA -f json

Output columns: expiry, dte, contracts_count

chart-state

Returns the current symbol/interval/layout of an active chart tab via CDP Runtime.evaluate.

opencli tradingview chart-state               # picks the first chart tab
opencli tradingview chart-state --tab abc123  # specific tab id (from `status`)
opencli tradingview chart-state -f json

Output columns: layout_id, symbol, interval, url

screenshot

Captures a PNG of a chart tab via CDP Page.captureScreenshot.

opencli tradingview screenshot --output ~/charts/nvda.png
opencli tradingview screenshot --tab abc123 --output ./snap.png

Output columns: path, bytes

Output Formats

All commands support the -f / --format flag:

Financial Research Workflows

Quick IV / skew check on a single ticker

# 1. List expiries, pick the front month
opencli tradingview options-expiries --ticker NVDA -f json

# 2. Pull ATM band for that expiry, both call and put
opencli tradingview options-chain --ticker NVDA --expiry 2026-05-15 \
    --strikes-around-spot 6 -f json

# 3. Compare ATM call IV vs ATM put IV → skew direction

Liquidity check before a multi-leg structure

# Pull the legs you plan to trade
opencli tradingview options-chain --ticker AAPL --expiry 2026-06-19 \
    --strikes-around-spot 8 -f csv > aapl_chain.csv

# In the CSV: sort by (ask-bid)/mid descending → widest spreads at the top
# Avoid legs with > 5–10% relative spread on liquid names

Capture a chart for research notes

# 1. Identify what's currently shown
opencli tradingview chart-state -f json

# 2. Snapshot it
opencli tradingview screenshot --output ~/research/sndk-2026-05-10.png

Error Reference

screener

Generic stock / crypto / forex / futures / bond screener via scanner.tradingview.com/{market}/scan2. Same backend powers all of TradingView's screener, movers, and heatmap pages.

# US stocks with RSI(1h) below 30, sorted by volume
opencli tradingview screener \
    --market america \
    --columns "name,close,RSI|60,volume,market_cap_basic,sector.tr" \
    --filter '[{"left":"RSI|60","operation":"less","right":30}]' \
    --sort volume:desc \
    --limit 25 -f json

# Top 50 crypto by market cap
opencli tradingview screener \
    --market coin \
    --columns "name,close,change,market_cap_calc,total_volume_calc" \
    --sort market_cap_calc:desc --limit 50 -f json

# Specific ticker subset (skip filter, supply tickers explicitly)
opencli tradingview screener \
    --market america \
    --tickers "NASDAQ:AAPL,NASDAQ:MSFT,NASDAQ:NVDA" \
    --columns "name,close,change,market_cap_basic,price_earnings_ttm" -f json

Market codes

• Stocks (per country): america, uk, germany, france, japan, india, china, hongkong, korea, taiwan, singapore, australia, canada, brazil, mexico, israel, saudi, etc. (~70 codes)

• Cross-class: crypto (CEX pairs), coin (crypto coins, different schema), forex, futures, bond, cfd, economics2, options, global

Filter operations

equal, nequal, greater, egreater, less, eless, in_range, not_in_range, empty, nempty, match (substring), nmatch, crosses, crosses_above, crosses_below, above%, below%, in_range%. For boolean composition use the filter2: {operator, operands} field directly via the page-context API (not currently exposed via --filter).

Field catalog

3,000+ stock fields (1,018 deduplicated). See TradingView-Screener fields reference for the full list. Common ones:

• Price: close, open, high, low, change, change_abs, gap, volume, volume_change

• Fundamentals: market_cap_basic, price_earnings_ttm, price_book_fq, dividend_yield_recent, earnings_per_share_basic_ttm, revenue_ttm, total_debt, return_on_equity_fy

• Technicals: RSI, RSI|<tf>, MACD.macd, MACD.signal, BB.upper, BB.lower, ATR, ADX, Aroon.Up, Aroon.Down, MOM, Mom, Stoch.K, Stoch.D

• Recommendation: Recommend.All, Recommend.MA, Recommend.Other (range -1..1)

• Categorical: type, subtype, sector, sector.tr (translated), industry, industry.tr, country, exchange

Common analyst workflows

• Oversold scan: --filter '[{"left":"RSI|60","operation":"less","right":30}]' --sort volume:desc → high-volume names with 1h RSI < 30.

• Earnings beats: --filter '[{"left":"earnings_per_share_basic_ttm","operation":"egreater","right":0},{"left":"eps_surprise_percent_fq","operation":"greater","right":5}]'.

• Sector rotation: group results by sector.tr after pulling top 200 by change.

• Index constituents: use --tickers with the SP500 / Nasdaq100 list to pull the same row set across multiple metrics in one call.

search

Symbol / instrument autocomplete. Backed by symbol-search.tradingview.com/symbol_search/v3/. Use this whenever the user's ticker is ambiguous (e.g. "SPY" matches multiple listings) or to discover available exchanges for a name.

opencli tradingview search --query "nvidia" -f json
opencli tradingview search --query "BTC" --type crypto --exchange BINANCE -f json
opencli tradingview search --query "9988" --country HK

Output columns: symbol (full EXCH:SYM), description, type, exchange, country, currency.

news

TradingView's news headlines feed (or full story). Backed by news-headlines.tradingview.com/v2/. Two modes:

• List (default): paginated headlines, filterable by symbol / category / area / section / provider.

• Story (--id <story-id>): one row with the full story body flattened to plain text.

# Global news feed
opencli tradingview news --limit 25 -f json

# Ticker-specific news
opencli tradingview news --symbol NASDAQ:AAPL --limit 10 -f json

# Analyst notes only, on Reuters
opencli tradingview news --section analysis --provider reuters -f json

# Full story by id
opencli tradingview news --id "tag:reuters.com,2026:newsml_..." -f json

Output columns (list mode): id, published, provider, title, urgency, related_symbols, link.

Output columns (story mode): id, published, provider, title, body (plain-text rendering of the AST), tags, link.

Common analyst workflows

• Pre-market scan: news --section markets_today --area AME --limit 20 for the morning brief.

• Earnings call follow-up: news --symbol <S> --section press_release → original release text via news --id <id> for AI summarization.

• Recommendation tracking: news --section recommendation --symbol <S> for upgrades/downgrades.

watchlists

Read-only access to the user's watchlists.

# List all custom watchlists (id, name, count, symbols)
opencli tradingview watchlists -f json

# Symbols in one watchlist
opencli tradingview watchlists --id rRwIJoVm -f json

# Colored-flag list (red, orange, yellow, green, blue, purple)
opencli tradingview watchlists --color red -f json

Output columns: id, name, symbol_count, symbols (comma-separated for table; array in JSON).

Note: This skill does not expose write endpoints (/append/, /replace/). Modifying watchlists must be done through the TradingView UI.

alerts

Read-only access to pricealerts.tradingview.com. One command, multiple modes via --type.

opencli tradingview alerts --type list      # all alerts (active + paused)
opencli tradingview alerts --type active    # currently armed
opencli tradingview alerts --type triggered # recently fired
opencli tradingview alerts --type offline   # fired while user was offline
opencli tradingview alerts --type log       # full historical fire log

Output columns: id, name, symbol, type, condition, value, active, status, fired_at.

Tier sensitivity: TradingView caps the number of saved alerts by tier (Free=1, Essential=10, Plus=20, Premium=400, Ultimate=unlimited). The API surface is identical; only the saved set changes.

Note: Write endpoints (/create_alert, /edit_alert, /remove_alert, /restart_alert) are intentionally NOT exposed.

Limitations

• macOS only — the launch helper relies on open -a TradingView --args. Linux / Windows desktop apps are not supported by this plugin.

• Logged-in app required — no auth bypass; data tier matches what the user sees in the app.

• Read-only in this skill — even if the plugin grows write commands later (alerts, watchlists), this skill forbids them.

• Single attached app at a time — if multiple Electron CDP sessions exist, set OPENCLI_CDP_TARGET.

• Field positions are read from the response — never hard-code field indices; if the plugin breaks because TradingView changes the wire format, file an issue at the plugin repo.

Best Practices

• Filter aggressively — full chains are 3,000+ rows. Default to ATM ± 6 strikes per expiry.

• Use -f json for programmatic processing and LLM context.

• Use -f csv for spreadsheet analysis of chains.

• Run status before options-chain if you suspect connectivity issues.

• Treat CDP endpoints as private — never log or display debug URLs, target ids, or layout ids.

• Spot self-consistency check — quote.close should fall within [min_strike, max_strike] of the chain. If not, suspect stale data or wrong exchange.