MM Flow
FlowScripts

Perfected FlowScript

Rsi divergencia

RSI Divergencia — Perfected is indexed as 293_rsi_divergencia.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

15.6 KB

Lines

532

Native Signal Candidates

8 source-level chart marker triggers extracted from guarded FlowScript v2 blocks.

8/8 guarded

Bull Div

line 417:9

Trigger

(showAlertShapes && enableDiv) && (bullDiv)

Value

rsiVal

Deps

bullDiv:var, enableDiv:input, showAlertShapes:input

Bear Div

line 427:9

Trigger

(showAlertShapes && enableDiv) && (bearDiv)

Value

rsiVal

Deps

bearDiv:var, enableDiv:input, showAlertShapes:input

Hidden Bull

line 437:9

Trigger

(showAlertShapes && enableDiv) && (showHidden && hiddenBullDiv)

Value

rsiVal

Deps

enableDiv:input, hiddenBullDiv:var, showAlertShapes:input, showHidden:input

Hidden Bear

line 447:9

Trigger

(showAlertShapes && enableDiv) && (showHidden && hiddenBearDiv)

Value

rsiVal

Deps

enableDiv:input, hiddenBearDiv:var, showAlertShapes:input, showHidden:input

Cross Up

line 461:9

Trigger

(showAlertShapes) && (crossUp)

Value

signal

Deps

crossUp:var, showAlertShapes:input

Cross Down

line 471:9

Trigger

(showAlertShapes) && (crossDown)

Value

signal

Deps

crossDown:var, showAlertShapes:input

OB Penetrate

line 481:9

Trigger

(showAlertShapes) && (obPenetrate)

Value

dynOb

Deps

obPenetrate:var, showAlertShapes:input

OS Penetrate

line 491:9

Trigger

(showAlertShapes) && (osPenetrate)

Value

dynOs

Deps

osPenetrate:var, showAlertShapes:input

293_rsi_divergencia.flowscript

source path: kscripts/perfected/293_rsi_divergencia.flowscript · sha256:77978324b6286bae1b0fecccd9c3c7b680bf38bea7a78fe151f3eb3565004f43

hash verified
//@version=2
// ============================================================================
// RSI Divergencia — Perfected Edition
// Author: A (@Alexander G.) — Perfected by kScript_Perfection_Engineer
// Tags: CORE, #rsi, #divergence, #divergencia, #momentum
// Index: 293
//
// Production-quality RSI divergence oscillator with stateful regular and hidden
// divergence detection, dynamic volatility-adjusted thresholds, regime color
// coding, and comprehensive fill / shape / histogram visualization.
//
// 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 divergence concept: price/indicator disagreement
//     at extremes precedes reversals.
//  2. Ponnusamy & Manual (2016), "A Study on Financial Indicators' Reliability":
//     RSI outperforms MACD and Stochastic in signal reliability; multi-indicator
//     confirmation recommended.
//  3. Jegadeesh & Titman (1993), "Returns to Buying Winners and Selling
//     Losers": momentum as a premier cross-sectional anomaly; validates RSI's
//     momentum-measurement role.
//  4. Poterba & Summers (1988), "Mean Reversion in Stock Prices": negative
//     autocorrelation at medium horizons supports dynamic overbought/oversold
//     thresholds calibrated to rolling volatility.
//  5. Murphy (1999), "Technical Analysis of the Financial Markets": divergence
//     as a leading reversal signal — price makes higher high while indicator
//     makes lower high signals waning momentum.
// ============================================================================

define(
    title="RSI Divergencia — Perfected",
    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 smoothLen = input(
    name="smoothLen",
    type="number",
    defaultValue=3,
    label="EMA Smoothing Length",
    constraints={min: 1, max: 20, step: 1},
    group="RSI Settings"
)
var useWilder = input(
    name="useWilder",
    type="boolean",
    defaultValue=true,
    label="Use Wilder Smoothing",
    group="RSI Settings"
)

// --- Signal ---
var signalLen = input(
    name="signalLen",
    type="number",
    defaultValue=14,
    label="Signal SMA Length",
    constraints={min: 2, max: 50, step: 1},
    group="Signal"
)

// --- 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"
)

// --- 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="Pivot Lookback (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 showSignalFill = input(
    name="showSignalFill",
    type="boolean",
    defaultValue=true,
    label="Show Signal Fill",
    group="Display"
)
var showHistogram = input(
    name="showHistogram",
    type="boolean",
    defaultValue=true,
    label="Show Momentum Histogram",
    group="Display"
)
var showObOs = input(
    name="showObOs",
    type="boolean",
    defaultValue=true,
    label="Show OB/OS Zones",
    group="Display"
)
var showAlertShapes = input(
    name="showAlertShapes",
    type="boolean",
    defaultValue=true,
    label="Show Alert Shapes",
    group="Display"
)

