🔭 WHAT IS QR PRO SCANNER

QR Pro Scanner is a live trading dashboard that watches 5 futures instruments across 3 timeframes simultaneously, looking for stochastic divergence setups in real time. When TradingView detects a qualifying setup, it fires a webhook to your local server, and the scanner displays the signal within 2 seconds.

The scanner is designed for active trading and streaming. Everything is color-coded and large enough to read on stream while you're focused on your charts.

Architecture: TradingView Pine Script → Webhook POST → Node.js server (port 3001) → React dashboard (localhost:5173, polls every 2 seconds) → Your screen / OBS

What the Scanner Shows

Live stochastic readings for all 4 indicators across every instrument and timeframe
Signal status: WATCHING → ARMED → DIV → CONFIRM → BUY / SELL
Context signals: CROSS, SURGE, COIL, BIAS, DEPTH on every cell
Stochastic heat map showing average %D across all instruments and timeframes
Live alert feed showing every signal as it fires with timestamps
Session counts (total BUYs and SELLs per instrument)
Market bias gauge showing bullish vs bearish signal ratio

⚙️ HOW A SIGNAL FIRES — THE 4-STEP PIPELINE

Every BUY and SELL signal goes through 4 stages. No shortcuts. This multi-step confirmation is what makes the signals meaningful rather than noise.

1

ARM

All 4 %D lines enter oversold (<20) or overbought (>80) zone together

2

STAGE 1

System locks in the extreme reading and begins tracking for divergence

3

DIV

9-3 or 14-3 (or both) diverge ≥2 points from Stage 1 reading

4

CONFIRM

All 4 %D lines begin reversing together → BUY or SELL fires

Why Stage 1 matters: The system doesn't just look for a cross or a reversal. It waits for price to make a new extreme while the stochastics show divergence — meaning momentum is fading even as price pushes further. That divergence is the edge.

What DIV Type Means

When a signal fires, the scanner shows which stochastic diverged:

9-3 — The fastest stochastic diverged first. Expect a sharper, quicker reversal
14-3 — The mid-speed stochastic diverged. Slightly slower but more reliable confirmation
BOTH — Both 9-3 and 14-3 diverged. This is the strongest signal — two confirmations at once

📊 THE 4 STOCHASTIC INDICATORS

The scanner uses 4 stochastics running simultaneously. Each one operates at a different speed. Together they give you a complete picture from the fastest momentum read to the macro directional bias.

9-3

9 period, 3 smooth

Fastest signal generator. First to reach oversold/overbought and first to diverge. This is your trigger.

FASTEST

14-3

14 period, 3 smooth

Standard stochastic. Provides the second divergence confirmation. More reliable than 9-3 alone.

MID SPEED

40-4

40 period, 4 smooth

Intermediate trend context. When this is also in the zone, the setup has more structural depth.

SLOW

60-10

60 period, 10 smooth

Macro directional bias. Above 60 = bullish backdrop, below 40 = bearish. This is the wind direction.

MACRO

Reading the Bars

Each stochastic bar in the scanner shows a colored fill from 0 to 100. The color changes based on zone:

Color	Zone	Range	Meaning
■ Green	Oversold	0 – 20	Extreme low — BUY setups activate here
■ Lime	Low	21 – 35	Approaching oversold — watch for ARM
■ Grey	Mid	36 – 64	Neutral — no setup active
■ Orange	High	65 – 79	Approaching overbought — watch for ARM
■ Red	Overbought	80 – 100	Extreme high — SELL setups activate here

🚦 MAIN SIGNALS

These are the primary signals displayed in the matrix for each instrument × timeframe cell.

▲ BUY

All 4 stages complete in oversold territory. All 4 %D lines have reversed upward together. This is the full entry signal for a long trade.

Best used when 60-10 BIAS is also BULL and DEPTH > 60

▼ SELL

All 4 stages complete in overbought territory. All 4 %D lines have reversed downward together. This is the full entry signal for a short trade.

Best used when 60-10 BIAS is also BEAR and DEPTH > 60

⚡ ARMED LONG

