VCET v1.1 Chart Overlay - Usage Guide
What this overlay gives you
A chart-facing rendering of the VCET v1.1 + CBO framework so you can read rotation, compression, expansion, trend, pull-in failure, and pull-in → trend conversion in real time. It plots VWAP and bands at ±0.5/±1/±2/±4 SD, the Pardo CBO channel (prior 20 bars, current bar excluded), CBO break markers, the current VCET state, a post-entry management timer at +3/+10/+15/+25 minutes, and a risk-management dashboard table at the top-right of the chart.
This is a chart layer. It does not write to the database, does not change taxonomy, does not modify the Python engine, and does not refresh Scorecards. It exists alongside the existing canonical Pine alert indicator (vcet_indicator_v1_1.pine) - they share math but serve different purposes.
1. Installation in TradingView
- Open TradingView. Open the Pine editor (bottom panel → Pine Editor).
- New blank script → paste the contents of
vcet_indicator_v1_1_chart_overlay.pine (file at C:\Users\jtdom\Downloads\vcet_v1_1\pine\).
- Save and add to chart. Name it “VCET v1.1 Chart Overlay”.
- You should see VWAP, four band tiers, the CBO channel as aqua / fuchsia lines, and a dashboard table top-right.
- To get the management timer, toggle manual entry mode ON in indicator settings and set the entry timestamp. Optional: set trade direction (Long / Short / None).
2. What you see on the chart
2.1 VWAP and bands
VWAP (white, 2px)
RTH-anchored typical-price VWAP. Resets each new ET trading date. This is the anchor for everything else.
±0.5 SD bands (faint gray)
Inner Pull-In zone. Calm-tape entries live near these lines.
±1 SD bands (gray)
Outer Pull-In zone. Edge of "still calm" - beyond this you are usually in extension.
+2 SD band (green, 2px)
The Pull-In → Trend trigger zone. Close above this with confirmation is the "hold for trend" signal.
−2 SD band (red, 2px)
Backside / Rubberband zone. Reclaim from this level toward VWAP is the mean-reversion play.
±4 SD bands (faint green / red)
Extended-trend target / extreme backside. Rarely reached without trend.
2.2 CBO channel (the v1.1 addition)
CBO channel high (aqua line)
Highest high of the prior 20 bars (current bar EXCLUDED, per Pardo). Close above this = LONG CBO break.
CBO channel low (fuchsia line)
Lowest low of the prior 20 bars (current bar EXCLUDED). Close below this = SHORT CBO break.
CBO LONG marker (aqua triangle, below bar)
Bar closed above the prior 20-bar channel high. This is the v1.1 channel-breakout-confirmed signal.
CBO SHORT marker (fuchsia triangle, above bar)
Bar closed below the prior 20-bar channel low. v1.1 SHORT breakout signal.
2.3 State label (top-right, follows last bar)
A floating label at the right edge of the chart shows the current VCET state in real time. Color-coded:
| ROTATION | Flat bands, slope near zero, no breakout recent. Trade the band edges or pass. |
| COMPRESSION | Bands tight, price near VWAP, volatility contracting. Wait for break. |
| EARLY_EXPANSION | Just left compression; width starting to widen; not yet confirmed. Position carefully. |
| EXPANSION_CONFIRMED | v1.0 range break + expansion score above threshold. Direction tagged in label. |
| TREND_UP | Strong upward slope past threshold AND price above +1 SD. Hold for continuation. |
| TREND_DOWN | Strong downward slope AND price below −1 SD. Hold short / counter-trend long passes. |
| MEAN_REVERSION | Price extended ≥2.5 SD; first reversal bar present. Reclaim toward VWAP. |
2.4 Dashboard table (top-right of pane)
10-row table summarizing the current state and management context:
| Row | What it shows |
| VCET v1.1 | Current state + direction (color-coded by state) |
| Setup mode | WRONG-SIDE / TREND / ROTATION-PULL-IN / UNKNOWN |
| Pre-trade gate | GREEN / YELLOW / RED / UNKNOWN (derived from gap condition + instrument type) |
| Management | What to DO right now (scalp / hold candidate / reduce / exit / watch only) |
| Risk suggestion | Normal / reduced / pass / reduce-exit (derived from gate + post-entry conditions) |
| VWAP slope (bp/bar) | Numeric slope in basis-points-per-bar |
| Band width % | Numeric width + arrow (↑ expanding, ↓ contracting, = stable) |
| Dist from VWAP (SD) | Signed standard deviations from VWAP |
| CBO | LONG ↑ / SHORT ↓ with strength, or "inside channel" |
| Elapsed (min) | Minutes since manual entry, when manual entry is on |
3. How to read mechanism in real time
3.1 The mechanism signatures (encoded in the dashboard)
true_pull_in_to_trend (the conversion)
- Entry state: ROTATION or COMPRESSION near VWAP
- Within 5-15 min: width EXPANDS (arrow ↑)
- Slope ACCELERATES in trade direction past flat threshold
- CBO break fires in trade direction (aqua ↑ for LONG, fuchsia ↓ for SHORT)
- State transitions to EARLY_EXPANSION → EXPANSION_CONFIRMED → TREND_*
Management: trail wide, hold the core, do not auto-scratch at +1 SD. Target +2 SD close then hold for trend continuation.
vwap_rotation_scalp
- Entry state: ROTATION (often near VWAP)
- Width stays FLAT (arrow = stable)
- Slope stays near zero (slope cell < flat threshold)
- CBO never fires (channel cell shows "inside channel")
- State remains ROTATION at +15 / +25 min
Management: target the opposite band, take the rotation. Don't extend stops hoping for a breakout that isn't coming.
wrong_side_escape
- CBO fires OPPOSITE trade direction (fuchsia when you're LONG; aqua when you're SHORT)
- Slope accelerates AGAINST direction
- State transitions to TREND opposite trade direction within 5-15 min
- Dashboard "Setup mode" cell turns WRONG-SIDE red
Management: exit or reduce quickly. The outcome will be lucky scratch or ugly loss. Do NOT let P&L validate the setup.
trend_continuation_entry
- State at -5 / 0 (entry) was ALREADY TREND_UP / TREND_DOWN in trade direction
- CBO had ALREADY fired before entry (timer ran from a previous bar)
- No fresh compression precursor
- Slope sign matches direction, often decelerating
Management: different play than a Pull-In conversion. Manage as continuation - tighter stop, smaller R, accept lower hit rate.
range_break / hitchhiker
- State: COMPRESSION at entry-5
- CBO fires within +/-2 bars of entry
- Band width expands within 10 min
- State transitions to TREND_* matching break direction
Management: hitchhike the break. Trail behind structure. Tighter than Pull-In conversion because the breakout is concentrated, not extended.
rubberband / backside
- "Dist from VWAP (SD)" cell ≥ +/-2.5 AGAINST trade direction
- State: MEAN_REVERSION near entry
- Price reclaims toward VWAP within 25 min
- Slope at entry against direction but DECELERATING
Management: band-anchored stop at ±2 SD opposite, exit at VWAP, no trailing.
4. Post-entry management timer
When you flip on manual entry mode in the inputs and set manual entry timestamp, the overlay draws checkpoint labels on the chart at the specified offsets from entry. The dashboard "Elapsed (min)" cell ticks alongside.
| Checkpoint | What it checks | What the label says |
| +3 min |
FADE detection (close moved against direction past entry price) |
If fading: red label "3 min: FADE - reduce / exit" above bar · If holding: green label "3 min: no early failure" below bar |
| +10 min |
Expansion confirmation: width expanding AND slope in direction AND CBO in direction |
If yes: green label "10 min: trend conversion candidate" · If no: yellow label "10 min: manage as rotation scalp" |
| +15 min |
Same expansion confirmation re-evaluated |
If yes: green "15 min: confirmation HOLDS" · If no: yellow "15 min: no confirmation → rotation" |
| +25 min |
Final mechanism call: expansion confirmation AND state in {TREND_UP, TREND_DOWN, EXPANSION_CONFIRMED} |
If trend: green "25 min: TREND CONVERSION" · If not: yellow "25 min: NOT a trend; manage as rotation/exit" |
| anytime > 0 |
Wrong-side CBO fired (opposite trade direction) |
Red label "Wrong-side CBO - reduce / exit" above bar (can fire any bar after entry) |
5. The pre-trade gate (dashboard "Pre-trade gate" cell)
Encoded directly from the research conclusions. Drives the "Risk suggestion" cell:
| Gap condition | Instrument type | Gate | Risk suggestion |
| controlled | megacap-tech / energy-commodity / other-acceptable | GREEN | Normal planned risk |
| controlled | other (uncategorized) | YELLOW | Reduced risk only |
| extended | (any) | RED | Pass or reclassify |
| (any) | crypto-proxy-ETF / small-cap-high-beta | RED | Pass or reclassify - this is the leak-instrument class |
| unknown | (any) | UNKNOWN | Define gap + instrument first |
5.1 Why no RVOL gate?
Per the research conclusions, RVOL is secondary context, not the primary gate. Gap condition and instrument type predict outcomes more reliably than RVOL. The Quality Gate doc lists RVOL as a numeric reference, but the chart-overlay gate uses gap + instrument as the primary inputs. RVOL still appears in the chart math (used for v1.0 range break detection) but does not drive the dashboard's pre-trade-gate cell.
6. Inputs reference
| Group | Input | Default | Purpose |
| Display | Show VWAP bands | true | Toggles all band plots |
| Display | Show CBO channel | true | Toggles CBO channel lines + break markers |
| Display | Show state label | true | The floating state label at chart right edge |
| Display | Show management dashboard | true | The 10-row table |
| Display | Show management timer | true | The +3/+10/+15/+25 checkpoint labels |
| Trade context | Trade direction | None | Long / Short / None - used for fade detection + CBO direction match |
| Trade context | Manual entry mode | false | Enables the post-entry timer + fade tracking |
| Trade context | Manual entry timestamp | (set in UI) | The bar time of your entry (used as t=0) |
| Trade context | Gap condition | unknown | controlled / extended / unknown - feeds the pre-trade gate |
| Trade context | Instrument type | other | megacap-tech / crypto-proxy-ETF / small-cap-high-beta / energy-commodity / other |
| CBO | Enable CBO | true | Master CBO toggle (computation + display) |
| CBO | CBO channel lookback | 20 | Number of prior bars in the channel (current bar excluded) |
| CBO | CBO min break strength | 0.0 | Filter noise - raise to 0.05+ in choppy tape |
| CBO | Normalize strength by ATR | false | Else normalize by channel width |
| Engine | (all VCETConfig defaults) | various | Match Python VCETConfig v1.1 defaults - leave unchanged unless you know why |
7. Workflow recipes
7.1 Pre-trade scan (no manual entry yet)
- Open the chart. Leave manual entry mode = OFF.
- Set Gap condition based on the opening gap you read pre-market (controlled = within +/-0.5%, extended = past +1.5% or symbol-in-{IBIT, AMD, ETHU, RGTI}).
- Set Instrument type based on what you're trading.
- Watch the dashboard cells:
- Pre-trade gate = GREEN: you have permission to take a Pull-In
- Pre-trade gate = YELLOW: reduced size only, with a thesis stated
- Pre-trade gate = RED: do not click Pull-In
- Cross-reference with the current state label - ideally you want to be entering when state shows ROTATION or COMPRESSION (where mechanism conversion is possible).
7.2 After clicking entry
- Toggle manual entry mode = ON in indicator settings.
- Set Manual entry timestamp to your fill bar (TradingView lets you click a date/time field).
- Set Trade direction to Long or Short.
- Watch for the +3 minute label to fire:
- If "FADE - reduce / exit" appears, you're in trouble - reduce or scratch
- If "no early failure" appears, you're holding fine
- Watch for the +10 / +15 labels:
- "trend conversion candidate" / "confirmation HOLDS" - you can trail wide and hold
- "manage as rotation scalp" / "no confirmation" - target the band, take the rotation
- If WRONG-SIDE CBO fires any time after entry - reduce/exit immediately.
- At +25 minutes you get the final mechanism call. Use it to decide whether you're in a Pull-In conversion or not. If the engine says it isn't, accept that even if the trade is currently green - the slug is hypothesis, not confirmed.
8. Limitations and caveats
Read these before trusting the overlay's calls
- The CBO state machine is a slim version of the Python engine's. It produces the same NAMED state but uses a simpler priority order (no STICKY_DEFAULT carryover; no cooldown). For the 95% of bars where state is unambiguous, this matches. For edge cases (post-FAILED_EXPANSION_CONFIRMED cooldown, sticky reasons), the Python engine on bar-history is the authoritative source.
- Manual entry timestamp granularity is bar-aligned. If your fill is mid-bar, the timer fires from the bar boundary closest to your entry. This may shift the +3 / +10 checkpoints by up to one bar. On 5-min charts, that's +/-5 min. On 1-min charts, +/-1 min.
- Pre-trade gate uses gap + instrument only. If you have RVOL data and want to layer it in, look at the chart's RVOL value separately. The dashboard does not gate on RVOL because the research showed gap + instrument matter more.
vwap-pull-in -> trend is a working hypothesis, not a confirmed mechanism label. The overlay's "trend conversion candidate" call indicates the v1.1 engine sees the conversion signature, but full validation requires Stage B mechanism reclassification (currently BLOCKED on Liberator entitlement; see recovery plan).
- The dashboard table fires only at the last bar. During chart replay it updates per bar; during live, it updates each new bar.
- The Pine indicator was NOT compiled inside TradingView in this session. Syntax review was done manually (math operations, variable declarations, label / table lifecycle). If TradingView reports a compile error, send me the line number and I'll patch.
- RTH session detection uses ET date change. If your chart shows pre-market data, VWAP will reset at the ET midnight rollover (which is when the new date starts), NOT at 09:30 ET. For RTH-only behavior, use TradingView's session filter or set the chart to "Regular Trading Hours" via the chart settings.
9. How this overlay relates to the canonical alert indicator
| vcet_indicator_v1_1.pine (canonical) | vcet_indicator_v1_1_chart_overlay.pine (this file) |
| Purpose | Production webhook alerts + parity audit | Trader-facing chart visualization |
| Overlay mode | No (separate pane with histogram) | YES (price-overlay) |
| VWAP / SD bands | Computed, not plotted as separate bands | Plotted at ±0.5 / ±1 / ±2 / ±4 SD |
| State machine | Full v1.0 + v1.1 with all reason codes | Slim: state names only, simplified priority |
| CBO computation | Yes, full Python parity | Yes (same math, current-bar exclusion) |
| CBO channel rendering | No | YES (aqua / fuchsia channel lines) |
| Webhook JSON payload | YES (state transitions emit) | NO (chart-side alertcondition only) |
| Dashboard table | Debug table only | Risk-management dashboard |
| Manual entry timer | No | YES (+3 / +10 / +15 / +25) |
| Database writes | None (webhook to alerts_tradingview) | None |
Run both on the same chart if you want webhooks AND visual rendering. They share math; they will agree on state.
10. Next steps to add it to your workflow
- Add it to TradingView: Pine Editor → paste → Save → Add to chart.
- Verify it compiles. If TradingView shows a compile error, capture the line number and message; the error will point to a syntax issue I can patch.
- Sanity check the bands: on a chart you know (NVDA, AAPL, SPY), confirm VWAP is at the right level, +2 SD plots green above, −2 SD plots red below. If the bands look wildly off, the session anchoring may not match your chart's session settings.
- Confirm CBO channel is plotted correctly: the aqua line should be the highest high of the prior 20 bars (NOT including the current bar). A new session high BAR should not be ON the aqua line - it should be ABOVE it (which is the CBO LONG break condition).
- Pin the dashboard: move the table to a position that doesn't cover price action.
- Set up alerts: right-click on the indicator name in the chart legend → Add Alert. Choose from "CBO break LONG", "CBO break SHORT", "10-15 min: trend conversion candidate", "Wrong-side CBO", etc.
- For each trade tomorrow: follow the §7.1 / §7.2 workflow.
- Track outcomes: note whether the +25 mechanism call agrees with the eventual trade outcome. After 10-15 trades, you'll have a feel for how reliable the visual mechanism call is. That sample becomes useful input for whatever the eventual Stage B reclassification looks like.
11. What this build did NOT do
- ❌ No database writes
- ❌ No classifier code changes
- ❌ No taxonomy changes
- ❌ No Scorecards refresh
- ❌ No Stage B reclassification
- ❌ No live Pine compilation (done manually by syntax review only; user must verify in TradingView)
- ❌ Does NOT overwrite
vcet_indicator_v1_1.pine (this file is a new sibling)
- ✅ One new Pine file at
C:\Users\jtdom\Downloads\vcet_v1_1\pine\vcet_indicator_v1_1_chart_overlay.pine
- ✅ One usage guide at
Z:\public_html\system\VCET_V1_1_CHART_OVERLAY_USAGE_GUIDE.html
Links