Perfected FlowScript
Enhanced RSI
Enhanced RSI — Perfected Edition is indexed as 029_enhanced_rsi.flowscript. The exact FlowScript is viewable here; chart observe and trading automation use the current mmflow chart/recipe signal proxy until FlowScript v2 transpilation is available.
This exact FlowScript uses the v2 source dialect. It is viewable and connected to the chart/automation proxy, but direct editor execution needs the FlowScript v2 transpiler.
Dialect
flowscript-v2
Compatibility
flowscript-v2-needs-transpile
Position
offchart
Axis
true
Size
18.2 KB
Lines
617
Native Signal Candidates
10 source-level chart marker triggers extracted from guarded FlowScript v2 blocks.
Bull Div
line 482:9
Trigger
(showAlerts && enableDiv) && (bullDiv)
Value
rsiSeries
Deps
bullDiv:var, enableDiv:input, showAlerts:input
Bear Div
line 492:9
Trigger
(showAlerts && enableDiv) && (bearDiv)
Value
rsiSeries
Deps
bearDiv:var, enableDiv:input, showAlerts:input
Hidden Bull
line 502:9
Trigger
(showAlerts && enableDiv) && (showHidden && hiddenBullDiv)
Value
rsiSeries
Deps
enableDiv:input, hiddenBullDiv:var, showAlerts:input, showHidden:input
Hidden Bear
line 512:9
Trigger
(showAlerts && enableDiv) && (showHidden && hiddenBearDiv)
Value
rsiSeries
Deps
enableDiv:input, hiddenBearDiv:var, showAlerts:input, showHidden:input
Cross Up
line 526:9
Trigger
(showAlerts) && (crossUp)
Value
rsiMa
Deps
crossUp:var, showAlerts:input
Cross Down
line 536:9
Trigger
(showAlerts) && (crossDown)
Value
rsiMa
Deps
crossDown:var, showAlerts:input
OB Penetrate
line 546:9
Trigger
(showAlerts) && (obPenetrate)
Value
dynOb
Deps
obPenetrate:var, showAlerts:input
OS Penetrate
line 556:9
Trigger
(showAlerts) && (osPenetrate)
Value
dynOs
Deps
osPenetrate:var, showAlerts:input
Extreme OB
line 566:9
Trigger
(showAlerts) && (extremeOb)
Value
80
Deps
extremeOb:var, showAlerts:input
Extreme OS
line 576:9
Trigger
(showAlerts) && (extremeOs)
Value
20
Deps
extremeOs:var, showAlerts:input
029_enhanced_rsi.flowscript
source path: kscripts/perfected/029_enhanced_rsi.flowscript · sha256:0757f113d488d25d75344e0cad9058185d42ce0795037526490de8af773f266c
//@version=2
// ============================================================================
// Enhanced RSI — Perfected Edition
// Author: BackQuant (@BackQuant) | Enhanced by kScript Perfection Engineer
// Tags: CORE, #rsi, #meanreversion, #trend, #momentum, #divergence
//
// Production-quality academically-grounded RSI momentum oscillator with
// full stateful divergence detection, dynamic volatility-adjusted thresholds,
// multi-regime color coding, RSI-to-MA fill visualization, and comprehensive
// shape alerts for zone penetrations and extremes.
//
// Research papers underpinning this design:
// 1. Wilder (1978), "New Concepts in Technical Trading Systems": canonical
// RSI publication. RSI = 100 − [100 / (1 + RS)] where RS = SMA(gain, N) /
// SMA(loss, N). Original smoothing period = 14. The canonical formula is
// implemented here with optional Wilder EMA smoothing of gains/losses.
// 2. Ponnusamy & Manual (2016), "A Study on Financial Indicators' Reliability":
// experimental testing found RSI outperforms MACD and Stochastic in signal
// reliability; multi-indicator confirmation recommended. Supports the
// RSI-with-MA-enhancement architecture for smoother signals.
// 3. Poterba & Summers (1988), "Mean Reversion in Stock Prices: Evidence and
// Implications": negative autocorrelation at medium horizons; supports
// dynamic overbought/oversold thresholds calibrated to rolling volatility.
// 4. Murphy (1999), "Technical Analysis of the Financial Markets": divergence
// as a leading reversal signal — price/indicator disagreement at extremes
// precedes regime shifts. Underpins the regular and hidden divergence engine.
// 5. Jegadeesh & Titman (1993), "Returns to Buying Winners and Selling
// Losers" (J. Finance): established momentum as a premier cross-sectional
// anomaly. Validates RSI's momentum-measurement role and the mean-reversion
// interpretation of RSI extremes as exhaustion signals.
// ============================================================================
define(
title="Enhanced RSI — Perfected Edition",
position="offchart",
axis=true
)
// -----------------------------------------------------------------------------
// 1. USER INPUTS — grouped with constraints
// -----------------------------------------------------------------------------
// --- RSI Settings ---
var rsiLen = input(
name="rsiLen",
type="number",
defaultValue=14,
label="RSI Length",
constraints={min: 2, max: 50, step: 1},
group="RSI Settings"
)
var useWilder = input(
name="useWilder",
type="boolean",
defaultValue=true,
label="Use Wilder Smoothing (EMA of gains/losses)",
group="RSI Settings"
)
// --- Smoothing ---
var maType = input(
name="maType",
type="select",
defaultValue="EMA",
label="MA Type",
options=["EMA", "SMA"],
group="Smoothing"
)
var maLen = input(
name="maLen",
type="number",
defaultValue=14,
label="MA Length",
constraints={min: 2, max: 50, step: 1},
group="Smoothing"
)
var rsiSmooth = input(
name="rsiSmooth",
type="number",
defaultValue=1,
label="RSI Smoothing Length",
constraints={min: 1, max: 20, step: 1},
group="Smoothing"
)
// --- Thresholds ---
var obLevel = input(
name="obLevel",
type="number",
defaultValue=70,
label="Static Overbought Level",
constraints={min: 50, max: 95, step: 1},
group="Thresholds"
)
var osLevel = input(
name="osLevel",
type="number",
defaultValue=30,
label="Static Oversold Level",
constraints={min: 5, max: 50, step: 1},
group="Thresholds"
)
var useDynamic = input(
name="useDynamic",
type="boolean",
defaultValue=false,
label="Dynamic Thresholds (volatility-adjusted)",
group="Thresholds"
)
var volLookback = input(
name="volLookback",
type="number",
defaultValue=20,
label="Volatility Lookback",
constraints={min: 5, max: 100, step: 1},
group="Thresholds"
)
var volMultiplier = input(
name="volMultiplier",
type="number",
defaultValue=1.5,
label="Volatility Multiplier",
constraints={min: 0.5, max: 5.0, step: 0.1},
group="Thresholds"
)
var bandPad = input(
name="bandPad",
type="number",
defaultValue=5,
label="OB/OS Band Padding",
constraints={min: 0, max: 20, step: 1},
group="Thresholds"
)
// --- Divergence ---
var enableDiv = input(
name="enableDiv",
type="boolean",
defaultValue=true,
label="Enable Divergence Detection",
group="Divergence"
)
var divLookback = input(
name="divLookback",
type="number",
defaultValue=10,
label="Divergence Lookback (pivot bars)",
constraints={min: 5, max: 50, step: 1},
group="Divergence"
)
var showHidden = input(
name="showHidden",
type="boolean",
defaultValue=true,
label="Show Hidden Divergence",
group="Divergence"
)
// --- Display ---
var showRsi = input(
name="showRsi",
type="boolean",
defaultValue=true,
label="Show RSI Line",
group="Display"
)
var showMa = input(
name="showMa",
type="boolean",
defaultValue=true,
label="Show MA Line",
group="Display"
)
var showRibbon = input(
name="showRibbon",
type="boolean",
defaultValue=true,
label="Show RSI-to-MA Ribbon Fill",
group="Display"
)
var showZones = input(
name="showZones",
type="boolean",
defaultValue=true,
label="Show OB/OS Zones",
group="Display"
)
var showHistogram = input(
name="showHistogram",
type="boolean",
defaultValue=true,
label="Show Momentum Histogram",
group="Display"
)
var showAlerts = input(
name="showAlerts",
type="boolean",
defaultValue=true,
label="Show Alert Shapes",
group="Display"
)
// --- Colors ---
var bullColor = input(
name="bullColor",
type="color",
defaultValue="#26a69a",
label="Bull Color",
group="Colors"
)
var bearColor = input(
name="bearColor",
type="color",
defaultValue="#ef5350",
label="Bear Color",
group="Colors"
)
var rsiColor = input(
name="rsiColor",
type="color",
defaultValue="#2962ff",
label="RSI Line Color",
group="Colors"
)
var maColor = input(
name="maColor",
type="color",
defaultValue="#ff6d00",
label="MA Line Color",
group="Colors"
)
var divBullColor = input(
name="divBullColor",
type="color",
defaultValue="#00e676",
label="Bullish Divergence Color",
group="Colors"
)
var divBearColor = input(
name="divBearColor",
type="color",
defaultValue="#ff5252",
label="Bearish Divergence Color",
group="Colors"
)
// -----------------------------------------------------------------------------
// 2. DATA SOURCES & NaN GUARD
// -----------------------------------------------------------------------------
timeseries bars = ohlcv(symbol=currentSymbol, exchange=currentExchange)
timeseries px = bars.close
timeseries hi = bars.high
timeseries lo = bars.low
if (isnan(px[0]) || isnan(hi[0]) || isnan(lo[0])) {
return
}
// -----------------------------------------------------------------------------
// 3. WILDER RSI — canonical implementation
// -----------------------------------------------------------------------------
// RSI = 100 − [100 / (1 + RS)] where RS = Average Gain / Average Loss
// Per Wilder (1978), the original uses smoothed moving averages of gains/losses.
timeseries change = px[0] - px[1]
timeseries gain = change > 0 ? change : 0
timeseries loss = change < 0 ? -change : 0
// Average gain/loss using Wilder smoothing (EMA with alpha = 1/N)
// or standard SMA per user toggle
timeseries avgGain = useWilder ? ema(gain, rsiLen) : sma(gain, rsiLen)
timeseries avgLoss = useWilder ? ema(loss, rsiLen) : sma(loss, rsiLen)
// Guard against division by zero
timeseries rs = avgLoss > 0 ? avgGain / avgLoss : 0
timeseries rsiRaw = 100 - (100 / (1 + rs))
// Optional RSI smoothing
timeseries rsiSeries = rsiSmooth > 1 ? ema(rsiRaw, rsiSmooth) : rsiRaw
// -----------------------------------------------------------------------------
// 4. MA SMOOTHING
// -----------------------------------------------------------------------------
timeseries rsiMa = maType == "EMA" ? ema(rsiSeries, maLen) : sma(rsiSeries, maLen)
// Momentum histogram (RSI minus MA)
timeseries hist = rsiSeries - rsiMa
// -----------------------------------------------------------------------------
// 5. REGIME DETECTION
// -----------------------------------------------------------------------------
// Regime classification:
// Bullish: RSI > MA AND RSI > 50
// Bearish: RSI < MA AND RSI < 50
// Neutral: everything else (chop zone)
var regimeBull = rsiSeries > rsiMa && rsiSeries > 50
var regimeBear = rsiSeries < rsiMa && rsiSeries < 50
var regimeNeutral = !regimeBull && !regimeBear
var regimeColor = regimeBull ? bullColor : (regimeBear ? bearColor : "#9e9e9e")
// -----------------------------------------------------------------------------
// 6. DYNAMIC THRESHOLDS
// -----------------------------------------------------------------------------
// Per Poterba & Summers (1988), mean-reversion intensity varies with volatility.
// We adjust OB/OS bands by rolling RSI standard deviation.
var rsiVol = stddev(rsiSeries, volLookback)
var dynOb = useDynamic ? math.min(95, obLevel + rsiVol * volMultiplier) : obLevel
var dynOs = useDynamic ? math.max(5, osLevel - rsiVol * volMultiplier) : osLevel
// Guard: ensure dynamic bands never cross
if (dynOb <= dynOs) {
dynOb = 70
dynOs = 30
}
// -----------------------------------------------------------------------------
// 7. DIVERGENCE DETECTION (stateful via static variables)
// -----------------------------------------------------------------------------
// Regular divergence: price makes higher high / lower low, RSI disagrees.
// Hidden divergence: price makes higher low / lower high, RSI disagrees.
// We track pivot high/low state across bars using static variables.
static prevPxHigh = -1.0
static prevRsiHigh = -1.0
static prevPxLow = -1.0
static prevRsiLow = -1.0
static prevPxHighLow = -1.0
static prevRsiHighLow = -1.0
static prevPxLowHigh = -1.0
static prevRsiLowHigh = -1.0
var bearDiv = false
var bullDiv = false
var hiddenBearDiv = false
var hiddenBullDiv = false
// Initialize on first real bar after NaN guard
if (prevPxHigh < 0) {
prevPxHigh = hi[0]
prevRsiHigh = rsiSeries[0]
prevPxLow = lo[0]
prevRsiLow = rsiSeries[0]
prevPxHighLow = hi[0]
prevRsiHighLow = rsiSeries[0]
prevPxLowHigh = lo[0]
prevRsiLowHigh = rsiSeries[0]
}
if (!isLiveUpdate && enableDiv) {
// --- Regular Bearish Divergence ---
// Price makes a higher high; RSI makes a lower high
var pxHigh = highest(hi, divLookback)
var rsiHigh = highest(rsiSeries, divLookback)
if (hi[0] > prevPxHigh) {
if (rsiSeries[0] < prevRsiHigh) {
bearDiv = true
}
prevPxHigh = hi[0]
prevRsiHigh = rsiSeries[0]
}
// --- Regular Bullish Divergence ---
// Price makes a lower low; RSI makes a higher low
var pxLow = lowest(lo, divLookback)
var rsiLow = lowest(rsiSeries, divLookback)
if (lo[0] < prevPxLow) {
if (rsiSeries[0] > prevRsiLow) {
bullDiv = true
}
prevPxLow = lo[0]
prevRsiLow = rsiSeries[0]
}
// --- Hidden Divergence ---
// Hidden bullish: price higher low, RSI lower low
// Hidden bearish: price lower high, RSI higher high
if (showHidden) {
// Hidden bullish: price makes a higher low vs prior low
if (lo[0] > prevPxLow && hi[0] < prevPxHigh) {
if (rsiSeries[0] < prevRsiLow) {
hiddenBullDiv = true
}
}
// Hidden bearish: price makes a lower high vs prior high
if (hi[0] < prevPxHigh && lo[0] > prevPxLow) {
if (rsiSeries[0] > prevRsiHigh) {
hiddenBearDiv = true
}
}
}
}
// -----------------------------------------------------------------------------
// 8. ALERT CONDITIONS
// -----------------------------------------------------------------------------
// Crossover / crossunder of RSI and MA
var crossUp = rsiSeries > rsiMa && rsiSeries[1] <= rsiMa[1]
var crossDown = rsiSeries < rsiMa && rsiSeries[1] >= rsiMa[1]
// OB / OS penetrations (using dynamic or static thresholds)
var obPenetrate = rsiSeries > dynOb && rsiSeries[1] <= dynOb
var osPenetrate = rsiSeries < dynOs && rsiSeries[1] >= dynOs
// OB / OS exit (return to neutral zone)
var obExit = rsiSeries < dynOb && rsiSeries[1] >= dynOb
var osExit = rsiSeries > dynOs && rsiSeries[1] <= dynOs
// Zone extremes (> 80 / < 20)
var extremeOb = rsiSeries > 80 && rsiSeries[1] <= 80
var extremeOs = rsiSeries < 20 && rsiSeries[1] >= 20
// -----------------------------------------------------------------------------
// 9. PLOTTING
// -----------------------------------------------------------------------------
// --- Midline ---
hline(value=50, color="#ffffff20", width=1)
// --- OB / OS Zones ---
if (showZones) {
hline(value=dynOb, color=transparency(bearColor, 60), width=1)
hline(value=dynOb + bandPad, color=transparency(bearColor, 30), width=1)
hline(value=dynOs, color=transparency(bullColor, 60), width=1)
hline(value=dynOs - bandPad, color=transparency(bullColor, 30), width=1)
}
// --- RSI-to-MA Ribbon Fill ---
if (showRibbon) {
var ribbonBull = rsiSeries > rsiMa
plotLine(
value=[rsiSeries, rsiMa],
width=1,
colors=[transparency(bullColor, 30), transparency(bearColor, 30)],
colorIndex=ribbonBull ? 0 : 1,
fill=true,
label=["RSI", "RSI MA"],
desc=["RSI line ribbon edge", "RSI MA ribbon edge"]
)
}
// --- RSI Line (regime-colored) ---
if (showRsi) {
plotLine(
value=rsiSeries,
width=2,
colors=[regimeColor],
label=["RSI"],
desc=["Relative Strength Index (Wilder " + rsiLen + ")"]
)
}
// --- MA Line ---
if (showMa) {
plotLine(
value=rsiMa,
width=1,
colors=[maColor],
label=["RSI MA"],
desc=["Moving average of RSI (" + maType + " " + maLen + ")"]
)
}
// --- Momentum Histogram ---
if (showHistogram) {
var histBull = hist >= 0
plotBar(
value=hist,
colors=[transparency(bullColor, 60), transparency(bearColor, 60)],
colorIndex=histBull ? 0 : 1,
width=1,
label=["RSI Momentum"],
desc=["Histogram of RSI minus its MA"]
)
}
// --- Divergence Shapes ---
if (showAlerts && enableDiv) {
if (bullDiv) {
plotShape(
value=rsiSeries,
shape="triangleup",
colorIndex=divBullColor,
width=2,
label=["Bull Div"],
desc=["Bullish regular divergence: price lower low, RSI higher low"]
)
}
if (bearDiv) {
plotShape(
value=rsiSeries,
shape="triangledown",
colorIndex=divBearColor,
width=2,
label=["Bear Div"],
desc=["Bearish regular divergence: price higher high, RSI lower high"]
)
}
if (showHidden && hiddenBullDiv) {
plotShape(
value=rsiSeries,
shape="arrowup",
colorIndex=divBullColor,
width=1,
label=["Hidden Bull"],
desc=["Hidden bullish divergence: price higher low, RSI lower low"]
)
}
if (showHidden && hiddenBearDiv) {
plotShape(
value=rsiSeries,
shape="arrowdown",
colorIndex=divBearColor,
width=1,
label=["Hidden Bear"],
desc=["Hidden bearish divergence: price lower high, RSI higher high"]
)
}
}
// --- Alert Shapes (crossovers, OB/OS, extremes) ---
if (showAlerts) {
if (crossUp) {
plotShape(
value=rsiMa,
shape="circle",
colorIndex=bullColor,
width=2,
label=["Cross Up"],
desc=["RSI crossed above its MA"]
)
}
if (crossDown) {
plotShape(
value=rsiMa,
shape="circle",
colorIndex=bearColor,
width=2,
label=["Cross Down"],
desc=["RSI crossed below its MA"]
)
}
if (obPenetrate) {
plotShape(
value=dynOb,
shape="xcross",
colorIndex=bearColor,
width=2,
label=["OB Penetrate"],
desc=["RSI entered overbought zone (> " + dynOb + ")"]
)
}
if (osPenetrate) {
plotShape(
value=dynOs,
shape="xcross",
colorIndex=bullColor,
width=2,
label=["OS Penetrate"],
desc=["RSI entered oversold zone (< " + dynOs + ")"]
)
}
if (extremeOb) {
plotShape(
value=80,
shape="xcross",
colorIndex=transparency(bearColor, 80),
width=2,
label=["Extreme OB"],
desc=["RSI entered extreme overbought zone (> 80)"]
)
}
if (extremeOs) {
plotShape(
value=20,
shape="xcross",
colorIndex=transparency(bullColor, 80),
width=2,
label=["Extreme OS"],
desc=["RSI entered extreme oversold zone (< 20)"]
)
}
}
// -----------------------------------------------------------------------------
// 10. REGIME TABLE (last bar only)
// -----------------------------------------------------------------------------
if (isLastBar) {
var regimeText = regimeBull ? "BULLISH" : (regimeBear ? "BEARISH" : "NEUTRAL")
var regimeTextColor = regimeColor
var obText = useDynamic ? "Dynamic OB: " + dynOb : "Static OB: " + obLevel
var osText = useDynamic ? "Dynamic OS: " + dynOs : "Static OS: " + osLevel
plotTable(
data=[
["Enhanced RSI — Perfected", regimeText],
["RSI", rsiSeries[0]],
["RSI MA", rsiMa[0]],
["Momentum", hist[0]],
[obText, osText]
],
position="top_right",
headerRow=true,
headerColumn=true,
textColor="#e2e8f0",
headerTextColor="#ffffff",
backgroundColor=transparency("#0f172a", 40),
headerBackgroundColor=transparency("#1e293b", 40),
borderColor=transparency("#334155", 40),
borderWidth=1,
fontSize=10,
cellPadding=4
)
}