docs: document v4+ features (filters, gating, per-timeframe profiles) and Pine v6
This commit is contained in:
31
README.md
31
README.md
@@ -1,14 +1,15 @@
|
|||||||
# Bullmania Money Line
|
# Bullmania Money Line
|
||||||
|
|
||||||
ATR-based trend line and flip signals for TradingView (Pine v5). The indicator draws a “Money Line” that trails price and flips direction when price crosses it. Green dots mark bullish flips (trend turns up), red dots mark bearish flips (trend turns down).
|
ATR-based trend line and flip signals for TradingView (Pine v6). The indicator draws a “Money Line” that trails price and flips direction when price crosses it. Green dots mark bullish flips (trend turns up), red dots mark bearish flips (trend turns down).
|
||||||
|
|
||||||
This repo contains multiple versions; v4 is the latest and adds optional noise controls while preserving v1’s defaults.
|
This repo contains multiple versions; v4 is the stable baseline and `v4+` adds optional filters, alerts, and per-timeframe profiles while preserving v4 defaults (off by default).
|
||||||
|
|
||||||
## Files
|
## Files
|
||||||
- `Bullmania_Money_Line_v1.pine` — Baseline behavior (original). Two inputs: ATR Period, Multiplier.
|
- `Bullmania_Money_Line_v1.pine` — Baseline behavior (original). Two inputs: ATR Period, Multiplier.
|
||||||
- `Bullmania_Money_Line_v2.pine` — Historical variant.
|
- `Bullmania_Money_Line_v2.pine` — Historical variant.
|
||||||
- `Bullmania_Money_Line_v3.pine` — Historical variant.
|
- `Bullmania_Money_Line_v3.pine` — Historical variant.
|
||||||
- `Bullmania_Money_Line_v4.pine` — v1 + optional noise reduction (confirmation bars, ATR buffer). Tagged `v4.0.0`.
|
- `Bullmania_Money_Line_v4.pine` — v1 + optional noise reduction (confirmation bars, ATR buffer). Tagged `v4.0.0`.
|
||||||
|
- `Bullmania_Money_Line_v4_plus.pine` — v4-compatible but with optional filters and quality-of-life features (Pine v6).
|
||||||
|
|
||||||
## How it works (all versions)
|
## How it works (all versions)
|
||||||
- Money Line is derived from a mid-price `(high + low) / 2` and `ATR(atrPeriod)` scaled by `multiplier`.
|
- Money Line is derived from a mid-price `(high + low) / 2` and `ATR(atrPeriod)` scaled by `multiplier`.
|
||||||
@@ -29,6 +30,31 @@ Additional inputs (v4 only):
|
|||||||
|
|
||||||
Defaults in v4 match v1, so you can upgrade without changing results and then enable the new knobs as needed.
|
Defaults in v4 match v1, so you can upgrade without changing results and then enable the new knobs as needed.
|
||||||
|
|
||||||
|
### v4+ extras (all optional; defaults preserve v4)
|
||||||
|
- Calculation source: Chart or Heikin Ashi
|
||||||
|
- Flip confirmation bars and Flip buffer (×ATR)
|
||||||
|
- ADX/DMI gate (length, min ADX)
|
||||||
|
- Higher timeframe confirmation (request.security with lookahead_off)
|
||||||
|
- Session/time gating and cooldown bars after flip
|
||||||
|
- EMA trend filter (e.g., 100–200)
|
||||||
|
- Anti-chop filters:
|
||||||
|
- Choppiness Index (length and max allowed)
|
||||||
|
- Retest-after-flip (window and tolerance in ATR)
|
||||||
|
- Minimum candle body fraction
|
||||||
|
- Visualization:
|
||||||
|
- Gate flip circles with filters (optional)
|
||||||
|
- Gated markers (triangles) for approved flips
|
||||||
|
- Alerts/labels on bar close only
|
||||||
|
- Price-to-line shading
|
||||||
|
|
||||||
|
### Per-timeframe profiles (v4+)
|
||||||
|
Enable "Use per-timeframe profiles" to automatically switch parameters by chart timeframe:
|
||||||
|
- Intraday (<60m)
|
||||||
|
- 1–4h
|
||||||
|
- 1D+
|
||||||
|
|
||||||
|
Each profile has its own confirm bars, ATR buffer, smoothing, ADX length/min, CHOP length/max, retest window/tolerance, min body fraction, and trend EMA. When profiles are OFF, the single global set of inputs is used.
|
||||||
|
|
||||||
## Quick presets
|
## Quick presets
|
||||||
Use these as starting points and adjust per symbol/volatility. Values are for Heikin Ashi unless noted.
|
Use these as starting points and adjust per symbol/volatility. Values are for Heikin Ashi unless noted.
|
||||||
|
|
||||||
@@ -71,6 +97,7 @@ Keep Multiplier roughly stable and fine-tune by small increments; HA candles all
|
|||||||
5) Open Inputs to adjust parameters.
|
5) Open Inputs to adjust parameters.
|
||||||
|
|
||||||
## Changelog
|
## Changelog
|
||||||
|
- v4+ — Pine v6 variant with optional ADX/MTF/session/cooldown, calc source toggle, EMA trend filter, anti-chop (CHOP, retest, min body), gated markers, and per-timeframe profiles.
|
||||||
- v4.0.0 — Adds Flip confirmation bars and Flip buffer (×ATR). Defaults keep v1 behavior. Tag: `v4.0.0`.
|
- v4.0.0 — Adds Flip confirmation bars and Flip buffer (×ATR). Defaults keep v1 behavior. Tag: `v4.0.0`.
|
||||||
- v1 — Initial baseline.
|
- v1 — Initial baseline.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user