OPEN-SOURCE SCRIPT
Helios v3 Live Regime Signal Tool

Helios v3 — User Guide
Introduction
Helios v3 is a daily-timeframe market regime classifier and signal tool for TradingView. It tells you three things at a glance: what regime an asset is in (five states from Strong Bull to Strong Bear), whether a systematic entry or exit signal has fired, and — just as importantly — when a signal has been deliberately blocked because conditions make it a bad trade.
The core is a four-component trend score: MACD posture, the spread between the close-average and open-average, raw momentum, and position relative to a long moving average. Each component votes +1, 0, or −1, producing a score from −4 to +4 that maps to the regime. On top of that core, v3 adds two confirmation components the original lacked — volume participation (OBV trend) and relative strength against Bitcoin — and two protective gates: a realised-volatility cap that suppresses signals in conditions where trend-following historically fails, and an extension gate that refuses to buy parabolas or sell capitulation lows.
The philosophy: the regime tells you what the market is doing; the signals tell you when the system would act; the gates tell you when acting would be chasing. Transitions matter more than states — a slip from Strong Bull to Moderate Bull is information before any signal fires.
This is a decision-support tool, not financial advice. It describes price behavior; position sizing, risk, and the final call remain yours.
Installation
Open TradingView and load any chart, then set the timeframe to Daily (the tool is designed and calibrated for daily bars; volatility math assumes them).
Open the Pine Editor (bottom panel).
Delete any placeholder code, paste the entire contents of chameleon_v3_live.pine, and click Save (name it anything).
Click Add to chart. You should see colored bars, a regime label top-right, and the dashboard bottom-left.
To create alerts: click the three dots on the indicator name → Add alert, then pick a condition from the dropdown (see Alerts section below).
Choosing the right settings
Step 1 — Pick the volatility profile
Open the indicator settings and set Volatility Profile. This single dropdown switches all core parameters (MACD lengths, SMA, momentum lookback, confirmation days) and the volatility cap together:
Profile
90D Vol range
Vol cap
Typical assets
LV
under 50%
60%
S&P 500, Nasdaq, blue-chip stocks, major indices, BTC in calm regimes
MV
50–70%
80%
BTC and ETH in normal conditions, large-cap growth stocks
HV
71–90%
100%
Mid-cap cryptos (SOL-tier), volatile tech stocks, leveraged ETFs
SHV
over 90%
130%
Small-cap cryptos, meme coins, new listings, stocks in parabolic phases
You don't need to guess: the dashboard's 90D Vol row shows the asset's current volatility and prints ✓ Suitable or ✗ Use [profile] telling you which profile to switch to. Check it whenever you load a new asset, and re-check holdings every few weeks — volatility regimes drift, and an asset that was MV six months ago may be HV now.
Rule of thumb by asset class: indices and megacap equities → LV. Bitcoin and Ethereum → start with MV, follow the dashboard. Altcoins → HV or SHV, follow the dashboard. Anything freshly listed or in a mania phase → SHV.
Step 2 — Set the relative-strength benchmark (alts and stocks)
The RS benchmark input defaults to BINANCE:BTCUSDT, which is correct for altcoins: it asks "is this coin actually outperforming Bitcoin, or just riding its beta?" On a Bitcoin chart the component switches itself off automatically and the score range adapts.
For equities, change the benchmark to something meaningful — SP:SPX or NASDAQ:NDX — so the component measures strength against the relevant index instead of against Bitcoin. If you'd rather not use relative strength at all, untick Use Relative Strength vs benchmark.
Step 3 — Leave the gates alone (at first)
The defaults — buys blocked above z = 2.5, sells blocked below z = −2.5, auto vol cap on — are sensible starting values. Run the tool for a few weeks before adjusting anything. If you later find the vol gate too strict on a specific asset, untick Auto vol cap by profile and set a manual cap; that is the intended escape hatch, but use it knowingly — the gate exists because trend signals taken in extreme volatility have historically been the worst ones.
Reading the chart day to day
Bar colors = live regime. Bright green (Strong Bull, score +3 to +4), light green (Moderate Bull, +1 to +2), yellow (Neutral, 0), light red (Moderate Bear, −1 to −2), bright red (Strong Bear, −3 to −4). The top-right box states the regime in words.
Watch transitions, not states. Promotion into bright green is a confirmed breakout. Bright green fading to light green means the trend is losing a component — open the dashboard and see which one. Yellow rolling to light red to bright red is a regime change in progress. Climbing out of bright red suggests bear exhaustion and a possible base.
The dashboard is the diagnosis panel. It shows each component's current vote (MACD / Spread / Momentum / SMA, then Volume and Relative Strength), the total score against its maximum, the confirmation streak progress, the extension z-score, the vol gate status, your position state, and what size a signal would carry if it fired right now. The most useful daily habit: when a regime weakens, check whether volume (OBV) confirmed the move or diverged from it. Price-up with OBV voting −1 is a hollow rally; price flat with OBV voting +1 is quiet accumulation.
Triangles are signals:
Solid green triangle "FULL" — buy signal at full conviction: score at least +5 and price not extended (z below 1.5).
Lighter green triangle "HALF" — valid buy, but either the score is at the minimum threshold or price is somewhat extended. The system suggests half size.
Solid red triangle "SELL" — exit signal: score collapsed to −4 or worse for the required confirmation days.
Grey hollow triangle "BLK" — a blocked signal. Score and streak fully qualified, but a gate refused it: either realised vol is above the cap, or price is too extended (buys above z 2.5, sells below z −2.5). Blocked buys are worth tracking — when the same setup later fires at lower extension, it is typically the highest-quality entry the system produces.
Signal mechanics, for reference: a buy requires the extended score (core four components plus volume plus relative strength) to hold at +4 or better for the confirmation period — 2 consecutive days on LV/MV, 3 on HV/SHV — with the vol gate open and extension acceptable. Sells mirror this at −4. The system tracks one position state (long or flat) and will not repeat signals while in a position.
Alerts
Five alert conditions are available from the alert dialog:
BUY (full size) — highest-conviction entries.
BUY (half size) — valid but qualified entries.
SELL — confirmed regime breakdown exit.
Signal blocked — conditions met but gated; useful as a "watch this asset" ping.
Regime change — fires on any of the five-state transitions; the best low-noise alert for assets you hold but aren't actively trading.
A practical configuration: regime-change alerts on every core holding, plus buy/sell alerts on the handful of assets you'd actually trade systematically.
Honest limitations
The tool is a trend follower; it will always be late at exact tops and bottoms by design, and it loses money in choppy sideways ranges through whipsaw — the confirmation days and gates reduce this but cannot eliminate it. The volatility cap means some assets in extreme conditions produce no signals at all; that silence is itself the message. Backtested statistics on systems like this rest on a small number of historical trades, so treat any past-performance figure as descriptive, not predictive. And no indicator knows about news, unlocks, earnings, or liquidity events — the regime score is an input to judgment, not a replacement for it.
Introduction
Helios v3 is a daily-timeframe market regime classifier and signal tool for TradingView. It tells you three things at a glance: what regime an asset is in (five states from Strong Bull to Strong Bear), whether a systematic entry or exit signal has fired, and — just as importantly — when a signal has been deliberately blocked because conditions make it a bad trade.
The core is a four-component trend score: MACD posture, the spread between the close-average and open-average, raw momentum, and position relative to a long moving average. Each component votes +1, 0, or −1, producing a score from −4 to +4 that maps to the regime. On top of that core, v3 adds two confirmation components the original lacked — volume participation (OBV trend) and relative strength against Bitcoin — and two protective gates: a realised-volatility cap that suppresses signals in conditions where trend-following historically fails, and an extension gate that refuses to buy parabolas or sell capitulation lows.
The philosophy: the regime tells you what the market is doing; the signals tell you when the system would act; the gates tell you when acting would be chasing. Transitions matter more than states — a slip from Strong Bull to Moderate Bull is information before any signal fires.
This is a decision-support tool, not financial advice. It describes price behavior; position sizing, risk, and the final call remain yours.
Installation
Open TradingView and load any chart, then set the timeframe to Daily (the tool is designed and calibrated for daily bars; volatility math assumes them).
Open the Pine Editor (bottom panel).
Delete any placeholder code, paste the entire contents of chameleon_v3_live.pine, and click Save (name it anything).
Click Add to chart. You should see colored bars, a regime label top-right, and the dashboard bottom-left.
To create alerts: click the three dots on the indicator name → Add alert, then pick a condition from the dropdown (see Alerts section below).
Choosing the right settings
Step 1 — Pick the volatility profile
Open the indicator settings and set Volatility Profile. This single dropdown switches all core parameters (MACD lengths, SMA, momentum lookback, confirmation days) and the volatility cap together:
Profile
90D Vol range
Vol cap
Typical assets
LV
under 50%
60%
S&P 500, Nasdaq, blue-chip stocks, major indices, BTC in calm regimes
MV
50–70%
80%
BTC and ETH in normal conditions, large-cap growth stocks
HV
71–90%
100%
Mid-cap cryptos (SOL-tier), volatile tech stocks, leveraged ETFs
SHV
over 90%
130%
Small-cap cryptos, meme coins, new listings, stocks in parabolic phases
You don't need to guess: the dashboard's 90D Vol row shows the asset's current volatility and prints ✓ Suitable or ✗ Use [profile] telling you which profile to switch to. Check it whenever you load a new asset, and re-check holdings every few weeks — volatility regimes drift, and an asset that was MV six months ago may be HV now.
Rule of thumb by asset class: indices and megacap equities → LV. Bitcoin and Ethereum → start with MV, follow the dashboard. Altcoins → HV or SHV, follow the dashboard. Anything freshly listed or in a mania phase → SHV.
Step 2 — Set the relative-strength benchmark (alts and stocks)
The RS benchmark input defaults to BINANCE:BTCUSDT, which is correct for altcoins: it asks "is this coin actually outperforming Bitcoin, or just riding its beta?" On a Bitcoin chart the component switches itself off automatically and the score range adapts.
For equities, change the benchmark to something meaningful — SP:SPX or NASDAQ:NDX — so the component measures strength against the relevant index instead of against Bitcoin. If you'd rather not use relative strength at all, untick Use Relative Strength vs benchmark.
Step 3 — Leave the gates alone (at first)
The defaults — buys blocked above z = 2.5, sells blocked below z = −2.5, auto vol cap on — are sensible starting values. Run the tool for a few weeks before adjusting anything. If you later find the vol gate too strict on a specific asset, untick Auto vol cap by profile and set a manual cap; that is the intended escape hatch, but use it knowingly — the gate exists because trend signals taken in extreme volatility have historically been the worst ones.
Reading the chart day to day
Bar colors = live regime. Bright green (Strong Bull, score +3 to +4), light green (Moderate Bull, +1 to +2), yellow (Neutral, 0), light red (Moderate Bear, −1 to −2), bright red (Strong Bear, −3 to −4). The top-right box states the regime in words.
Watch transitions, not states. Promotion into bright green is a confirmed breakout. Bright green fading to light green means the trend is losing a component — open the dashboard and see which one. Yellow rolling to light red to bright red is a regime change in progress. Climbing out of bright red suggests bear exhaustion and a possible base.
The dashboard is the diagnosis panel. It shows each component's current vote (MACD / Spread / Momentum / SMA, then Volume and Relative Strength), the total score against its maximum, the confirmation streak progress, the extension z-score, the vol gate status, your position state, and what size a signal would carry if it fired right now. The most useful daily habit: when a regime weakens, check whether volume (OBV) confirmed the move or diverged from it. Price-up with OBV voting −1 is a hollow rally; price flat with OBV voting +1 is quiet accumulation.
Triangles are signals:
Solid green triangle "FULL" — buy signal at full conviction: score at least +5 and price not extended (z below 1.5).
Lighter green triangle "HALF" — valid buy, but either the score is at the minimum threshold or price is somewhat extended. The system suggests half size.
Solid red triangle "SELL" — exit signal: score collapsed to −4 or worse for the required confirmation days.
Grey hollow triangle "BLK" — a blocked signal. Score and streak fully qualified, but a gate refused it: either realised vol is above the cap, or price is too extended (buys above z 2.5, sells below z −2.5). Blocked buys are worth tracking — when the same setup later fires at lower extension, it is typically the highest-quality entry the system produces.
Signal mechanics, for reference: a buy requires the extended score (core four components plus volume plus relative strength) to hold at +4 or better for the confirmation period — 2 consecutive days on LV/MV, 3 on HV/SHV — with the vol gate open and extension acceptable. Sells mirror this at −4. The system tracks one position state (long or flat) and will not repeat signals while in a position.
Alerts
Five alert conditions are available from the alert dialog:
BUY (full size) — highest-conviction entries.
BUY (half size) — valid but qualified entries.
SELL — confirmed regime breakdown exit.
Signal blocked — conditions met but gated; useful as a "watch this asset" ping.
Regime change — fires on any of the five-state transitions; the best low-noise alert for assets you hold but aren't actively trading.
A practical configuration: regime-change alerts on every core holding, plus buy/sell alerts on the handful of assets you'd actually trade systematically.
Honest limitations
The tool is a trend follower; it will always be late at exact tops and bottoms by design, and it loses money in choppy sideways ranges through whipsaw — the confirmation days and gates reduce this but cannot eliminate it. The volatility cap means some assets in extreme conditions produce no signals at all; that silence is itself the message. Backtested statistics on systems like this rest on a small number of historical trades, so treat any past-performance figure as descriptive, not predictive. And no indicator knows about news, unlocks, earnings, or liquidity events — the regime score is an input to judgment, not a replacement for it.
Скрипт с открытым кодом
В истинном духе TradingView, создатель этого скрипта сделал его открытым исходным кодом, чтобы трейдеры могли проверить и убедиться в его функциональности. Браво автору! Вы можете использовать его бесплатно, но помните, что перепубликация кода подчиняется нашим Правилам поведения.
Отказ от ответственности
Информация и публикации не предназначены для предоставления и не являются финансовыми, инвестиционными, торговыми или другими видами советов или рекомендаций, предоставленных или одобренных TradingView. Подробнее читайте в Условиях использования.
Скрипт с открытым кодом
В истинном духе TradingView, создатель этого скрипта сделал его открытым исходным кодом, чтобы трейдеры могли проверить и убедиться в его функциональности. Браво автору! Вы можете использовать его бесплатно, но помните, что перепубликация кода подчиняется нашим Правилам поведения.
Отказ от ответственности
Информация и публикации не предназначены для предоставления и не являются финансовыми, инвестиционными, торговыми или другими видами советов или рекомендаций, предоставленных или одобренных TradingView. Подробнее читайте в Условиях использования.