All 4 %D lines are in oversold (<20). Stage 1 has been locked. The system is actively watching for divergence. A BUY signal may be coming.

Prepare your entry. Watch for DIV to fire next.

⚡ ARMED SHORT

All 4 %D lines are in overbought (>80). Stage 1 has been locked. The system is actively watching for divergence. A SELL signal may be coming.

Prepare your short. Watch for DIV to fire next.

◆ DIV BULL

Stage 3 complete. 9-3 and/or 14-3 have diverged from Stage 1 in oversold territory. The stochastics are showing momentum divergence before price turns.

One step from BUY signal. Very high alert.

◆ DIV BEAR

Stage 3 complete. 9-3 and/or 14-3 have diverged from Stage 1 in overbought territory. Momentum is fading at the highs.

One step from SELL signal. Very high alert.

— WATCHING

No active setup on this instrument/timeframe. The stochastics are in mid-range (20–80) or conditions don't meet any stage threshold. Neutral.

Nothing to act on here right now.

🔎 CONTEXT SIGNALS — CROSS, SURGE, COIL, BIAS, DEPTH

Context signals appear as small badges inside each matrix cell. They don't fire trades on their own — they add depth to whatever the main signal is showing. The more context badges aligned with a main signal, the higher conviction the setup.

✕ CROSS ▲ / ▼

Fires when the 9-3 %D line crosses above or below the 14-3 %D line. This is the earliest momentum shift signal — it happens before a full signal fires. CROSS ▲ means 9-3 crossed above 14-3 (bullish momentum picking up). CROSS ▼ means 9-3 crossed below 14-3 (bearish momentum picking up).

Use it as: An early heads-up. If you're in ARMED and see CROSS ▲, the signal is likely accelerating toward BUY.

⚡ SURGE ▲ / ▼

Fires when all 4 %D lines are moving strongly in the same direction simultaneously. SURGE ▲ = all 4 lines surging upward together out of oversold — this is the engine firing. SURGE ▼ = all 4 lines pushing down together into overbought — heavy selling pressure across all timeframes of the stochastic.

Use it as: Momentum confirmation. BUY + SURGE ▲ is a much stronger signal than BUY alone. Expect a bigger and faster move.

◈ COIL (Xpt)

Fires when all 4 %D lines are compressed within 10 points of each other. Like a spring being compressed, the tighter the coil the more energy is stored. The number shown (e.g. COIL 6pt) tells you exactly how tight they are. A 3–4pt coil is extremely compressed.

Use it as: Breakout anticipation. When COIL fires right before or during ARMED, expect an explosive move when it unwinds. The tighter the coil the bigger the pop.

▲ / ▼ BIAS

Reads the 60-10 stochastic only — the slowest, most macro indicator. BULL BIAS = 60-10 is above 60. BEAR BIAS = 60-10 is below 40. NEUTRAL = between 40–60. This tells you which direction the bigger picture is leaning, regardless of the fast stochastics.

Use it as: A filter. BUY signals with BULL BIAS are trading with the macro trend. BUY signals with BEAR BIAS are countertrend — tighten your target and size down.

DEPTH Score

Scores how extreme the zone reading is, from 0 to 100. Calculated from the average of all 4 %D lines — the lower the average (deeper in oversold) or higher the average (deeper in overbought), the higher the DEPTH score. A score of 80+ means the stochastics are at historically extreme levels.

Use it as: A conviction multiplier. DEPTH 80+ BUY signals have historically produced the strongest and most reliable reversals. Under 40, treat the signal with more caution.

Combining Context

The real power comes when multiple context signals align at once. A BUY signal with SURGE ▲ + COIL + BULL BIAS + DEPTH 75 is a completely different trade from a bare BUY with no context. The more badges, the more conviction.

Rule of thumb: 3 or more context badges aligned with a BUY or SELL = treat it as a higher-conviction setup.

🌡️ STOCHASTIC HEAT MAP

The heat map shows the average of all 4 %D lines for each instrument × timeframe combination in a single color-coded grid. It's your quick at-a-glance view of where everything stands without reading every bar.

