GitHub - brandononchain/opentrade: The most powerful open-source TradingView AI agent. 50 tools, 15 models (Claude, GPT, Gemini, Qwen, DeepSeek, MiniMax), Pine Script v6, quant/HFT/hedge fund skills.

 _______ ______ _______ _______ _______ ______ _______ _____  _______
|       |   __ \    ___|    |  |_     _|   __ \   _   |     \|    ___|
|   -   |    __/    ___|       | |   | |      <       |  --  |    ___|
|_______|___|  |_______|__|____| |___| |___|__|___|___|_____/|_______|

    The most powerful open-source TradingView AI agent ever built.

📚 Full Documentation · Installation · Tools Reference · Quant Standards · Roadmap

OpenTrade connects frontier AI models to your live TradingView charts via Chrome DevTools Protocol. It reads your indicators, writes and compiles Pine Script, runs multi-symbol scans, executes quantitative analysis, and structures trades the way a hedge fund PM would — all through natural conversation. Choose from 15 models across 6 providers — Claude, GPT, Gemini, Qwen, DeepSeek, and MiniMax.

What Makes OpenTrade Different

Most "AI trading tools" are wrappers around chart screenshots or paper-thin APIs. OpenTrade is different:

Direct TradingView control — reads every indicator value, every Pine drawing, every price level from your actual live chart
Writes and compiles real Pine Script — not code snippets, but production-ready strategies that compile, run in the backtester, and get saved to your TradingView account
Institutional-grade analysis skills — quantitative regime detection, Kelly Criterion position sizing, HFT microstructure, multi-timeframe hedge fund workflows
6 AI providers, 15 models — Claude, GPT, Gemini, Qwen, DeepSeek, MiniMax — switch with one env var
Fully self-contained — one repo, npm install, done. No external services, no other repos, no subscriptions beyond your chosen LLM API

Quick Start

git clone https://github.com/brandononchain/opentrade.git
cd opentrade
npm install

Create .env in the project folder (see .env.example for all options):

LLM_MODEL=claude-sonnet
ANTHROPIC_API_KEY=sk-ant-...

Or use a different provider:

LLM_MODEL=qwen-max
QWEN_API_KEY=sk-...

Launch Chrome pointing at TradingView:

# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="C:\ChromeDebug" "https://www.tradingview.com/chart/"

# Mac
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir="/tmp/ChromeDebug" "https://www.tradingview.com/chart/"

Log into TradingView, then:

node src/cli/index.js

Interfaces

Terminal (default)

node src/cli/index.js

Full streaming chat. Tool calls visible in real time. Built-in commands: /state /screenshot /clear /quit

Browser UI

node src/cli/index.js server
# Open: http://localhost:7842

Screenshots render inline. Tool call timeline on every response. Good for longer sessions.

Single commands

node src/cli/index.js chat "analyze my chart"
node src/cli/index.js pine "write a VWAP deviation strategy"
node src/cli/index.js screenshot
node src/cli/index.js analyze my_script.pine

Skills

OpenTrade ships with 7 professional-grade analytical skills that activate automatically based on what you ask.

Chart Analysis

Triggers: "analyze my chart", "what's on my chart", "give me a market overview"

Reads every indicator on your chart, maps all Pine Script drawings, organizes levels by proximity to price, and produces a structured market report with a clear directional bias.

You: analyze my chart

Agent: ⚡ chart_get_state    → BTCUSDT · 1H · 8 indicators
       ⚡ quote_get           → last=67,420 change=-1.2%
       ⚡ data_get_study_values→ RSI=38.4, MACD=-142 bearish
       ⚡ data_get_pine_lines  → 6 levels identified
       ⚡ capture_screenshot   → chart captured

       BTCUSDT 1H Analysis
       Price: $67,420 | Change: -1.2%
       Structure: BEARISH — price below all EMAs
       Momentum:  RSI 38.4, approaching oversold territory
       🔴 Resistance: 68,100 / 69,500
       🟢 Support:    66,800 / 65,200
       Bias: BEARISH — watching 66,800 for bounce or break

Quantitative Analysis

Triggers: "quant analysis", "statistical edge", "vol regime", "return distribution", "is there edge here"

Computes institutional-grade statistics from your chart data: return distribution (mean, std, skew, kurtosis), volatility regime detection via 5-bar vs 20-bar vol ratio, z-score from 20-bar mean, momentum factor score, autocorrelation sign, and relative volume — then classifies the market regime and states whether statistical edge exists and what type.

You: run quant analysis on ES1!

