MM Flow
FlowScripts

Perfected FlowScript

Trading Sessions

Trading Sessions [Perfected] is indexed as 015_trading_sessions.flowscript. The exact FlowScript is viewable here; chart observe and trading automation use the current mmflow chart/recipe signal proxy until FlowScript v2 transpilation is available.

This exact FlowScript uses the v2 source dialect. It is viewable and connected to the chart/automation proxy, but direct editor execution needs the FlowScript v2 transpiler.

Dialect

flowscript-v2

Compatibility

flowscript-v2-needs-transpile

Position

onchart

Axis

false

Size

15.7 KB

Lines

361

Native Signal Candidates

4 source-level chart marker triggers extracted from guarded FlowScript v2 blocks.

4/4 guarded

Asia Open

line 319:9

Trigger

(showShapes) && (asiaStarted)

Value

lo

Deps

asiaStarted:var, showShapes:input

London Open

line 322:9

Trigger

(showShapes) && (londonStarted)

Value

lo

Deps

londonStarted:var, showShapes:input

NY Open

line 325:9

Trigger

(showShapes) && (nyStarted)

Value

lo

Deps

nyStarted:var, showShapes:input

Sydney Open

line 328:9

Trigger

(showShapes) && (sydneyStarted)

Value

lo

Deps

showShapes:input, sydneyStarted:var

015_trading_sessions.flowscript

source path: kscripts/perfected/015_trading_sessions.flowscript · sha256:5187eeed2bf519fa1b1eb889ba43799ad2da531c78a55d4c087fb5af302931c5

hash verified
//@version=2
// Source: kiyotaka.ai/hub/kscript (original) — Perfected by kScript_Perfection_Engineer

// ============================================================================
// Trading Sessions [Perfected]
// Author: BackQuant (@BackQuant) — Perfected by kScript_Perfection_Engineer
// Tags: CORE, #sessions, #ny, #london, #asia, #sydney, #killzone
//
// Production-quality session indicator with proper static state tracking for
// Asia, London, New York, and Sydney session high/low ranges. Features
// killzone detection (London open, NY open, overlap), previous session range
// display for breakout/fade analysis, and comprehensive shape markers for
// session transitions.
//
// Research papers underpinning this design:
//  - Harris (1986), "A Transaction Data Study of Weekly and Intradaily
//    Patterns in Stock Returns": intraday seasonality and session effects.
//  - Ito & Hashimoto (2006), "Intraday Seasonality in Activities of the
//    Foreign Exchange Markets": U-shaped volume/volatility patterns and
//    overlapping session effects.
//  - Heston, Korajczyk & Sadka (2010), "Intra-day Patterns in the Cross-
//    Section of Stock Returns": first and last half-hour return effects.
//  - Cercle PPM (2025), "ICT Killzone Pro Suite and Time-Based Trading":
//    killzones are time windows where institutional liquidity creates
//    directional moves.
//  - Steidlmayer & Hawkins (2002), "Steidlmayer on Markets": Market Profile
//    Initial Balance and session range concepts.
// ============================================================================

define(
    title="Trading Sessions [Perfected]",
    position="onchart",
    axis=false
)

// ---------------------------------------------------------------------------
// User Inputs
// ---------------------------------------------------------------------------

// --- Session Hours ---
var tzOffsetH = input(name="tzOffsetH", type="number", defaultValue=0, label="Timezone Offset (hours from UTC)", constraints={min: -12, max: 14, step: 1}, group="Session Hours")
var asiaStart = input(name="asiaStart", type="number", defaultValue=0, label="Asia Start (UTC hour)", constraints={min: 0, max: 23, step: 1}, group="Session Hours")
var asiaEnd = input(name="asiaEnd", type="number", defaultValue=8, label="Asia End (UTC hour)", constraints={min: 0, max: 24, step: 1}, group="Session Hours")
var londonStart = input(name="londonStart", type="number", defaultValue=8, label="London Start (UTC hour)", constraints={min: 0, max: 23, step: 1}, group="Session Hours")
var londonEnd = input(name="londonEnd", type="number", defaultValue=16, label="London End (UTC hour)", constraints={min: 0, max: 24, step: 1}, group="Session Hours")
var nyStart = input(name="nyStart", type="number", defaultValue=13, label="NY Start (UTC hour)", constraints={min: 0, max: 23, step: 1}, group="Session Hours")
var nyEnd = input(name="nyEnd", type="number", defaultValue=21, label="NY End (UTC hour)", constraints={min: 0, max: 24, step: 1}, group="Session Hours")
var sydneyStart = input(name="sydneyStart", type="number", defaultValue=21, label="Sydney Start (UTC hour)", constraints={min: 0, max: 23, step: 1}, group="Session Hours")
var sydneyEnd = input(name="sydneyEnd", type="number", defaultValue=6, label="Sydney End (UTC hour)", constraints={min: 0, max: 24, step: 1}, group="Session Hours")

