Ranked Support And Resistance Indicator

1.1 Indicator Concept

Most support/resistance (S/R) indicators simply mark every swing high and swing low as a level, leaving the chart cluttered with dozens of lines of unknown quality. This indicator is built on a different idea: not every S/R zone deserves equal attention. A zone that formed on high volume, aligns with the prevailing trend, was born from a sharp/clean swing, and has already proven itself by being touched and defended multiple times, is structurally more important than a random pivot that appeared once and was never revisited.

• Zones, not lines: every S/R level is stored as a price zone (a band of width proportional to ATR) rather than a single price, because in real markets price rarely reacts to one exact tick.
• Scoring engine: each zone is continuously scored from 0-100 using five inputs - zone size, volume at creation, trend alignment, swing sharpness, and how many times it has been revisited - minus penalties for age and for being "eaten into" by price (mitigation).
• Ranking, not accumulation: every bar, all stored zones are re-sorted by score and only the Top-N zones are actually drawn. Lower ranked zones stay in memory (in case they climb back up) but are hidden from view, keeping the chart clean.
• Lifecycle awareness: a zone is not permanent. It can be absorbed into an existing nearby zone (reducing duplicate clutter), mitigated (price has partly filled through it, weakening it), broken (price closed convincingly through it, invalidating it), or simply expire from old age.

1.2 Indicator Features

• Zone Boxes:
  • Teal boxes = support zones (price floors), orange boxes = resistance zones (price ceilings).
  • Each box spans a price band (top/bottom) and stretches across time, continuously extending to the right while the zone is still active.
  • Only the top-ranked zones (controlled by "Show Top Zones") are drawn in full color; the rest exist internally but are invisible.
• Strength Bars:
  • Inside every visible zone, the upper half can show an orange bar with a bear % label (sell-side conviction) and the lower half a teal bar with a bull % label (buy-side conviction).
  • The bar's length is proportional to its percentage - a 90% bull bar visually stretches almost across the whole zone width, a 20% bar stays short.
• Zone Text: a short label such as "Strong Support", "Support", "Weak Support" or "Mitigated Support" (and the resistance equivalents) is printed inside the zone, summarizing its current quality in words.
• Broken Zone Marker: when a zone is invalidated, its box turns gray and its centerline becomes a visible dotted gray line marking exactly where the old zone used to sit. A limited number of the most recently broken zones are kept on the chart before being fully removed.
• Direction Filter: the indicator can be set to show "All" zones, "Support Only", or "Resistance Only".
• Alerts: 12 alert conditions covering zone creation, top-rank changes, price touching/mitigating a zone, and zone breaks - split separately for support and resistance.

1.3 How to Use the Indicator