Agent: RETURN STATS (last 200 bars)
       Mean return:   +0.03%  |  Volatility: 0.41% (6.5% annualized)
       Skewness:      -0.31   |  Kurtosis: 3.8 (mild fat tails)
       Sharpe equiv:  +0.73

       VOLATILITY REGIME
       5-bar vol: 0.38%  |  20-bar vol: 0.41%  |  Ratio: 0.93
       → STABLE — mean reversion strategies favored

       Z-SCORE: -1.82 (1.8 std devs below 20-bar mean)
       AUTOCORR: -0.12 → MEAN REVERTING market

       EDGE: YES — Mean Reversion — 72% confidence
       Recommended: Fade extremes, target VWAP reversion

Hedge Fund Analysis

Triggers: "hedge fund view", "institutional analysis", "risk/reward", "position size", "Kelly"

Full multi-timeframe confluence scan (Monthly → Weekly → Daily → Intraday), scores each timeframe -2 to +2, maps entry/stop/targets with explicit R-multiples, applies Kelly Criterion for position sizing, checks portfolio heat and factor correlation, and recommends the optimal trade expression (equity, options structure, or futures).

You: give me the hedge fund analysis on NVDA

Agent: MULTI-TIMEFRAME SIGNAL
       Monthly: +2 — Strong bull, EMA alignment, expanding volume
       Weekly:  +1 — Bullish, mild consolidation
       Daily:   +2 — Breakout from 3-week base, high rel volume
       Intraday:+1 — Above VWAP, holding 1σ band
       Composite: +1.5 → LONG BIAS

       TRADE SETUP
       Entry zone: $875–$882 (breakout retest)
       Stop:       $858 (below base low, -2.5%)
       T1:         $920 — 2.1R (50% position)
       T2:         $955 — 3.9R (30% position)
       T3:         $990 — 5.6R (20% position)

       SIZING — Half Kelly ($1M AUM)
       Kelly: 4.2%  →  Half Kelly: $21,000  →  24 shares @ $877

       STRUCTURE: Long equity (high conviction) or Jan $900 calls

HFT & Market Microstructure

Triggers: "order flow", "VWAP", "microstructure", "intraday edge", "execution", "liquidity"

Switches to 1-minute chart and analyzes VWAP position and band touches (±1σ to ±3σ), volume profile levels (POC, VAH, VAL, HVNs, LVNs), opening range status, time-of-day session phase, stop cluster locations (where HFT liquidity hunts occur), and recommends the optimal execution algorithm (VWAP/TWAP/Aggressive/Sniper).

You: HFT microstructure analysis on SPY

Agent: VWAP STATUS
       Price: $512.40 — ABOVE VWAP by $1.20 (+0.23%)
       Band touch: Upper 1σ ($512.80) — approaching
       Signal: HOLD LONG, watch for fade at +2σ ($514.20)

       VOLUME PROFILE
       POC: $511.10 — strong magnet below
       Price: ABOVE VAH ($512.00) → breakout territory
       Nearest LVN: $513.50 → expect fast move through it

       SESSION PHASE: Power Hour (14:30 ET)
       OR Status: BROKEN HIGH — momentum intact
       Consecutive up bars: 6 — extended, reduce new long size

       STOP CLUSTERS
       Above: $514.00 (round number + prior high)  ← HFT target
       Below: $511.00 (VAH retest level)

       EXECUTION: Aggressive algo  |  Hold long to $513.50 LVN
       Stop: $510.80 below VAH

Portfolio Scanner

Triggers: "scan my watchlist", "rank these symbols", "best setup", "relative strength"

Systematically scores every symbol in your watchlist (or a custom list) across 5 factors: momentum (1/5/20-day returns), RSI positioning, ATR volatility profile, volume confirmation, and EMA structure alignment. Calculates relative strength vs SPY, ranks all symbols 0–100, and produces the top 3 actionable setups with ATR-based position sizing.

You: scan my watchlist and find the best setups

Agent: PORTFOLIO SCAN — 12 symbols — Daily

       # | Symbol | Score | RS vs SPY | Signal
       1 | NVDA   | 87/100| +12.4%    | STRONG BUY
       2 | META   | 74/100| +6.8%     | BUY
       3 | AMZN   | 68/100| +3.2%     | BUY
       4 | MSFT   | 52/100| +1.1%     | WATCH
       5 | AAPL   | 44/100| -0.8%     | NEUTRAL
       ...

       TOP SETUP: NVDA (87/100)
       Entry: $878 (OR retest)  |  Stop: $858 (-2.3%)
       Target: $920 (2.1R)      |  Size: 24 shares ($100K, 0.5% risk)

Macro Regime Analysis