// --- Active Sessions ---
var sessions = input(name="sessions", type="select", defaultValue="All", label="Active Sessions", options=["All", "Asia", "London", "New York", "Sydney", "Asia+London", "London+NY"], group="Active Sessions")

// --- Killzones ---
var showKillzones = input(name="showKillzones", type="boolean", defaultValue=true, label="Show Killzone Highlight", group="Killzones")
var showLondonKZ = input(name="showLondonKZ", type="boolean", defaultValue=true, label="Show London Killzone", group="Killzones")
var showNYKZ = input(name="showNYKZ", type="boolean", defaultValue=true, label="Show NY Killzone", group="Killzones")
var showOverlap = input(name="showOverlap", type="boolean", defaultValue=true, label="Show London/NY Overlap", group="Killzones")
var killzoneLen = input(name="killzoneLen", type="number", defaultValue=2, label="Killzone Length (hours)", constraints={min: 1, max: 4, step: 1}, group="Killzones")

// --- Display ---
var showPrevRanges = input(name="showPrevRanges", type="boolean", defaultValue=true, label="Show Previous Session Ranges", group="Display")
var showSessionLines = input(name="showSessionLines", type="boolean", defaultValue=true, label="Show Current Session Lines", group="Display")
var showShapes = input(name="showShapes", type="boolean", defaultValue=true, label="Show Shape Markers", group="Display")
var lineWidth = input(name="lineWidth", type="number", defaultValue=1, label="Line Width", constraints={min: 1, max: 4, step: 1}, group="Display")
var shapeSize = input(name="shapeSize", type="number", defaultValue=2, label="Shape Size", constraints={min: 1, max: 4, step: 1}, group="Display")

// --- Colors ---
var asiaColor = input(name="asiaColor", type="color", defaultValue="#2962ff40", label="Asia Color", group="Colors")
var londonColor = input(name="londonColor", type="color", defaultValue="#ff6d0040", label="London Color", group="Colors")
var nyColor = input(name="nyColor", type="color", defaultValue="#d5000040", label="NY Color", group="Colors")
var sydneyColor = input(name="sydneyColor", type="color", defaultValue="#00c85340", label="Sydney Color", group="Colors")
var overlapColor = input(name="overlapColor", type="color", defaultValue="#aa00ff40", label="Overlap Color", group="Colors")
var killzoneColor = input(name="killzoneColor", type="color", defaultValue="#ffeb3b40", label="Killzone Color", group="Colors")
var neutralColor = input(name="neutralColor", type="color", defaultValue="#9e9e9e", label="Neutral Color", group="Colors")

// ---------------------------------------------------------------------------
// Data Sources & NaN Guard
// ---------------------------------------------------------------------------
timeseries bars = ohlcv(symbol=currentSymbol, exchange=currentExchange)
timeseries t = bars.time
timeseries hi = bars.high
timeseries lo = bars.low

if (isnan(t[0]) || isnan(hi[0]) || isnan(lo[0])) {
    return
}

// ---------------------------------------------------------------------------
// Time Derivation
// ---------------------------------------------------------------------------
timeseries rawH = math.floor((t / 3600000) % 24)
timeseries utcH = ((rawH + tzOffsetH) % 24 + 24) % 24

// ---------------------------------------------------------------------------
// Session Filtering
// ---------------------------------------------------------------------------
var showAsia = sessions == "All" || sessions == "Asia" || sessions == "Asia+London"
var showLondon = sessions == "All" || sessions == "Asia+London" || sessions == "London+NY" || sessions == "London"
var showNY = sessions == "All" || sessions == "London+NY" || sessions == "New York"
var showSydney = sessions == "All" || sessions == "Sydney"

// ---------------------------------------------------------------------------
// Session Detection (with wrap-around for Sydney)
// ---------------------------------------------------------------------------
var inAsia = utcH >= asiaStart && utcH < asiaEnd
var inLondon = utcH >= londonStart && utcH < londonEnd
var inNY = utcH >= nyStart && utcH < nyEnd
var inSydney = (sydneyStart > sydneyEnd) ? (utcH >= sydneyStart || utcH < sydneyEnd) : (utcH >= sydneyStart && utcH < sydneyEnd)

