Adaptive Harmonic Forecast – Intelligent Cycle-Based Price Forecasting for cTrader

The Adaptive Harmonic Forecast indicator automatically identifies the dominant cyclical rhythms hidden within price data and projects them forward as a visual forecast overlay. Built on solid mathematical foundations — periodogram spectral analysis and Ordinary Least Squares regression — this tool gives you a data-driven glimpse into where price may be heading next.

Unlike static moving averages or lagging oscillators, this indicator adapts in real time by re-detecting the strongest cycles on every new bar and recalculating the entire model from scratch.

---

### HOW IT WORKS

The indicator operates in three stages:

Stage 1 — Dominant Cycle Detection (Periodogram)

Price data over the lookback window is first detrended using linear regression to remove the directional bias. A periodogram is then computed across all candidate periods (from your minimum period up to the full lookback length), measuring the spectral power at each frequency. The algorithm identifies the strongest spectral peaks — these represent the dominant cycles currently driving price oscillations. You control how many cycles to detect (1 to 10).

Stage 2 — Composite Model Fitting (Least Squares)

Once the dominant periods are identified, the indicator builds a regression model combining:
- A pair of sine and cosine components for each detected cycle (capturing both phase and amplitude)
- A linear trend component (slope + intercept)

The model coefficients are computed via OLS (Ordinary Least Squares) using full matrix algebra — transpose, multiplication, and Gauss-Jordan inversion. This produces the best-fit composite waveform that explains the historical price movement within the lookback window.

Stage 3 — Extrapolation Forecast

The fitted model is then projected forward beyond the last bar for a configurable number of bars. The forecast line is color-coded: green (bullish) segments where the projected price is rising, red (bearish) segments where it is falling. The underlying linear trend is optionally drawn as a separate line so you can distinguish the cyclical component from the directional drift.

---

### FEATURES

Adaptive Cycle Detection
No manual input of cycle lengths required. The periodogram automatically finds the strongest periodicities present in the current market data. As market conditions change, the detected cycles update accordingly.

Multi-Harmonic Composite Forecast
Up to 10 sinusoidal components are superimposed to capture complex, non-trivial price patterns — not just a single wave but a rich composite waveform that better approximates real market behavior.

Color-Coded Forecast Line
The extrapolation line uses green for projected up-moves and red for projected down-moves, making it instantly clear where the model expects directional shifts.

Reversal Dot Markers
Optional dot markers are placed at predicted turning points (peaks and troughs) in the forecast, highlighting where the model expects momentum to reverse. Peak dots use the bearish color; trough dots use the bullish color.

Trend Line Overlay
An optional linear trend line is drawn through both the historical fit and the forecast zone, allowing you to separate the underlying directional bias from the cyclical oscillations. This helps you understand whether the cycles are riding on a bullish or bearish drift.

Detected Cycles Info Panel
An on-chart table displays the detected cycle periods, so you always know which periodicities the model is currently using. This is valuable for understanding the dominant market rhythm at a glance.

---

### HOW TO USE

Trend Confirmation:
Use the linear trend component to confirm the prevailing directional bias. If the trend line slopes upward and the cyclical forecast shows a trough forming, this signals a high-probability long entry within an established uptrend.

Timing Entries and Exits:
Watch the reversal dot markers. A trough dot in the forecast suggests an upcoming bullish reversal — plan your entry. A peak dot warns of an upcoming bearish reversal — consider taking profit or tightening your stop.

Cycle Awareness:
Check the info panel to understand the current dominant periods. If the detected cycles are short (10–20 bars), the market is oscillating quickly — suitable for scalping. If cycles are long (50–100 bars), expect broader swings — more suitable for swing trading.

Combining with Other Tools:
This indicator works best when combined with support/resistance levels, volume analysis, or market structure tools. Use the harmonic forecast as a timing layer on top of your directional analysis.

---

### TIPS FOR BEST RESULTS

- Increase Fit Lookback on higher timeframes (e.g., 150–200 on H4/Daily) for more stable cycle detection.
- Reduce Fit Lookback on lower timeframes (e.g., 50–80 on M5/M15) to stay responsive to recent price action.
- Start with 3–5 sinusoids. Too many can overfit noise; too few may miss important cycles.
- Set Min Period high enough to filter out tick-level noise (10–15 is a good starting point).
- The forecast is recalculated on every new bar — it adapts, but short-term predictions are generally more reliable than long-range ones.

---

### DISCLAIMER

This indicator is a mathematical forecasting tool based on spectral analysis and regression modeling. It does not guarantee future price movements and should not be used as the sole basis for trading decisions. Market conditions can change rapidly, and cyclical patterns may break down without warning. Always use proper risk management and combine this tool with your own analysis. Past performance does not guarantee future results. Trading involves significant risk of loss.