Triggers: "macro analysis", "regime", "sector rotation", "asset allocation", "risk-on/off"

Scans 9 cross-asset instruments (SPY, QQQ, IWM, VIX, TLT, HYG, GLD, USO, UUP), scores growth and inflation signals, classifies the current regime (Goldilocks / Stagflation / Deflation / Recovery), and maps the optimal asset allocation, sector rotation, and factor tilt implied by that regime.

You: what is the current macro regime?

Agent: CROSS-ASSET SIGNALS
       SPY +8.2% (20D) | VIX 14.2 LOW | TLT -2.1% | HYG +1.8%
       GLD +3.4% | USO +5.1% | UUP -0.8%

       Growth: +1.8/2 → EXPANSION
       Inflation: +0.9/2 → MODERATE
       Risk appetite: RISK-ON (VIX low, HYG bid, IWM leading)

       REGIME: GOLDILOCKS (Growth+, Inflation moderate)

       ASSET ALLOCATION TILT
       Equities: OVERWEIGHT — growth + momentum stocks
       Bonds:    UNDERWEIGHT — avoid long duration
       Commodities: NEUTRAL — oil ok, gold less needed

       SECTOR ROTATION
       Overweight: Technology (XLK), Financials (XLF), Industrials (XLI)
       Underweight: Utilities (XLU), Consumer Staples (XLP), REITs

Strategy Backtesting

Triggers: "backtest", "test this strategy", "strategy tester", "does this have edge"

Writes a complete Pine Script v6 strategy with realistic commission (0.05%), slippage (2 ticks), and position sizing — uses [1] indexing to prevent lookahead bias — compiles it, opens the Strategy Tester, reads all performance metrics, evaluates them against institutional minimums (profit factor >1.5, max DD <20%, >30 trades), and flags red flags or improvement paths.

Pine Script Development

Triggers: "write a Pine Script", "build an indicator", "compile this"

Full AI development loop: write → static analysis → inject → compile → fix errors (up to 5 attempts) → screenshot → save. No manual work required.

Pine Script Templates (11 built-in)

Template	Type	Description
`ema_ribbon`	Indicator	5-EMA ribbon with trend background
`rsi_divergence`	Indicator	Pivot-based RSI divergence detector
`vwap_bands`	Indicator	VWAP + 3 standard deviation bands
`session_levels`	Indicator	NY / London / Asia session H/L
`ema_cross_strategy`	Strategy	EMA crossover with RSI filter
`supertrend_strategy`	Strategy	ATR-based supertrend with signals
`zscore_mean_reversion`	Strategy	[Quant] Statistical z-score fade
`vwap_institutional`	Strategy	[HFT] VWAP band fade + reclaim
`momentum_factor`	Strategy	[Quant] Weighted multi-period momentum
`opening_range_breakout`	Strategy	[HFT] Intraday ORB with volume filter
`multi_factor_dashboard`	Indicator	[Quant] Live 4-factor scoring table

Tools (50 total)

Chart — chart_get_state chart_set_symbol chart_set_timeframe chart_set_type chart_manage_indicator chart_scroll_to_date

Data — quote_get data_get_study_values data_get_ohlcv data_get_pine_lines data_get_pine_labels data_get_pine_tables data_get_pine_boxes

Pine Script — pine_set_source pine_smart_compile pine_get_errors pine_get_console pine_save pine_new pine_check pine_list_scripts pine_open

Visual — capture_screenshot draw_shape draw_list draw_clear draw_remove_one

Alerts — alert_create alert_list

Replay — replay_start replay_step replay_autoplay replay_trade replay_status replay_stop

Indicators — indicator_set_inputs indicator_toggle_visibility

Symbols — symbol_info symbol_search

Watchlist — watchlist_get watchlist_add

UI — ui_click ui_evaluate ui_open_panel

Batch — batch_run

System — tv_health_check tv_launch tv_ui_state

Supported Models

Set LLM_MODEL in your .env to any alias below. Only the API key for that provider is required.

Flagship (Deep analysis, complex tool chains)

Alias	Model	Provider	Context	Cost/1K tok
`claude-opus`	Claude Opus 4	Anthropic	1M	$0.015 / $0.075
`o3`	OpenAI o3	OpenAI	200K	$0.002 / $0.008
`gemini-2.5-pro`	Gemini 2.5 Pro	Google	1M	$0.001 / $0.010
`qwen-max`	Qwen-Max	Alibaba	256K	$0.002 / $0.006
`deepseek-reasoner`	DeepSeek R1	DeepSeek	128K	$0.001 / $0.002

Balanced (Daily driver, good cost/quality)

