docs: document v4+ features (filters, gating, per-timeframe profiles) and Pine v6

This commit is contained in:
root
2025-10-17 10:21:56 +02:00
parent ab2c1c5e9b
commit 1b2f033fa3

View File

@@ -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 v1s 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., 100200)
- 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)
- 14h
- 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.