• Trade the Top-Ranked Zones First: because zones are re-ranked every bar, the ones currently drawn on your chart are (by the indicator's own scoring) the most relevant S/R levels right now - treat these as your primary reaction zones for entries, take-profit, or stop-loss placement.
• Read the Strength Bars Before Reacting: a support zone with a 85% bull bar is a much higher-conviction "buy the dip" zone than one sitting at 30%. Compare bull vs bear % inside the same zone to judge which side is currently winning the fight for that price area.
• Watch the Zone Text for Early Warning: once a zone's label flips to "Weak Support" or "Mitigated Support", price has already chewed through a large portion of it - treat it as less reliable than a fresh "Strong Support".
• Use Break Alerts as Breakout Confirmation: a "Resistance Broken" alert means price closed convincingly above a ranked ceiling (a bullish break), while "Support Broken" means a bearish break below a ranked floor - both can be used as breakout/momentum entry triggers.
• Use the Top-Rank Alerts to Track Leadership: "New Top-Ranked S/R Zone" fires whenever the #1-scored zone changes, letting you know the single most important level on the chart has shifted.
• Tune to Your Market/Timeframe: increase "Pivot Length" and "Min Pivot ATR" on noisy/lower timeframes to keep only clean, well-confirmed swings; widen "Zone Width ATR" on volatile instruments so zones aren't too thin to react to.

1.4 How the Indicator Works

Inputs & Roles

• visibleLimit ("Show Top Zones", Integer, default: 8, range 1-30): how many of the highest-ranked zones are actually drawn on the chart. Example: with visibleLimit=8, if the engine currently holds 40 zones in memory, only the top 8 by score get colored boxes - the other 32 stay invisible until they rank high enough to enter the top 8. Increase → more zones visible at once (busier chart). Decrease → only the very best zones shown (cleaner chart, but you may miss secondary levels).
• storedLimit ("Max Stored Zones", Integer, default: 60, range 10-250): the maximum number of zones kept in memory at all (visible + hidden). Once exceeded, the lowest-scored zone is deleted every bar until the count is back at the limit. Increase → more historical zones remembered, better chance a hidden zone can climb back into the visible top-N later. Decrease → less memory used, but old lower-ranked zones are forgotten faster.
• pivotSpan ("Pivot Length", Integer, default: 5, range 2-50): number of bars required on both sides of a swing high/low for it to be confirmed as a pivot (using ta.pivothigh/ta.pivotlow). Example: pivotSpan=5 means a candle only becomes a confirmed swing high once the 5 bars before AND the 5 bars after it are all lower - so confirmation always arrives 5 bars late. Increase → fewer but more reliable pivots (major swings only). Decrease → more pivots detected, more (and noisier) zones created, but confirmed faster.
• minSwingAtr ("Min Pivot ATR", Float, default: 0.15, range 0-5): minimum "sharpness" a pivot must have, measured in ATR multiples, before it is allowed to become a zone. Sharpness (swing quality) is how far the pivot price sticks out above/below the candles immediately next to it. Example: if ATR=$10 and minSwingAtr=0.15, a swing high must protrude at least $1.5 above its neighboring bars' highs to qualify; a flatter, barely-there pivot is ignored. Increase → only sharp, obvious swings create zones (fewer, cleaner zones). Decrease (toward 0) → even very mild pivots create zones (more zones, more noise).
• absorbAtr ("Absorb Similar Zones", Float, default: 0.55, range 0-3): maximum distance (in ATR) between a new pivot's midpoint and an existing zone's midpoint for the new pivot to be merged into that zone instead of creating a duplicate. Example: ATR=$10, absorbAtr=0.55 → any new pivot within $5.5 of an existing zone's center gets absorbed (reconfirming/widening that zone) rather than drawing a brand-new box right next to it. Increase → more aggressive merging, fewer total zones, each one more "battle tested". Decrease → more separate zones created even when close together.
• zoneAtrWidth ("Zone Width ATR", Float, default: 0.40, range 0.05-2): thickness of a zone box, in ATR multiples, split evenly above and below the pivot price. Example: ATR=$10, zoneAtrWidth=0.40 → zone half-width = 0.40×10×0.5 = $2, so a pivot at $100 creates a zone spanning $98-$102. Increase → thicker zones (price reacts "inside" a wider band, but zones overlap and absorb more easily). Decrease → thinner, more precise zones, but more easily missed or immediately broken by a wick.
• volLen ("Volume MA Length", Integer, default: 20): lookback for the average-volume baseline (ta.sma(volume, volLen)) that each new zone's creation-volume is compared against. Example: if the 20-bar average volume is 1,000 and the pivot bar's volume was 2,000, the zone's volume score = 2.0 (double the average), which strengthens its rank. Increase → smoother, slower-changing baseline. Decrease → baseline reacts faster to recent volume spikes/dips.
• trendLen ("Trend EMA Length", Integer, default: 50): length of the EMA used to judge whether a zone is aligned with the broader trend. A support zone that formed above this EMA, or a resistance zone that formed below it, gets a trend-alignment bonus to its score (the idea: a support pullback within an uptrend, or a resistance rejection within a downtrend, is more meaningful). Increase → trend filter reacts to a longer-term bias. Decrease → reacts to a shorter-term bias.
• breakAtr ("Break Close Buffer ATR", Float, default: 0.12, range 0-3): how far (in ATR) price must close beyond a zone's edge before that zone is declared broken - a buffer that prevents a zone from being invalidated by a marginal close right at its border. Example: ATR=$10, breakAtr=0.12 → a support zone with bottom at $98 is only broken once close < 98 - (0.12×10) = $96.8. Increase → harder to break a zone (more buffer, fewer false breaks). Decrease → easier to break, more sensitive to marginal closes.
• keepBrokenCount ("Keep Broken Zones", Integer, default: 4, range 0-30): how many of the most recently broken zones stay visible (as gray boxes + dotted lines) on the chart before being fully deleted, oldest first. Set to 0 → broken zones disappear immediately, no visual history of past breaks. Increase → more broken-zone history kept visible as reference (e.g., a former resistance that could now act as support).
• directionFilter ("Direction Filter", Options: All / Support Only / Resistance Only, default: All): restricts which zones are eligible to be shown. Example: setting "Support Only" hides all resistance zones from the visible top-N (they still exist and are still scored internally, just never drawn).
• showStrengthBars (Boolean, default: true): shows/hides the bull%/bear% strength bars inside each visible zone. If turned off, zones are drawn as plain colored boxes with no internal bars.
• showZoneText (Boolean, default: true): shows/hides the text label ("Strong Support", etc.) inside each visible zone.
• strengthTextSize / zoneTextSize (Options: auto/tiny/small/normal/large/huge, default: auto): controls the font size of the strength % labels and the zone text label respectively. Purely cosmetic, no effect on calculation.
• supportColor / resistanceColor / brokenColor: the fill/border colors used for support zones, resistance zones, and broken zones. Purely cosmetic.

Main Logic Blocks

🎯 Flow 1: What You See — The Top-Ranked Zone Display

• Every bar, all zones currently stored in memory are sorted from highest to lowest score (0-100 scale, see Flow 2).
• The engine walks down this sorted list and marks a zone "visible" only if it (a) passes the directionFilter and (b) is still within the first visibleLimit zones counted so far. Example: visibleLimit=8 → only the 8 highest-scoring qualifying zones get "visible=true"; the 9th best onward stays hidden even though it still exists internally.
• A visible zone is drawn as a colored box (teal for support, orange for resistance) sized to its top/bottom price band. Inside it: the top half can show a bear-strength bar sized by bearStrength%, the bottom half a bull-strength bar sized by bullStrength%, and (if enabled) a text summary such as "Strong Support".
• A hidden (ranked-out) zone is not deleted - its box is simply painted fully transparent and its text cleared, so it can silently re-appear the moment its score climbs back into the top-N.

🔧 Flow 2: How a Zone's Score and Strength % Are Calculated

• Score (0-100), recomputed every bar for every zone:
  • Five positive components are combined: zone size relative to ATR (up to 20 points), creation volume relative to average (up to 18 points), trend alignment (12 points flat if aligned), swing sharpness (up to 28 points - the single biggest factor), and touch count (up to 16 points) — plus a flat 10-point base, for a maximum raw total around 104.
  • Two penalties are then subtracted: mitigation × 22 (how much price has already filled through the zone) and an age penalty of up to 10 points as the zone approaches 450 bars old.
  • Example: a zone with a strong 1.4-ATR sharp swing (near-maximum swing score ≈ 27/28), 2× average volume (max 18/18), trend-aligned (12/12), full zone width (20/20), 2 touches (8/16) and base 10, and no mitigation/age penalty yet, scores roughly 27+18+12+20+8+10 = 95/100 - a very high-conviction zone.
• Bull%/Bear% strength, derived from the score:
  • The raw score is reshaped through a curve that stretches high scores (≥75) toward 100% and compresses low scores, then a trend-alignment bonus (+6) is added and a mitigation penalty (up to -28) is subtracted, giving the "zone-side" percentage (the strength on the zone's own side - bull for support, bear for resistance).
  • The opposite side's percentage starts from a small 5% floor and rises mainly with mitigation (up to +65 as the zone gets filled through) plus a small score contribution - representing how much the "wrong side" of the trade is gaining ground as the zone weakens.
  • Example: a support zone (dir=-1) with score=95, trendScore=1, mitigation=0 → zoneSide ≈ 72+(95-75)×1.12 = 94.4, +6 trend bonus, capped at 100 → bullStrength=100%; oppositeSide ≈ 5+0+95×0.08=12.6% → bearStrength=12%. If the same zone later gets 80% mitigated, bullStrength drops sharply (mitigation penalty -22.4) while bearStrength jumps toward 5+52+7.6≈64%.
• Zone text label, derived from mitigation and the zone-side strength: "Mitigated" if mitigation ≥ 0.75, else "Strong" if strength ≥ 70%, else plain if strength ≥ 45%, otherwise "Weak".

🌱 Flow 3: How a Zone Is Born — Pivot Detection & Absorption

• Step 1 - Detect a raw pivot: ta.pivothigh/ta.pivotlow confirm a swing high/low once pivotSpan bars have closed on both sides. Because confirmation needs future bars, the pivot's actual bar is always pivotSpan bars in the past by the time it's processed.
• Step 2 - Filter weak pivots: the pivot's "swing quality" (how far it sticks out above/below its immediate neighbors, in ATR) must be ≥ minSwingAtr, otherwise it's discarded and no zone is created.
• Step 3 - Build the candidate zone: a price band is built around the pivot price (± half of zoneAtrWidth×ATR), and its volume score, trend score, swing score, and initial score are all computed as in Flow 2.
• Step 4 - Absorb or create: the candidate is compared against every existing zone on the same side (support vs. support, resistance vs. resistance). If it's close enough (midpoints within absorbAtr×ATR) or overlaps it by at least 35% of the smaller zone's width, it is merged into that existing zone: the zone widens to cover both, its mitigation resets to 0 (a fresh retest "heals" the zone), its touch count rises by 1, and its score gets the better of the two scores plus a +3 reconfirmation bonus. If no match is found, a brand-new zone is created instead and pushed into the active zone list.

🔄 Flow 4: How a Zone Lives and Dies — Touch, Mitigation, Break, Expiry

• Touch & mitigation: every bar, if the current candle's range overlaps a zone's price band, that zone's touch count nudges up by 0.20 and its mitigation ratio is recalculated as how far price has pushed through the zone from the outer edge (0 = just tagged the edge, 1 = pushed all the way through to the far side). Crossing the 0.75 mitigation threshold for the first time fires a "Mitigated" alert.
• Break: a support zone is broken once close falls below its bottom edge by more than breakAtr×ATR (a resistance zone breaks the mirrored way, above its top). A broken zone is flagged, its box turns gray and its centerline becomes a visible dotted marker frozen at the break point, its bull/bear bars and text are cleared, and it is moved out of the active zone list into a small "recently broken" buffer capped at keepBrokenCount zones (oldest deleted first).
• Expiry: regardless of score or touches, a zone is silently deleted once it is older than 450 bars since its (last-merged) creation bar - old, stale zones eventually clear themselves out even without being broken.
• Pruning by storage limit: after re-ranking, if the total number of active zones exceeds storedLimit, the lowest-scoring zones are deleted one by one until the count is back within the limit.

🔔 Flow 5: Alerts

• Creation: "Support Created" / "Resistance Created" fire the instant a brand-new (non-absorbed) zone is added.
• Top-rank: "Top-Ranked Support/Resistance Created" and "New Top-Ranked S/R Zone" fire whenever the #1 zone by score changes identity (a new zone takes over as the single most important level on the chart).
• Touch/Mitigation: "Support/Resistance Mitigation Started" fires on any touch; "Support/Resistance Mitigated" fires the moment mitigation first crosses 75%.
• Break: "Support Broken" / "Resistance Broken" fire when a zone is invalidated by close, as described in Flow 4.

Outputs & Usage Roles

• Top-ranked zone boxes: the primary output - the current best S/R levels to react to, already filtered and ranked so you don't have to judge zone quality yourself.
• Bull%/Bear% strength bars: a quick visual read of how strongly each zone currently favors buyers vs. sellers, useful for grading entry conviction.
• Zone text label: a plain-language summary ("Strong Support" → "Mitigated Support") of how much a zone has been worn down, useful as an at-a-glance early-warning system.
• Broken zone markers: a short visual memory of recently invalidated levels, useful for spotting support/resistance role-reversal (old resistance becoming new support, and vice versa).
• Alerts: let the 12 events above be monitored without watching the chart live.