Alias	Model	Provider	Context	Cost/1K tok
`claude-sonnet`	Claude Sonnet 4	Anthropic	1M	$0.003 / $0.015
`gpt-4.1`	GPT-4.1	OpenAI	1M	$0.002 / $0.008
`o4-mini`	OpenAI o4-mini	OpenAI	200K	$0.001 / $0.004
`qwen-plus`	Qwen-Plus	Alibaba	131K	$0.001 / $0.002
`deepseek-chat`	DeepSeek V3	DeepSeek	128K	$0.000 / $0.001
`minimax`	MiniMax M1	MiniMax	1M	$0.000 / $0.001

Fast (Speed & low cost, simple tasks)

Alias	Model	Provider	Context	Cost/1K tok
`claude-haiku`	Claude Haiku 4	Anthropic	200K	$0.001 / $0.005
`gpt-4.1-mini`	GPT-4.1 Mini	OpenAI	1M	$0.000 / $0.002
`gemini-2.5-flash`	Gemini 2.5 Flash	Google	1M	$0.000 / $0.001
`qwen-turbo`	Qwen-Turbo	Alibaba	1M	$0.000 / $0.001

Get API Keys

Provider	Sign up
Anthropic (Claude)	console.anthropic.com
OpenAI (GPT, o-series)	platform.openai.com
Google (Gemini)	aistudio.google.com
Alibaba (Qwen)	dashscope.console.aliyun.com
DeepSeek	platform.deepseek.com
MiniMax	minimaxi.chat

Architecture

Your terminal / browser
        │
        ▼
   Provider Abstraction Layer  (src/agent/providers/)
        │  routes to the configured LLM automatically
        │
        ├── Anthropic  → Claude Opus / Sonnet / Haiku
        ├── OpenAI     → GPT-4.1 / o3 / o4-mini
        ├── Google     → Gemini 2.5 Pro / Flash
        ├── Qwen       → Qwen-Max / Plus / Turbo
        ├── DeepSeek   → V3 / R1
        └── MiniMax    → M1
                │
                ▼
   Agent Loop  (src/agent/claude.js)
        │  selects skill, orchestrates tool calls
        │
        ├── chart-analysis      (7 tools in sequence)
        ├── quant-analysis      (200-bar stats engine)
        ├── hedge-fund-analysis (MTF + Kelly sizing)
        ├── hft-microstructure  (1-min VWAP + volume profile)
        ├── portfolio-scanner   (5-factor scoring)
        ├── macro-regime        (9 cross-asset instruments)
        └── strategy-backtest   (Pine loop + tester reader)
                │
                ▼
   src/tv/tools.js       ← 50 TradingView control functions
   src/tv/connection.js  ← Chrome DevTools Protocol engine
                │
                ▼
   Chrome :9222 → TradingView (live charts)

Everything runs in your local environment. No cloud dependency except your chosen LLM API.

Setup

Requirements

Node.js 18+ — nodejs.org
Chrome — google.com/chrome
TradingView account — tradingview.com
API key for at least one provider — see Supported Models

Install

git clone https://github.com/brandononchain/opentrade.git
cd opentrade
npm install

Configure

Copy .env.example and fill in your chosen provider's API key:

cp .env.example .env

LLM_MODEL=claude-sonnet
ANTHROPIC_API_KEY=sk-ant-...
TV_CDP_PORT=9222
TVA_PORT=7842

Only set the API key for the provider you're using. See .env.example for the full list.

Launch TradingView in Chrome

# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" ^
  --remote-debugging-port=9222 ^
  --user-data-dir="C:\ChromeDebug" ^
  "https://www.tradingview.com/chart/"

# Mac
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  --user-data-dir="/tmp/ChromeDebug" \
  "https://www.tradingview.com/chart/"

Log into TradingView when Chrome opens. Keep this window running.

Run

node src/cli/index.js          # interactive terminal
node src/cli/index.js server   # browser UI at localhost:7842

Example Conversations

# Quantitative regime detection
"Run quant analysis on the current chart — is there statistical edge?"

# Institutional trade structuring
"Give me the hedge fund analysis on NVDA with Kelly position sizing"

# HFT intraday execution
"VWAP microstructure on ES1! — what's the execution algo right now?"

# Portfolio screening
"Scan NVDA, META, AMZN, MSFT, GOOGL and rank by momentum score"

# Macro positioning
"What's the current macro regime and how should I be positioned?"

# Strategy development
"Write a z-score mean reversion strategy, backtest it on BTCUSDT daily, show me the results"

# Pine Script
"Write a session high/low indicator with VWAP and volume profile overlay"

