Perfected FlowScript
Aggregated Open Interest RSI Oscillator
Aggregated OI RSI Oscillator V2 is indexed as 190_aggregated_open_interest_rsi_oscillator.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
21.6 KB
Lines
680
Native Signal Candidates
8 source-level chart marker triggers extracted from guarded FlowScript v2 blocks.
Bull Div
line 563:9
Trigger
(showAlerts && enableDiv) && (bullDiv)
Value
fastRsi
Deps
bullDiv:var, enableDiv:input, showAlerts:input
Bear Div
line 573:9
Trigger
(showAlerts && enableDiv) && (bearDiv)
Value
fastRsi
Deps
bearDiv:var, enableDiv:input, showAlerts:input
Hidden Bull
line 583:9
Trigger
(showAlerts && enableDiv) && (showHidden && hiddenBullDiv)
Value
fastRsi
Deps
enableDiv:input, hiddenBullDiv:var, showAlerts:input, showHidden:input
Hidden Bear
line 593:9
Trigger
(showAlerts && enableDiv) && (showHidden && hiddenBearDiv)
Value
fastRsi
Deps
enableDiv:input, hiddenBearDiv:var, showAlerts:input, showHidden:input
Cross Up
line 607:9
Trigger
(showAlerts) && (crossUp)
Value
signal
Deps
crossUp:var, showAlerts:input
Cross Down
line 617:9
Trigger
(showAlerts) && (crossDown)
Value
signal
Deps
crossDown:var, showAlerts:input
OB Penetrate
line 627:9
Trigger
(showAlerts) && (obPenetrate)
Value
dynOb
Deps
obPenetrate:var, showAlerts:input
OS Penetrate
line 637:9
Trigger
(showAlerts) && (osPenetrate)
Value
dynOs
Deps
osPenetrate:var, showAlerts:input
190_aggregated_open_interest_rsi_oscillator.flowscript
source path: kscripts/perfected/190_aggregated_open_interest_rsi_oscillator.flowscript · sha256:0edc4c3d55d555869c661a02be803fbfee32f6b12c88d93f358771b3c124c880
//@version=2
// ============================================================================
// Aggregated Open Interest RSI Oscillator V2 — Production-Quality Edition
// Author: kiyotaka (@kiyotaka) | Perfected by: kScript Perfection Engineer
// Tags: CORE, #oi, #rsi, #open_interest, #futures, #divergence, #regime
//
// Production-quality academically-grounded RSI oscillator applied to aggregated
// open interest across multiple futures exchanges. Implements Wilder's canonical
// RSI formula with full stateful divergence detection, dynamic volatility-
// adjusted thresholds, multi-regime color coding, and comprehensive fill /
// shape / histogram visualization.
//
// FORMULA FOUNDATION:
// 1. Aggregated OI: OI_agg = Σ OI_i across N exchanges (Chen, Cuny & Haugen 1995)
// 2. Wilder RSI: RSI = 100 − [100 / (1 + RS)] where RS = SMA(gain, N) / SMA(loss, N)
// per Wilder (1978).
// 3. Dynamic Thresholds: adjusted by rolling RSI standard deviation per
// Poterba & Summers (1988) mean-reversion intensity.
// 4. Divergence Detection: price/OI-RSI disagreement at extremes precedes
// regime shifts per Murphy (1999).
//
// RESEARCH BASIS:
// • Wilder (1978), "New Concepts in Technical Trading Systems": canonical
// RSI publication. RSI = 100 − [100 / (1 + RS)]. Original smoothing = 14.
// • Chen, Cuny & Haugen (1995), "Stock Volatility and the Levels of the Basis
// and Open Interest in Futures Contracts", J. Finance 50(1), 281–300.
// Higher OI associated with greater information flow and price discovery.
// • Jegadeesh & Titman (1993), "Returns to Buying Winners and Selling Losers":
// established momentum as a premier cross-sectional anomaly.
// • Poterba & Summers (1988), "Mean Reversion in Stock Prices": negative
// autocorrelation at medium horizons; supports dynamic thresholds.
// • Ponnusamy & Manual (2016): experimental finding that RSI outperforms MACD
// and Stochastic in signal reliability; multi-indicator confirmation.
// • Murphy (1999), "Technical Analysis of the Financial Markets": divergence
// as a leading reversal signal — price/indicator disagreement at extremes.
// • Xu et al. (2021), "An Empirical Analysis of the Price Volatility
// Characteristics of China's Soybean Futures Market": unexpected OI changes
// carry more predictive power than absolute levels.
// ============================================================================
define(
title="Aggregated OI RSI Oscillator V2",
position="offchart",
axis=true
)
// -----------------------------------------------------------------------------
// 1. USER INPUTS — grouped with constraints
// -----------------------------------------------------------------------------
// --- OI Sources ---
var oiSymbol1 = input(name="oiSymbol1", type="string", defaultValue="BTCUSDT", label="OI Symbol 1", group="OI Sources")
var oiExchange1 = input(name="oiExchange1", type="string", defaultValue="BINANCE_FUTURES", label="OI Exchange 1", group="OI Sources")
var oiSymbol2 = input(name="oiSymbol2", type="string", defaultValue="BTCUSDT", label="OI Symbol 2", group="OI Sources")
var oiExchange2 = input(name="oiExchange2", type="string", defaultValue="BYBIT", label="OI Exchange 2", group="OI Sources")
var oiSymbol3 = input(name="oiSymbol3", type="string", defaultValue="BTCUSDT", label="OI Symbol 3", group="OI Sources")
var oiExchange3 = input(name="oiExchange3", type="string", defaultValue="OKX", label="OI Exchange 3", group="OI Sources")
var useOI3 = input(name="useOI3", type="boolean", defaultValue=true, label="Enable Exchange 3", group="OI Sources")
// --- RSI Settings ---
var fastLen = input(
name="fastLen",
type="number",
defaultValue=14,
label="Fast RSI Length",
constraints={min: 2, max: 50, step: 1},
group="RSI Settings"
)
var slowLen = input(
name="slowLen",
type="number",
defaultValue=20,
label="Slow 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 smoothLen = input(
name="smoothLen",
type="number",
defaultValue=3,
label="EMA Smoothing Length",
constraints={min: 1, max: 20, step: 1},
group="Smoothing"
)
var signalLen = input(
name="signalLen",
type="number",
defaultValue=14,
label="Signal SMA Length",
constraints={min: 2, max: 50, 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"
)
// --- 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 showFastSlow = input(
name="showFastSlow",
type="boolean",
defaultValue=true,
label="Show Fast & Slow RSI Lines",
group="Display"
)
var showRibbon = input(
name="showRibbon",
type="boolean",
defaultValue=true,
label="Show RSI Ribbon (fast/slow fill)",
group="Display"
)
var showSignalFill = input(
name="showSignalFill",
type="boolean",
defaultValue=true,
label="Show Signal Fill (avg/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 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="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
timeseries oi1 = open_interest(symbol=oiSymbol1, exchange=oiExchange1)
timeseries oi2 = open_interest(symbol=oiSymbol2, exchange=oiExchange2)
timeseries oi3 = useOI3 ? open_interest(symbol=oiSymbol3, exchange=oiExchange3) : oi2
if (isnan(px[0]) || isnan(oi1.close[0]) || isnan(oi2.close[0])) {
return
}
// -----------------------------------------------------------------------------
// 3. AGGREGATED OPEN INTEREST
// -----------------------------------------------------------------------------
// Aggregate OI (sum of close) across multiple exchanges
// Per Chen, Cuny & Haugen (1995), higher OI is associated with greater
// information flow and price discovery activity.
// Per Xu et al. (2021), unexpected OI changes have larger impact on
// price volatility than expected changes.
timeseries aggOI = oi1.close + oi2.close + (useOI3 ? oi3.close : 0)
// OI change (delta) — the information-bearing component
timeseries dOI = aggOI - aggOI[1]
// -----------------------------------------------------------------------------
// 4. WILDER RSI ON AGGREGATED OI — 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.
// OI change
timeseries gain = dOI > 0 ? dOI : 0
timeseries loss = dOI < 0 ? -dOI : 0
// Average gain/loss using Wilder smoothing (EMA with alpha = 1/N)
// or standard SMA per user toggle
timeseries avgGain = useWilder ? ema(source=gain, period=fastLen) : sma(source=gain, period=fastLen)
timeseries avgLoss = useWilder ? ema(source=loss, period=fastLen) : sma(source=loss, period=fastLen)
// Guard against division by zero
timeseries rs = avgLoss > 0 ? avgGain / avgLoss : 0
timeseries fastRaw = 100 - (100 / (1 + rs))
// Slow RSI on OI delta
timeseries slowGain = dOI > 0 ? dOI : 0
timeseries slowLoss = dOI < 0 ? -dOI : 0
timeseries avgGainSlow = useWilder ? ema(source=slowGain, period=slowLen) : sma(source=slowGain, period=slowLen)
timeseries avgLossSlow = useWilder ? ema(source=slowLoss, period=slowLen) : sma(source=slowLoss, period=slowLen)
timeseries rsSlow = avgLossSlow > 0 ? avgGainSlow / avgLossSlow : 0
timeseries slowRaw = 100 - (100 / (1 + rsSlow))
// -----------------------------------------------------------------------------
// 5. SMOOTHING & SIGNAL
// -----------------------------------------------------------------------------
timeseries fastRsi = ema(source=fastRaw, period=smoothLen)
timeseries slowRsi = ema(source=slowRaw, period=smoothLen)
// Averaged RSI (midpoint of fast and slow)
timeseries avgRsi = (fastRsi + slowRsi) / 2
// Signal SMA
timeseries signal = sma(source=avgRsi, period=signalLen)
// Momentum histogram (RSI minus signal)
timeseries hist = avgRsi - signal
// -----------------------------------------------------------------------------
// 6. REGIME DETECTION
// -----------------------------------------------------------------------------
// Regime classification:
// Bullish: avgRsi > signal AND avgRsi > 50
// Bearish: avgRsi < signal AND avgRsi < 50
// Neutral: everything else (chop zone)
var regimeBull = avgRsi > signal && avgRsi > 50
var regimeBear = avgRsi < signal && avgRsi < 50
var regimeNeutral = !regimeBull && !regimeBear
var regimeColor = regimeBull ? bullColor : (regimeBear ? bearColor : "#9e9e9e")
// -----------------------------------------------------------------------------
// 7. 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=avgRsi, 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
}
// -----------------------------------------------------------------------------
// 8. DIVERGENCE DETECTION (stateful via static variables)
// -----------------------------------------------------------------------------
// Regular divergence: price makes higher high / lower low, OI-RSI disagrees.
// Hidden divergence: price makes higher low / lower high, OI-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 = bars.high[0]
prevRsiHigh = fastRsi[0]
prevPxLow = bars.low[0]
prevRsiLow = fastRsi[0]
prevPxHighLow = bars.high[0]
prevRsiHighLow = fastRsi[0]
prevPxLowHigh = bars.low[0]
prevRsiLowHigh = fastRsi[0]
}
if (!isLiveUpdate && enableDiv) {
// --- Regular Bearish Divergence ---
// Price makes a higher high; OI-RSI makes a lower high
var pxHigh = highest(source=bars.high, period=divLookback)
var rsiHigh = highest(source=fastRsi, period=divLookback)
if (bars.high[0] > prevPxHigh) {
if (fastRsi[0] < prevRsiHigh) {
bearDiv = true
}
prevPxHigh = bars.high[0]
prevRsiHigh = fastRsi[0]
}
// --- Regular Bullish Divergence ---
// Price makes a lower low; OI-RSI makes a higher low
var pxLow = lowest(source=bars.low, period=divLookback)
var rsiLow = lowest(source=fastRsi, period=divLookback)
if (bars.low[0] < prevPxLow) {
if (fastRsi[0] > prevRsiLow) {
bullDiv = true
}
prevPxLow = bars.low[0]
prevRsiLow = fastRsi[0]
}
// --- Hidden Divergence ---
// Hidden bullish: price higher low, OI-RSI lower low
// Hidden bearish: price lower high, OI-RSI higher high
if (showHidden) {
// Hidden bullish: price makes a higher low vs prior low
if (bars.low[0] > prevPxLow && bars.high[0] < prevPxHigh) {
if (fastRsi[0] < prevRsiLow) {
hiddenBullDiv = true
}
}
// Hidden bearish: price makes a lower high vs prior high
if (bars.high[0] < prevPxHigh && bars.low[0] > prevPxLow) {
if (fastRsi[0] > prevRsiHigh) {
hiddenBearDiv = true
}
}
}
}
// -----------------------------------------------------------------------------
// 9. ALERT CONDITIONS
// -----------------------------------------------------------------------------
// Crossover / crossunder of averaged RSI and signal
var crossUp = avgRsi > signal && avgRsi[1] <= signal[1]
var crossDown = avgRsi < signal && avgRsi[1] >= signal[1]
// OB / OS penetrations (using dynamic or static thresholds)
var obPenetrate = avgRsi > dynOb && avgRsi[1] <= dynOb
var osPenetrate = avgRsi < dynOs && avgRsi[1] >= dynOs
// OB / OS exit (return to neutral zone)
var obExit = avgRsi < dynOb && avgRsi[1] >= dynOb
var osExit = avgRsi > dynOs && avgRsi[1] <= dynOs
// -----------------------------------------------------------------------------
// 10. STATIC TRACKING
// -----------------------------------------------------------------------------
static sessionHighRsi = -1.0
static sessionLowRsi = 999.0
static obCount = 0
static osCount = 0
static lastBarIndex = 0
var currentBarIndex = bar_index[0]
if (!isnan(currentBarIndex) && currentBarIndex != lastBarIndex) {
lastBarIndex = currentBarIndex
if (avgRsi > sessionHighRsi) {
sessionHighRsi = avgRsi
}
if (avgRsi < sessionLowRsi) {
sessionLowRsi = avgRsi
}
if (avgRsi > dynOb) {
obCount = obCount + 1
}
if (avgRsi < dynOs) {
osCount = osCount + 1
}
}
// -----------------------------------------------------------------------------
// 11. 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)
}
// --- Fast / Slow RSI Ribbon Fill ---
if (showRibbon) {
var ribbonBull = fastRsi > slowRsi
plotLine(
value=[fastRsi, slowRsi],
width=1,
colors=[transparency(bullColor, 30), transparency(bearColor, 30)],
colorIndex=ribbonBull ? 0 : 1,
fill=true,
label=["Fast OI RSI", "Slow OI RSI"],
desc=["Fast smoothed OI-RSI ribbon edge", "Slow smoothed OI-RSI ribbon edge"]
)
}
// --- Individual Fast & Slow Lines ---
if (showFastSlow) {
plotLine(
value=fastRsi,
width=2,
colors=[bullColor],
label=["Fast OI RSI"],
desc=["Fast smoothed OI-RSI (Wilder " + fastLen + ")"]
)
plotLine(
value=slowRsi,
width=2,
colors=[bearColor],
label=["Slow OI RSI"],
desc=["Slow smoothed OI-RSI (Wilder " + slowLen + ")"]
)
}
// --- Averaged RSI (regime-colored) ---
plotLine(
value=avgRsi,
width=2,
colors=[regimeColor],
label=["Avg OI RSI"],
desc=["Averaged smoothed OI-RSI (regime-colored)"]
)
// --- Signal SMA ---
plotLine(
value=signal,
width=1,
colors=[signalColor],
label=["Signal SMA"],
desc=["SMA of averaged smoothed OI-RSI (" + signalLen + ")"]
)
// --- Signal Fill (avg RSI vs signal) ---
if (showSignalFill) {
var signalBull = avgRsi > signal
plotLine(
value=[avgRsi, signal],
width=1,
colors=[transparency(bullColor, 20), transparency(bearColor, 20)],
colorIndex=signalBull ? 0 : 1,
fill=true,
label=["Avg OI RSI", "Signal SMA"],
desc=["Fill between averaged OI-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=["OI RSI Momentum"],
desc=["Histogram of averaged OI-RSI minus signal SMA"]
)
}
// --- Divergence Shapes ---
if (showAlerts && enableDiv) {
if (bullDiv) {
plotShape(
value=fastRsi,
shape="triangleup",
colorIndex=divBullColor,
width=2,
label=["Bull Div"],
desc=["Bullish regular divergence: price lower low, OI-RSI higher low"]
)
}
if (bearDiv) {
plotShape(
value=fastRsi,
shape="triangledown",
colorIndex=divBearColor,
width=2,
label=["Bear Div"],
desc=["Bearish regular divergence: price higher high, OI-RSI lower high"]
)
}
if (showHidden && hiddenBullDiv) {
plotShape(
value=fastRsi,
shape="arrowup",
colorIndex=divBullColor,
width=1,
label=["Hidden Bull"],
desc=["Hidden bullish divergence: price higher low, OI-RSI lower low"]
)
}
if (showHidden && hiddenBearDiv) {
plotShape(
value=fastRsi,
shape="arrowdown",
colorIndex=divBearColor,
width=1,
label=["Hidden Bear"],
desc=["Hidden bearish divergence: price lower high, OI-RSI higher high"]
)
}
}
// --- Alert Shapes (crossovers, OB/OS) ---
if (showAlerts) {
if (crossUp) {
plotShape(
value=signal,
shape="circle",
colorIndex=bullColor,
width=2,
label=["Cross Up"],
desc=["Averaged OI-RSI crossed above signal SMA"]
)
}
if (crossDown) {
plotShape(
value=signal,
shape="circle",
colorIndex=bearColor,
width=2,
label=["Cross Down"],
desc=["Averaged OI-RSI crossed below signal SMA"]
)
}
if (obPenetrate) {
plotShape(
value=dynOb,
shape="xcross",
colorIndex=bearColor,
width=2,
label=["OB Penetrate"],
desc=["OI-RSI entered overbought zone (RSI > " + dynOb + ")"]
)
}
if (osPenetrate) {
plotShape(
value=dynOs,
shape="xcross",
colorIndex=bullColor,
width=2,
label=["OS Penetrate"],
desc=["OI-RSI entered oversold zone (RSI < " + dynOs + ")"]
)
}
}
// -----------------------------------------------------------------------------
// 12. 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=[
["OI RSI Pro — Perfected", regimeText],
["Fast OI RSI", fastRsi[0]],
["Slow OI RSI", slowRsi[0]],
["Avg OI RSI", avgRsi[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
)
}