// ---------------------------------------------------------------------------
// Killzone Detection
// ---------------------------------------------------------------------------
var inLondonKZ = showLondonKZ && utcH >= londonStart && utcH < londonStart + killzoneLen
var inNYKZ = showNYKZ && utcH >= nyStart && utcH < nyStart + killzoneLen
var inOverlap = showOverlap && inLondon && inNY
var inAnyKillzone = inLondonKZ || inNYKZ || inOverlap

// ---------------------------------------------------------------------------
// Session State Tracking (static variables)
// ---------------------------------------------------------------------------
static asiaHi = -1.0
static asiaLo = -1.0
static asiaActive = false
static prevAsiaActive = false
static prevAsiaHi = -1.0
static prevAsiaLo = -1.0

static londonHi = -1.0
static londonLo = -1.0
static londonActive = false
static prevLondonActive = false
static prevLondonHi = -1.0
static prevLondonLo = -1.0

static nyHi = -1.0
static nyLo = -1.0
static nyActive = false
static prevNYActive = false
static prevNyHi = -1.0
static prevNyLo = -1.0

static sydneyHi = -1.0
static sydneyLo = -1.0
static sydneyActive = false
static prevSydneyActive = false
static prevSydneyHi = -1.0
static prevSydneyLo = -1.0

// Asia session
if (inAsia) {
    if (!asiaActive) {
        asiaHi = hi[0]
        asiaLo = lo[0]
    } else {
        if (hi[0] > asiaHi) asiaHi = hi[0]
        if (lo[0] < asiaLo) asiaLo = lo[0]
    }
    asiaActive = true
} else {
    if (asiaActive) {
        prevAsiaHi = asiaHi
        prevAsiaLo = asiaLo
    }
    asiaActive = false
}

// London session
if (inLondon) {
    if (!londonActive) {
        londonHi = hi[0]
        londonLo = lo[0]
    } else {
        if (hi[0] > londonHi) londonHi = hi[0]
        if (lo[0] < londonLo) londonLo = lo[0]
    }
    londonActive = true
} else {
    if (londonActive) {
        prevLondonHi = londonHi
        prevLondonLo = londonLo
    }
    londonActive = false
}

// NY session
if (inNY) {
    if (!nyActive) {
        nyHi = hi[0]
        nyLo = lo[0]
    } else {
        if (hi[0] > nyHi) nyHi = hi[0]
        if (lo[0] < nyLo) nyLo = lo[0]
    }
    nyActive = true
} else {
    if (nyActive) {
        prevNyHi = nyHi
        prevNyLo = nyLo
    }
    nyActive = false
}

// Sydney session
if (inSydney) {
    if (!sydneyActive) {
        sydneyHi = hi[0]
        sydneyLo = lo[0]
    } else {
        if (hi[0] > sydneyHi) sydneyHi = hi[0]
        if (lo[0] < sydneyLo) sydneyLo = lo[0]
    }
    sydneyActive = true
} else {
    if (sydneyActive) {
        prevSydneyHi = sydneyHi
        prevSydneyLo = sydneyLo
    }
    sydneyActive = false
}

// ---------------------------------------------------------------------------
// Session Start/End Detection
// ---------------------------------------------------------------------------
var asiaStarted = inAsia && !prevAsiaActive
var londonStarted = inLondon && !prevLondonActive
var nyStarted = inNY && !prevNYActive
var sydneyStarted = inSydney && !prevSydneyActive

// Update prev states for next bar
prevAsiaActive = asiaActive
prevLondonActive = londonActive
prevNYActive = nyActive
prevSydneyActive = sydneyActive

// ---------------------------------------------------------------------------
// Plotting
// ---------------------------------------------------------------------------

// --- Killzone Highlight ---
if (showKillzones && inAnyKillzone) {
    var kzColor = inOverlap ? overlapColor : (inLondonKZ ? londonColor : nyColor)
    plotLine(
        value=hi,
        width=3,
        colors=[opacity(kzColor, 15)],
        label=["Killzone"],
        desc=["Killzone active period"]
    )
}