Color	Label	Average Value	What It Means
Green	OVERSOLD	0 – 20	All stochastics deep in oversold — BUY territory
Light Green	LOW	21 – 35	Stochastics are low but not extreme yet
White	MID	36 – 64	Neutral — no active setup
Orange	HIGH	65 – 79	Stochastics are elevated — approaching SELL territory
Red	OVERBOUGHT	80 – 100	All stochastics deep in overbought — SELL territory

Pro tip: Scan the heat map first thing each session. If you see a full column of green (one instrument oversold on all 3 timeframes), that's a major multi-timeframe BUY setup loading. A full column of red is a multi-timeframe SELL loading.

📈 INSTRUMENTS

Symbol	Full Name	Exchange	Session	Notes
ES	S&P 500 E-mini	CME	Nearly 24hr	Most liquid US equity futures. Benchmark instrument. Signals here often lead NQ and YM.
NQ	NASDAQ E-mini	CME	Nearly 24hr	Tech-heavy. Higher beta than ES — moves farther and faster. Confirms ES signals or shows divergence.
GC	Gold Futures	COMEX	Nearly 24hr	Non-correlated asset. Gold signals can reveal risk-off/risk-on sentiment diverging from equities.
BTC	BTC Futures	CME	Nearly 24hr	High volatility crypto futures. Often leads or lags equity signals. Good for cross-asset confirmation.
YM	Dow E-mini	CME	Nearly 24hr	Dow Jones futures. Less tech-heavy than NQ. Divergence between YM and NQ can signal sector rotation.

Timeframes

Timeframe	Best For	Signal Speed
1m	Scalp entries, fast reversals, immediate execution	Fastest — fires and expires quickly. Act within 1–3 minutes.
3m	Intraday swing entries, confirmed reversals	Medium — gives you 3–8 minutes to act. Better reward:risk than 1m.
5m	Higher conviction swings, trend change confirmation	Slowest of the three — most reliable, best used for position sizing up.

Multi-timeframe rule: When 1m, 3m, and 5m all show BUY on the same instrument at the same time, that's a high-conviction multi-timeframe alignment. These are your best setups of the session.

⚙️ INITIAL SETUP

Requirements

Windows PC with Node.js installed
TradingView account (Pro or higher for webhook alerts)
ngrok installed for the public webhook URL
Project folder at: C:\Users\jk-trader\Desktop\qr-dashboard\

Starting the Scanner

Double-click START_QR_SCANNER.bat on your Desktop. This opens two Command Prompt windows — one for the Node.js server, one for ngrok. Do not close either window while trading.

Updating ngrok URL

ngrok generates a new URL every time it starts. After starting:

1

Copy the ngrok URL

Look in the ngrok terminal window for the Forwarding URL — it looks like https://abc123.ngrok-free.app

2

Open the dashboard

Go to http://localhost:5173 in your browser

3

Update TradingView alerts