// --- Colors ---
var bullColor = input(
    name="bullColor",
    type="color",
    defaultValue="#26a69a",
    label="Bull Color",
    group="Display"
)
var bearColor = input(
    name="bearColor",
    type="color",
    defaultValue="#ef5350",
    label="Bear Color",
    group="Display"
)
var signalColor = input(
    name="signalColor",
    type="color",
    defaultValue="#ffffff",
    label="Signal Line Color",
    group="Display"
)
var divBullColor = input(
    name="divBullColor",
    type="color",
    defaultValue="#00e676",
    label="Bullish Divergence Color",
    group="Display"
)
var divBearColor = input(
    name="divBearColor",
    type="color",
    defaultValue="#ff5252",
    label="Bearish Divergence Color",
    group="Display"
)

// -----------------------------------------------------------------------------
// 2. DATA SOURCES & NaN GUARD
// -----------------------------------------------------------------------------
timeseries bars = ohlcv(symbol=currentSymbol, exchange=currentExchange)
timeseries px = bars.close

if (isnan(px[0])) {
    return
}

// -----------------------------------------------------------------------------
// 3. WILDER RSI — canonical implementation
// -----------------------------------------------------------------------------
// RSI = 100 − [100 / (1 + RS)] where RS = Average Gain / Average Loss
// Per Wilder (1978), the original uses a smoothed moving average of gains/losses.
// We offer both the canonical SMA-based RS and the smoothed EMA variant.

timeseries change = px[0] - px[1]
timeseries gain = change > 0 ? change : 0
timeseries loss = change < 0 ? -change : 0

timeseries avgGain = useWilder ? ema(source=gain, period=rsiLen) : sma(source=gain, period=rsiLen)
timeseries avgLoss = useWilder ? ema(source=loss, period=rsiLen) : sma(source=loss, period=rsiLen)

// Guard against division by zero
timeseries rs = avgLoss > 0 ? avgGain / avgLoss : 0
timeseries rsiRaw = 100 - (100 / (1 + rs))

// -----------------------------------------------------------------------------
// 4. SMOOTHING & SIGNAL
// -----------------------------------------------------------------------------
timeseries rsiVal = ema(source=rsiRaw, period=smoothLen)
timeseries signal = sma(source=rsiVal, period=signalLen)

// Momentum histogram (RSI minus signal)
timeseries hist = rsiVal - signal

// -----------------------------------------------------------------------------
// 5. REGIME DETECTION
// -----------------------------------------------------------------------------
// Regime classification:
//   Bullish: rsiVal > signal AND rsiVal > 50
//   Bearish: rsiVal < signal AND rsiVal < 50
//   Neutral: everything else (chop zone)

