Bollinger %B Pass Node
Bollinger Percent B — Series Input
Overview
The Bollinger %B Pass Node measures where a value sits within its Bollinger Bands, expressed as a fraction from 0 (at lower band) to 1 (at upper band). Unlike the standard %B node, it accepts any numeric series as input rather than reading closing prices from a stock source.
Values above 1 indicate the series is trading above the upper band; values below 0 indicate it is below the lower band. This makes %B useful as a normalised mean-reversion signal that is dimensionless and directly comparable across different series magnitudes.
Formula
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| period | number | 20 | Lookback window for the underlying Bollinger Bands calculation. |
Inputs & Outputs
| Slot | Direction | Type | Description |
|---|---|---|---|
| input | Input | { values, timestamps } | Any upstream numeric series |
| values | Output | (number | null)[] | %B values (typically 0–1, can exceed bounds); nulls during warm-up |
| timestamps | Output | number[] | Unix timestamps aligned to the input series |
Use Cases
Oscillator Extreme Detection
Apply %B to RSI or MACD to identify when the oscillator is at statistical extremes of its own recent range.
Mean-Reversion Entry
%B below 0 or above 1 on a normalised series signals a potential reversion to the statistical mean.
Condition Scoring
Combine %B from multiple indicators into a composite score to rank overbought/oversold conditions.
Tips & Best Practices
📊 Dimensionless
%B is scale-independent. A %B above 1.0 on a volume series has the same meaning as on a price series.
⚡ Trending Series
During a strong trend, %B can stay near 1 (or 0) for extended periods — not all readings above 1 are reversions.