Donchian Turtle Breakout Script

The download and this preview resolve to the same reviewed file. SHA-256: 2ec52dfdd0a6cfe7e831d85df1caf287ba7b81894752ad0481889c7651da7064

-- SPDX-License-Identifier: MIT
-- IQOptionWiki QCS Library
-- IQOW Donchian Turtle Breakout v1.0.0
--
-- A simplified Turtle-style channel breakout: price closing beyond the
-- highest high or lowest low of the previous N candles, accepted only when
-- volatility is expanding (ATR above its own longer average).
--
-- HIGHER: close is above the previous 20-candle high and ATR(14) is above
--         the SMA(50) of ATR.
-- LOWER:  close is below the previous 20-candle low and ATR(14) is above
--         the SMA(50) of ATR.
--
-- Markers use the previous completed candle: they appear after the next candle
-- opens and are shifted back one bar onto the candle that qualified.
-- Educational chart tool only. It does not place trades, choose an expiry,
-- predict outcomes, or guarantee results. Test on a Practice balance first.

instrument {
    name = "IQOW Donchian Turtle Breakout",
    short_name = "IQOW TURTLE",
    overlay = true
}

input_group {
    "1. Breakout channel",
    channel_period = input (20, "Breakout period", input.integer, 2, 200)
}

input_group {
    "2. Volatility filter",
    atr_period = input (14, "ATR period", input.integer, 2, 100),
    atr_average_period = input (50, "ATR average period", input.integer, 2, 300)
}

input_group {
    "Display and advice",
    channel_visible = input { default = true, type = input.plot_visibility },
    signals_visible = input { default = true, type = input.plot_visibility },
    advice_enabled = input { default = false, name = "Enable platform advice", type = input.boolean }
}

input_group {
    "Colors",
    upper_color = input { default = "#25E154", type = input.color },
    lower_color_line = input { default = "#FF6C58", type = input.color },
    channel_width = input { default = 1, type = input.line_width },
    higher_color = input { default = "#25E154", type = input.color },
    lower_color = input { default = "#FF6C58", type = input.color },
    signal_text_color = input { default = "#FFFFFF", type = input.color }
}

-- Previous N candles only: the current candle is excluded so a breakout is
-- a close beyond the range that already existed.
prior_high = highest (high, channel_period) [1]
prior_low = lowest (low, channel_period) [1]

atr_value = rma (tr, atr_period)
atr_average = sma (atr_value, atr_average_period)

local prior_high_now = get_value (prior_high, nil)
local prior_low_now = get_value (prior_low, nil)
local atr_now = get_value (atr_value, nil)
local atr_average_now = get_value (atr_average, nil)
local close_now = get_value (close, nil)

local data_is_ready =
    prior_high_now ~= nil and
    prior_low_now ~= nil and
    atr_now ~= nil and
    atr_average_now ~= nil and
    close_now ~= nil

-- Volatility expansion: ATR above its own average.
local volatility_is_expanding = data_is_ready and atr_now > atr_average_now

higher_setup = conditional (volatility_is_expanding and close_now > prior_high_now)
lower_setup = conditional (volatility_is_expanding and close_now < prior_low_now)

-- Confirm only a new setup on the previous completed candle.
confirmed_higher = conditional (
    get_value (higher_setup [1], false) and
    not get_value (higher_setup [2], false)
)

confirmed_lower = conditional (
    get_value (lower_setup [1], false) and
    not get_value (lower_setup [2], false)
)

if channel_visible then
    plot (prior_high, "Previous high", upper_color, channel_width)
    plot (prior_low, "Previous low", lower_color_line, channel_width)
end

if signals_visible then
    plot_shape (
        confirmed_higher,
        "Turtle HIGHER",
        shape_style.triangleup,
        shape_size.small,
        higher_color,
        shape_location.belowbar,
        -1,
        "HIGHER",
        signal_text_color
    )

    plot_shape (
        confirmed_lower,
        "Turtle LOWER",
        shape_style.triangledown,
        shape_size.small,
        lower_color,
        shape_location.abovebar,
        -1,
        "LOWER",
        signal_text_color
    )
end

-- QCS advice is a platform notification state only; it does not place trades.
if advice_enabled and
    get_value (confirmed_higher, false) and
    not get_value (confirmed_lower, false) then
    advise (advice.buy)
elseif advice_enabled and
    get_value (confirmed_lower, false) and
    not get_value (confirmed_higher, false) then
    advise (advice.sell)
else
    advise (advice.neutral)
end