var regimeBull = rsiVal > signal && rsiVal > 50
var regimeBear = rsiVal < signal && rsiVal < 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(source=rsiVal, period=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.

// Pivot detection using trailing highest/lowest
var isHighPivot = bars.high == highest(source=bars.high, period=divLookback)
var isLowPivot = bars.low == lowest(source=bars.low, period=divLookback)

// Stateful pivot history
static ph1 = 0.0
static ph2 = 0.0
static prh1 = 0.0
static prh2 = 0.0
static pl1 = 0.0
static pl2 = 0.0
static prl1 = 0.0
static prl2 = 0.0

var bearDiv = false
var bullDiv = false
var hiddenBearDiv = false
var hiddenBullDiv = false

if (!isLiveUpdate && enableDiv) {
    // Record pivot highs
    if (isHighPivot && bars.high[0] != ph1) {
        ph2 = ph1
        prh2 = prh1
        ph1 = bars.high[0]
        prh1 = rsiVal[0]
    }

    // Record pivot lows
    if (isLowPivot && bars.low[0] != pl1) {
        pl2 = pl1
        prl2 = prl1
        pl1 = bars.low[0]
        prl1 = rsiVal[0]
    }

    // Regular bearish divergence: price higher high, RSI lower high
    if (ph2 > 0 && ph1 > ph2 && prh1 < prh2) {
        bearDiv = true
    }

    // Regular bullish divergence: price lower low, RSI higher low
    if (pl2 > 0 && pl1 < pl2 && prl1 > prl2) {
        bullDiv = true
    }

    // Hidden divergence
    if (showHidden) {
        // Hidden bearish: price lower high, RSI higher high
        if (ph2 > 0 && ph1 < ph2 && prh1 > prh2) {
            hiddenBearDiv = true
        }
        // Hidden bullish: price higher low, RSI lower low
        if (pl2 > 0 && pl1 > pl2 && prl1 < prl2) {
            hiddenBullDiv = true
        }
    }
}

// -----------------------------------------------------------------------------
// 8. ALERT CONDITIONS
// -----------------------------------------------------------------------------
// Crossover / crossunder of RSI and signal
var crossUp = rsiVal > signal && rsiVal[1] <= signal[1]
var crossDown = rsiVal < signal && rsiVal[1] >= signal[1]

// OB / OS penetrations (using dynamic or static thresholds)
var obPenetrate = rsiVal > dynOb && rsiVal[1] <= dynOb
var osPenetrate = rsiVal < dynOs && rsiVal[1] >= dynOs

// OB / OS exit (return to neutral zone)
var obExit = rsiVal < dynOb && rsiVal[1] >= dynOb
var osExit = rsiVal > dynOs && rsiVal[1] <= dynOs

// -----------------------------------------------------------------------------
// 9. PLOTTING
// -----------------------------------------------------------------------------

// --- Midline ---
hline(value=50, color="#ffffff20", width=1)

// --- OB / OS Zones ---
if (showObOs) {
    hline(value=dynOb, color=transparency(bearColor, 60), width=1)
    hline(value=dynOs, color=transparency(bullColor, 60), width=1)
}

// --- RSI Line (regime-colored) ---
plotLine(
    value=rsiVal,
    width=2,
    colors=[regimeColor],
    label=["RSI"],
    desc=["Smoothed RSI (Wilder " + rsiLen + ")"]
)

// --- Signal SMA ---
plotLine(
    value=signal,
    width=1,
    colors=[signalColor],
    label=["Signal"],
    desc=["SMA of smoothed RSI (" + signalLen + ")"]
)

// --- Signal Fill (RSI vs signal) ---
if (showSignalFill) {
    var signalBull = rsiVal > signal
    plotLine(
        value=[rsiVal, signal],
        width=1,
        colors=[transparency(bullColor, 20), transparency(bearColor, 20)],
        colorIndex=signalBull ? 0 : 1,
        fill=true,
        label=["RSI", "Signal"],
        desc=["Fill between RSI and signal SMA"]
    )
}

// --- 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=["Momentum"],
        desc=["Histogram of RSI minus signal SMA"]
    )
}

// --- Divergence Shapes ---
if (showAlertShapes && enableDiv) {
    if (bullDiv) {
        plotShape(
            value=rsiVal,
            shape="triangleup",
            colorIndex=divBullColor,
            width=2,
            label=["Bull Div"],
            desc=["Bullish regular divergence: price lower low, RSI higher low"]
        )
    }
    if (bearDiv) {
        plotShape(
            value=rsiVal,
            shape="triangledown",
            colorIndex=divBearColor,
            width=2,
            label=["Bear Div"],
            desc=["Bearish regular divergence: price higher high, RSI lower high"]
        )
    }
    if (showHidden && hiddenBullDiv) {
        plotShape(
            value=rsiVal,
            shape="arrowup",
            colorIndex=divBullColor,
            width=1,
            label=["Hidden Bull"],
            desc=["Hidden bullish divergence: price higher low, RSI lower low"]
        )
    }
    if (showHidden && hiddenBearDiv) {
        plotShape(
            value=rsiVal,
            shape="arrowdown",
            colorIndex=divBearColor,
            width=1,
            label=["Hidden Bear"],
            desc=["Hidden bearish divergence: price lower high, RSI higher high"]
        )
    }
}

// --- Alert Shapes (crossovers, OB/OS) ---
if (showAlertShapes) {
    if (crossUp) {
        plotShape(
            value=signal,
            shape="circle",
            colorIndex=bullColor,
            width=2,
            label=["Cross Up"],
            desc=["RSI crossed above signal SMA"]
        )
    }
    if (crossDown) {
        plotShape(
            value=signal,
            shape="circle",
            colorIndex=bearColor,
            width=2,
            label=["Cross Down"],
            desc=["RSI crossed below signal SMA"]
        )
    }
    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 + ")"]
        )
    }
}

// -----------------------------------------------------------------------------
// 10. REGIME TABLE (last bar only)
// -----------------------------------------------------------------------------
if (isLastBar) {
    var regimeText = regimeBull ? "BULLISH" : (regimeBear ? "BEARISH" : "NEUTRAL")
    var regimeTextColor = regimeBull ? bullColor : (regimeBear ? bearColor : "#9e9e9e")
    var obText = useDynamic ? "Dynamic OB: " + dynOb : "Static OB: " + obLevel
    var osText = useDynamic ? "Dynamic OS: " + dynOs : "Static OS: " + osLevel

    plotTable(
        data=[
            ["RSI Divergencia", regimeText],
            ["RSI", rsiVal[0]],
            ["Signal", signal[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
    )
}