In TradingView, open each alert and update the webhook URL to the new ngrok URL + /webhook (e.g. https://abc123.ngrok-free.app/webhook)

Important: The ngrok URL changes every time you restart ngrok. If signals stop appearing on the dashboard, this is the first thing to check.

📡 TRADINGVIEW ALERTS

You need 30 alerts total — 5 instruments × 3 timeframes × 2 directions (BUY and SELL). Each alert sends a JSON payload to the webhook.

Alert Message Format

Each TradingView alert must have the webhook URL set and this JSON format in the message body:

// Example: ES 1m BUY alert message
{
  "symbol": "ES",
  "timeframe": "1m",
  "signal": "BUY",
  "d93": {{plot_0}},
  "d143": {{plot_1}},
  "d404": {{plot_2}},
  "d6010": {{plot_3}},
  "price": {{close}},
  "divType": "{{plot_4}}"
}
        

Alert Checklist

Instrument	1m BUY	1m SELL	3m BUY	3m SELL	5m BUY	5m SELL
ES	✓	☐	☐	☐	☐	☐
NQ	☐	☐	☐	☐	☐	☐
GC	☐	☐	☐	☐	☐	☐
BTC	☐	☐	☐	☐	☐	☐
YM	☐	☐	☐	☐	☐	☐

✓ = completed. ES 1m BUY was your first alert — 29 remaining.

🚀 MONDAY MORNING GO-LIVE WORKFLOW

1

Double-click START_QR_SCANNER.bat

Launches both the Node.js server (port 3001) and ngrok tunnel. Both Command Prompt windows must stay open.

2

Copy the new ngrok URL

Look in the ngrok terminal for the https Forwarding URL. Copy it — you need it in step 4.

3

Open localhost:5173 in Chrome

This is the live scanner dashboard. You should see all 5 instrument cards in WATCHING state.

4

Update TradingView alert webhooks

Go into TradingView and update all 30 alerts to use the new ngrok URL. Format: https://[ngrok-id].ngrok-free.app/webhook

5

Open your 5-chart TradingView layout

One chart per instrument (ES, NQ, GC, BTC, YM) with the QR Pine Script applied to each.

6

Add scanner to OBS

In OBS: Sources → + → Browser Source → URL: http://localhost:5173 → Width: your stream width → Height: your stream height → OK.

7

Test with a curl command (optional)

Paste this into Command Prompt to verify the webhook is working before market open:

curl -X POST https://[your-ngrok-url]/webhook -H "Content-Type: application/json" -d "{\"symbol\":\"ES\",\"timeframe\":\"1m\",\"signal\":\"BUY\",\"d93\":18,\"d143\":16,\"price\":5842}"

8

Go live

Market opens at 9:30am ET. Signals will begin appearing automatically as TradingView detects setups.

💡 TRADING TIPS

Highest Conviction Setups

Multi-timeframe alignment: same instrument shows BUY (or SELL) on 1m, 3m, and 5m simultaneously
DIV type is BOTH (9-3 and 14-3 both diverged) — two confirmations in one signal
DEPTH score 70+ — stochastics are at extreme levels historically associated with strong reversals
SURGE badge present alongside BUY or SELL — momentum engine fully engaged
BIAS aligns with signal direction — trading with the macro trend, not against it
COIL fired before or during ARMED — the spring is loaded for an explosive move
Multiple instruments firing in the same direction at the same time (e.g. ES + NQ + YM all BUY)

When to Be Cautious

BUY signal with BEAR BIAS — you're trading countertrend. Reduce size and take profits sooner.
Signal on 1m only with no alignment on 3m or 5m — lower conviction, faster to fade
Low DEPTH score (under 40) — stochastics weren't very extreme, reversal may be shallow
No context badges at all — bare signal with no confirmation context
Pre-market or low volume hours — signals can be erratic outside regular trading hours
Major economic releases (FOMC, CPI, NFP) — signals may fire and immediately reverse

Using the Heat Map

Scan the heat map at session open. A column of green or red across multiple timeframes tells you which instruments have the most loaded setups before a single alert fires. This is your pre-market intelligence.

Alert Feed

The right-side alert feed shows every signal chronologically with timestamps. Use it to spot patterns — if ES and NQ are both firing BUY signals within 30 seconds of each other, that's a strong inter-market confirmation. The market bias gauge at the bottom of the feed updates in real time and reflects the last 10 signals.

🔧 TROUBLESHOOTING

Problem	Most Likely Cause	Fix
Signals not appearing on dashboard	ngrok URL changed after restart	Copy new ngrok URL and update all TradingView alerts
Dashboard shows blank / white screen	Error in App.jsx code	Press F12 → Console tab — look for red errors and report them
Dashboard not updating	Vite dev server stopped	Open qr-dashboard folder in Command Prompt and run `npm run dev`
Server not receiving webhooks	Node.js server stopped	Re-run START_QR_SCANNER.bat or run `node server.js` in the qr-dashboard folder
OBS browser source blank	localhost:5173 not running	Make sure Vite is running, then refresh the Browser Source in OBS
Webhook returns 404	Wrong URL path	URL must end in `/webhook` — check your TradingView alert webhook field
All instruments show WATCHING	No alerts have fired yet	Normal before market open. Send a test curl command to verify the pipeline works.

Quick health check: If the scanner is running correctly, the green blinking dot in the top-left of the dashboard should be pulsing. If it's not blinking, refresh the page.