// --- Previous Session Ranges (filled boxes) ---
if (showPrevRanges) {
    if (showAsia && prevAsiaHi > 0 && prevAsiaLo > 0) {
        plotLine(
            value=([prevAsiaLo, prevAsiaHi]),
            width=1,
            colors=[opacity(asiaColor, 20)],
            fill=true,
            label=["Asia Range"],
            desc=["Previous Asia session high/low range"]
        )
    }
    if (showLondon && prevLondonHi > 0 && prevLondonLo > 0) {
        plotLine(
            value=([prevLondonLo, prevLondonHi]),
            width=1,
            colors=[opacity(londonColor, 20)],
            fill=true,
            label=["London Range"],
            desc=["Previous London session high/low range"]
        )
    }
    if (showNY && prevNyHi > 0 && prevNyLo > 0) {
        plotLine(
            value=([prevNyLo, prevNyHi]),
            width=1,
            colors=[opacity(nyColor, 20)],
            fill=true,
            label=["NY Range"],
            desc=["Previous NY session high/low range"]
        )
    }
    if (showSydney && prevSydneyHi > 0 && prevSydneyLo > 0) {
        plotLine(
            value=([prevSydneyLo, prevSydneyHi]),
            width=1,
            colors=[opacity(sydneyColor, 20)],
            fill=true,
            label=["Sydney Range"],
            desc=["Previous Sydney session high/low range"]
        )
    }
}

// --- Current Session Lines ---
if (showSessionLines) {
    if (showAsia && asiaActive) {
        plotLine(value=asiaHi, width=lineWidth, colors=[asiaColor], label=["Asia High"], desc=["Asia session running high"])
        plotLine(value=asiaLo, width=lineWidth, colors=[asiaColor], label=["Asia Low"], desc=["Asia session running low"])
    }
    if (showLondon && londonActive) {
        plotLine(value=londonHi, width=lineWidth, colors=[londonColor], label=["London High"], desc=["London session running high"])
        plotLine(value=londonLo, width=lineWidth, colors=[londonColor], label=["London Low"], desc=["London session running low"])
    }
    if (showNY && nyActive) {
        plotLine(value=nyHi, width=lineWidth, colors=[nyColor], label=["NY High"], desc=["NY session running high"])
        plotLine(value=nyLo, width=lineWidth, colors=[nyColor], label=["NY Low"], desc=["NY session running low"])
    }
    if (showSydney && sydneyActive) {
        plotLine(value=sydneyHi, width=lineWidth, colors=[sydneyColor], label=["Sydney High"], desc=["Sydney session running high"])
        plotLine(value=sydneyLo, width=lineWidth, colors=[sydneyColor], label=["Sydney Low"], desc=["Sydney session running low"])
    }
}

// --- Shape Markers (Session starts) ---
if (showShapes) {
    if (asiaStarted) {
        plotShape(value=lo, shape="triangleup", colorIndex=asiaColor, width=shapeSize, label=["Asia Open"], desc=["Asia session opened"])
    }
    if (londonStarted) {
        plotShape(value=lo, shape="triangleup", colorIndex=londonColor, width=shapeSize, label=["London Open"], desc=["London session opened"])
    }
    if (nyStarted) {
        plotShape(value=lo, shape="triangleup", colorIndex=nyColor, width=shapeSize, label=["NY Open"], desc=["NY session opened"])
    }
    if (sydneyStarted) {
        plotShape(value=lo, shape="triangleup", colorIndex=sydneyColor, width=shapeSize, label=["Sydney Open"], desc=["Sydney session opened"])
    }
}

// ---------------------------------------------------------------------------
// Session Table (last bar only)
// ---------------------------------------------------------------------------
if (isLastBar) {
    var activeSession = asiaActive ? "Asia" : (londonActive ? "London" : (nyActive ? "NY" : (sydneyActive ? "Sydney" : "None")))
    var activeColor = asiaActive ? asiaColor : (londonActive ? londonColor : (nyActive ? nyColor : (sydneyActive ? sydneyColor : neutralColor)))

    plotTable(
        data=[
            ["Trading Sessions", activeSession],
            ["Asia Range", (prevAsiaHi > 0 ? prevAsiaHi : 0) + " / " + (prevAsiaLo > 0 ? prevAsiaLo : 0)],
            ["London Range", (prevLondonHi > 0 ? prevLondonHi : 0) + " / " + (prevLondonLo > 0 ? prevLondonLo : 0)],
            ["NY Range", (prevNyHi > 0 ? prevNyHi : 0) + " / " + (prevNyLo > 0 ? prevNyLo : 0)],
            ["Sydney Range", (prevSydneyHi > 0 ? prevSydneyHi : 0) + " / " + (prevSydneyLo > 0 ? prevSydneyLo : 0)],
            ["Killzone", inAnyKillzone ? "ACTIVE" : "Inactive"]
        ],
        position="top_right",
        headerRow=true,
        headerColumn=true,
        textColor="#e2e8f0",
        headerTextColor="#ffffff",
        backgroundColor=transparency("#0f172a", 40),
        headerBackgroundColor=transparency("#1e293b", 40),
        borderColor=transparency("#334155", 40),
        borderWidth=1,
        fontSize=10,
        cellPadding=4
    )
}