BB1 Bollinger Script

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

-- SPDX-License-Identifier: MIT
-- IQOptionWiki QCS Library
-- IQOW BB1 Bollinger v1.0.0
--
-- BB1 is a Bollinger Bands setup with a deviation of 1 instead of the usual 2,
-- as described in the IQOptionWiki article. Price closing outside the narrow
-- band after sitting inside it marks a push away from the average.
--
-- HIGHER: this candle closes above the upper band after the previous two
--         candles closed at or below the upper band.
-- LOWER:  this candle closes below the lower band after the previous two
--         candles closed at or above the lower band.
--
-- 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 BB1 Bollinger",
    short_name = "IQOW BB1",
    overlay = true
}

input_group {
    "1. Bollinger Bands",
    bb_period = input (20, "Period", input.integer, 2, 200),
    bb_deviation = input (1, "Deviation", input.double, 0.1, 5, 0.1, false),
    quiet_candles = input (2, "Candles inside before the close", input.integer, 1, 5)
}

input_group {
    "Display and advice",
    lines_visible = input { default = true, type = input.plot_visibility },
    middle_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",
    band_color = input { default = "#56CEFF", type = input.color },
    band_fill_color = input { default = rgba(86, 206, 255, 0.06), type = input.color },
    middle_color = input { default = rgba(255, 255, 255, 0.35), type = input.color },
    line_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 }
}

-- Bollinger Bands: SMA of close plus and minus deviation times stdev.
middle_band = sma (close, bb_period)
band_offset = stdev (close, bb_period) * bb_deviation
upper_band = middle_band + band_offset
lower_band = middle_band - band_offset

local close_now = get_value (close, nil)
local upper_now = get_value (upper_band, nil)
local lower_now = get_value (lower_band, nil)

local data_is_ready = close_now ~= nil and upper_now ~= nil and lower_now ~= nil

-- The earlier candles must have closed on the inner side of the band.
local was_inside_upper = data_is_ready
local was_inside_lower = data_is_ready
for back = 1, quiet_candles do
    local past_close = get_value (close [back], nil)
    local past_upper = get_value (upper_band [back], nil)
    local past_lower = get_value (lower_band [back], nil)
    if past_close == nil or past_upper == nil or past_lower == nil then
        was_inside_upper = false
        was_inside_lower = false
    else
        was_inside_upper = was_inside_upper and past_close <= past_upper
        was_inside_lower = was_inside_lower and past_close >= past_lower
    end
end

higher_setup = conditional (data_is_ready and close_now > upper_now and was_inside_upper)
lower_setup = conditional (data_is_ready and close_now < lower_now and was_inside_lower)

-- 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 lines_visible then
    fill (upper_band, lower_band, "Bollinger area", band_fill_color)
    plot (upper_band, "Upper band", band_color, line_width)
    plot (lower_band, "Lower band", band_color, line_width)
end

if middle_visible then
    plot (middle_band, "Middle band (SMA)", middle_color, 1)
end

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

    plot_shape (
        confirmed_lower,
        "BB1 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