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.
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
//@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
)
}