# Multi-timeframe
"Give me the monthly, weekly, and daily structure on SPY and tell me the composite bias"

# Risk management
"I'm considering a $50K position in TSLA — what's the ATR-based stop and Kelly size?"

# Replay practice
"Start a replay session from 3 months ago and help me practice my entries on ES1!"

Roadmap

The goal is to make OpenTrade the most powerful open-source TradingView agent ever built. Planned additions:

Tiered model routing — automatically use cheap models for simple tool dispatches and flagship models for complex analysis
Options flow integration — read implied vol, skew, put/call ratio from TradingView options chain
Alert automation — trigger Pine Script alerts → webhook → external execution
Pairs trading skill — statistical arbitrage setup detection and spread monitoring
Order flow imbalance — footprint chart reading and delta analysis
Multi-chart layout — simultaneous analysis across multiple chart panes
Portfolio P&L tracking — track paper trades made through replay across sessions
Web scraping layer — pull earnings dates, economic calendar, insider flow to enrich analysis

Pull requests welcome.

Environment Variables

Variable	Required	Default	Description
`LLM_MODEL`	No	`claude-sonnet`	Model alias — see Supported Models
`ANTHROPIC_API_KEY`	If using Claude	—	console.anthropic.com
`OPENAI_API_KEY`	If using GPT/o-series	—	platform.openai.com
`GOOGLE_API_KEY`	If using Gemini	—	aistudio.google.com
`QWEN_API_KEY`	If using Qwen	—	dashscope.console.aliyun.com
`DEEPSEEK_API_KEY`	If using DeepSeek	—	platform.deepseek.com
`MINIMAX_API_KEY`	If using MiniMax	—	minimaxi.chat
`TV_CDP_PORT`	No	`9222`	Chrome debug port
`TVA_PORT`	No	`7842`	Browser UI port

FAQ

Do I need VS Code or any IDE? No. Runs from any terminal — PowerShell, Terminal.app, iTerm2, Windows Terminal.

Does it work with Edge instead of Chrome? Yes — Edge is Chromium-based and supports the same --remote-debugging-port flag.

Do I need a TradingView subscription? Free account works. Saved scripts and some indicators require a paid plan.

How much does it cost? Depends on your chosen model. With DeepSeek V3, a full chart analysis costs under $0.001. With Claude Sonnet, ~$0.01–0.03. A complete backtest workflow runs $0.01–0.20 depending on the model.

Is my API key secure? It stays in your local .env file, gitignored, and only sent directly to your chosen provider's API.

Can I run this on a cloud server? The LLM API calls can run anywhere. TradingView requires Chrome running with CDP enabled — on a cloud VM you'd need Xvfb (virtual display) to run Chrome headlessly.

Can I switch models mid-session? Change LLM_MODEL in your .env and restart the agent. All 15 models use the same tool interface — your workflow doesn't change.

Disclaimer

OpenTrade is an independent project for personal, educational use only. Not affiliated with TradingView Inc., Anthropic, OpenAI, Google, Alibaba, DeepSeek, or MiniMax. Using Chrome DevTools Protocol to automate TradingView may conflict with TradingView's Terms of Use. Nothing here is financial advice. Use at your own risk.

License

MIT — do whatever you want with it. Build something great.

Name		Name	Last commit message	Last commit date
Latest commit History 85 Commits
.github/workflows		.github/workflows
docs		docs
scripts		scripts
src		src
tests		tests
.env.example		.env.example
.gitignore		.gitignore
.nojekyll		.nojekyll
ABOUT.md		ABOUT.md
CLAUDE.md		CLAUDE.md
README.md		README.md
_config.yml		_config.yml
package-lock.json		package-lock.json
package.json		package.json
probe2.txt		probe2.txt

Folders and files

Latest commit

History

Repository files navigation

What Makes OpenTrade Different

Quick Start

Interfaces

Terminal (default)

Browser UI

Single commands

Skills

Chart Analysis

Quantitative Analysis

Hedge Fund Analysis

HFT & Market Microstructure

Portfolio Scanner

Macro Regime Analysis

Strategy Backtesting

Pine Script Development

Pine Script Templates (11 built-in)

Tools (50 total)

Supported Models

Flagship (Deep analysis, complex tool chains)

Balanced (Daily driver, good cost/quality)

Fast (Speed & low cost, simple tasks)

Get API Keys

Architecture

Setup

Requirements

Install

Configure

Launch TradingView in Chrome

Run

Example Conversations

Roadmap

Environment Variables

FAQ

Disclaimer

License

About

Topics

Resources

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages