diff --git a/README.md b/README.md index 37cbd95..88a1b1e 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,15 @@ # 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 - `Bullmania_Money_Line_v1.pine` — Baseline behavior (original). Two inputs: ATR Period, Multiplier. - `Bullmania_Money_Line_v2.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_plus.pine` — v4-compatible but with optional filters and quality-of-life features (Pine v6). ## How it works (all versions) - 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. +### 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 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. ## 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`. - v1 — Initial baseline.