Input schema (JSON)
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"exit"
],
"properties": {
"exit": {
"type": "object",
"required": [
"stopLossPercentage",
"takeProfitPercentage",
"partialExitsAt",
"trail",
"breakevenAfterMinutes",
"maxHoldMinutes",
"signalExit"
],
"properties": {
"trail": {
"anyOf": [
{
"type": "array",
"items": {
"type": "number"
},
"maxItems": 2,
"minItems": 2
},
{
"type": "null"
}
],
"description": "Trail config: [fire, extend]. Null disables. extend > 0 chains (re-arm after each bump); extend = 0 locks SL at the fire price once then clears. fire = fraction of current TP distance (0–1 exclusive); extend = TP multiplier add-on (0 = fire-price lock one-shot)."
},
"signalExit": {
"anyOf": [
{
"type": "object",
"required": [
"long",
"short"
],
"properties": {
"long": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"left",
"op",
"right"
],
"properties": {
"op": {
"enum": [
"gt",
"lt",
"gte",
"lte",
"crosses_above",
"crosses_below"
],
"type": "string",
"description": "Comparison operator. crosses_above/crosses_below require previous bar context."
},
"kind": {
"type": "string",
"const": "comparison"
},
"left": {
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/1/properties/source"
},
"right": {
"$ref": "#/properties/exit/properties/signalExit/anyOf/0/properties/long/items/anyOf/0/properties/left"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"startUtc",
"endUtc",
"timeframeMinutes"
],
"properties": {
"kind": {
"type": "string",
"const": "time_window"
},
"endUtc": {
"$ref": "#/properties/exit/properties/signalExit/anyOf/0/properties/long/items/anyOf/1/properties/startUtc",
"description": "Window end, exclusive. Earlier than startUtc = overnight window (e.g. \"02:00\" with start \"22:00\"). Equal to startUtc = always in window."
},
"startUtc": {
"type": "string",
"description": "Window start, inclusive (e.g. \"09:30\" for the New York killzone open)."
},
"timeframeMinutes": {
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/1/properties/source/anyOf/0/properties/timeframeMinutes",
"description": "Chart timeframe whose latest closed bar provides the clock. Use 5 or 15 for killzone precision."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"days",
"timeframeMinutes"
],
"properties": {
"days": {
"type": "array",
"items": {
"enum": [
"sun",
"mon",
"tue",
"wed",
"thu",
"fri",
"sat"
],
"type": "string"
},
"maxItems": 7,
"minItems": 1,
"description": "Allowed UTC weekdays (e.g. omit \"fri\" to skip Friday)."
},
"kind": {
"type": "string",
"const": "day_of_week"
},
"timeframeMinutes": {
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/1/properties/source/anyOf/0/properties/timeframeMinutes",
"description": "Chart timeframe whose latest closed bar provides the clock. Use 5 or 15 for precision."
}
},
"additionalProperties": false
}
]
}
},
"short": {
"type": "array",
"items": {
"$ref": "#/properties/exit/properties/signalExit/anyOf/0/properties/long/items"
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Optional indicator-based exit: closes the position at market when these conditions fire (evaluated on the same cadence as entries). Same condition shape as entry blocks. Use for mean-reversion targets (e.g. close crosses VWAP) or thesis-invalidation exits instead of relying only on fixed TP. Null disables."
},
"maxHoldMinutes": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Hard TTL: force close at market after this many minutes regardless of PnL. Null disables."
},
"partialExitsAt": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"pricePercentage",
"exitAmountFraction"
],
"properties": {
"pricePercentage": {
"type": "number",
"description": "Signed decimal move from entry (-1 to 1). Percent as fraction: -0.005 = -0.5%, 0.03 = +3%. Not the 0–100 scale used by stopLossPercentage.",
"exclusiveMaximum": 1,
"exclusiveMinimum": -1
},
"exitAmountFraction": {
"type": "number",
"description": "Fraction of the remaining position to liquidate when this level is hit",
"exclusiveMaximum": 1,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}
},
{
"type": "null"
}
],
"description": "Ladder of partial exits. Null means no partial exits."
},
"stopLossPercentage": {
"anyOf": [
{
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Fixed stop/TP distance on the 0–100 scale (original shape)."
},
{
"type": "object",
"required": [
"source",
"op",
"value",
"minPercentage",
"maxPercentage",
"fallbackPercentage"
],
"properties": {
"op": {
"enum": [
"multiply",
"add"
],
"type": "string",
"description": "multiply = resolved(source) × value; add = resolved(source) + value."
},
"value": {
"type": "number",
"description": "Multiplier or addend applied after resolving source."
},
"source": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"field",
"timeframeMinutes",
"lookback"
],
"properties": {
"kind": {
"type": "string",
"const": "price"
},
"field": {
"enum": [
"open",
"high",
"low",
"close"
],
"type": "string",
"description": "Bar field: open, high, low, or close (default close). Ignored at `lookback: 0` (live ticker). At `lookback >= 1` returns this OHLC field of bar N back — enables wick/rejection patterns (e.g. high pierced a level then close reclaimed)."
},
"lookback": {
"type": "integer",
"maximum": 20,
"minimum": 0,
"description": "How many bars back to look. 0 = latest bar, 1 = one bar ago, etc. Max 20."
},
"timeframeMinutes": {
"type": "integer",
"description": "Chart timeframe (5, 15, 60, 240, or 1440 minutes) the lookback resolves against. `lookback: 0` returns the live ticker price (timeframe-independent); `lookback >= 1` returns the chosen `field` of bar N back on this timeframe."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"value"
],
"properties": {
"kind": {
"type": "string",
"const": "constant"
},
"value": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"name",
"field",
"timeframeMinutes",
"lookback",
"params"
],
"properties": {
"kind": {
"type": "string",
"const": "indicator"
},
"name": {
"type": "string",
"description": "Indicator name. One of: SMA20, SMA50, EMA, RSI, ADX, MACD, BBANDS, ATR, ATR_PCT, VWAP, OBV, OBV_CHANGE, LAST_DAY_HIGH, LAST_DAY_LOW, LAST_WEEK_HIGH, LAST_WEEK_LOW, SWING_HIGH, SWING_LOW, BOS, CHOCH, DISPLACEMENT, VOLUME_PROFILE, DEALING_RANGE."
},
"field": {
"enum": [
"value",
"signal",
"histogram",
"upper",
"middle",
"lower",
"poc",
"vah",
"val",
"equilibrium",
"premium_pct"
],
"type": "string",
"description": "Sub-field for composite indicators: MACD uses signal/histogram, BBANDS uses upper/middle/lower, VOLUME_PROFILE uses poc/vah/val, DEALING_RANGE uses equilibrium/premium_pct. Use value for scalar indicators."
},
"params": {
"type": "object",
"required": [
"wing",
"atrMult",
"lookbackBars"
],
"properties": {
"wing": {
"anyOf": [
{
"type": "integer",
"maximum": 10,
"minimum": 1
},
{
"type": "null"
}
],
"description": "Pivot wing for SWING_HIGH/SWING_LOW/BOS/CHOCH/DEALING_RANGE: bars required on each side to confirm a pivot. Default 3. Smaller (1–2) = short-term structure, larger (4–10) = major swings only."
},
"atrMult": {
"anyOf": [
{
"type": "number",
"maximum": 5,
"minimum": 0.5
},
{
"type": "null"
}
],
"description": "ATR(14) multiplier for DISPLACEMENT: bar range must exceed atrMult × ATR to count as displacement. Default 1.5."
},
"lookbackBars": {
"anyOf": [
{
"type": "integer",
"maximum": 100,
"minimum": 10
},
{
"type": "null"
}
],
"description": "Rolling window length for VOLUME_PROFILE (bars ending at the current closed bar). Default 48. Must fit the entry-rules indicator window (≤100)."
}
},
"description": "Optional indicator parameters (e.g. swing pivot wing, VOLUME_PROFILE lookbackBars). Empty object = defaults.",
"additionalProperties": false
},
"lookback": {
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/1/properties/source/anyOf/0/properties/lookback"
},
"timeframeMinutes": {
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/1/properties/source/anyOf/0/properties/timeframeMinutes",
"description": "Chart timeframe: 5, 15, 60, 240 (4h), or 1440 (daily) minutes."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"zoneType",
"state",
"field",
"timeframeMinutes",
"lookback"
],
"properties": {
"kind": {
"type": "string",
"const": "zone"
},
"field": {
"enum": [
"top",
"bottom",
"mid"
],
"type": "string",
"description": "Zone price level: top or bottom edge, or mid (midpoint — the FVG 'consequent encroachment'). Default mid."
},
"state": {
"enum": [
"open",
"tapped",
"mitigated"
],
"type": "string",
"description": "Which zones to consider: open = untouched, tapped = wick entered but no close through, mitigated = closed beyond the far edge. Default open."
},
"lookback": {
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/1/properties/source/anyOf/0/properties/lookback"
},
"zoneType": {
"enum": [
"fvg_bull",
"fvg_bear",
"ob_bull",
"ob_bear"
],
"type": "string",
"description": "fvg_bull/fvg_bear = 3-candle fair value gap (imbalance). ob_bull/ob_bear = last opposite-close candle before a displacement bar (order block)."
},
"timeframeMinutes": {
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/1/properties/source/anyOf/0/properties/timeframeMinutes",
"description": "Chart timeframe the zone detection runs on: 5, 15, 60, 240 (4h), or 1440 (daily) minutes."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"fn",
"a",
"b"
],
"properties": {
"a": {
"anyOf": [
{
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/1/properties/source/anyOf/0"
},
{
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/1/properties/source/anyOf/1"
},
{
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/1/properties/source/anyOf/2"
},
{
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/1/properties/source/anyOf/3"
}
],
"description": "First input — a primitive operand (price, indicator, or constant). No nesting."
},
"b": {
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/1/properties/source/anyOf/4/properties/a",
"description": "Second input — a primitive operand (price, indicator, or constant). No nesting."
},
"fn": {
"enum": [
"spread",
"ratio",
"abs_distance_pct"
],
"type": "string",
"description": "spread = a - b (same units as inputs). ratio = a / b (fails when b is 0). abs_distance_pct = |a - b| / |b| * 100 (percent points — same scale as ATR_PCT and SL/TP)."
},
"kind": {
"type": "string",
"const": "derived"
}
},
"additionalProperties": false
}
],
"description": "Operand resolved at rule-fire time (latest fully closed bar). Any indicator, price field, or derived expression."
},
"maxPercentage": {
"anyOf": [
{
"type": "number",
"maximum": 100,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Ceiling on the resolved 0–100 distance after op. Null disables."
},
"minPercentage": {
"anyOf": [
{
"type": "number",
"maximum": 100,
"minimum": 0
},
{
"type": "null"
}
],
"description": "Floor on the resolved 0–100 distance after op. Null disables."
},
"fallbackPercentage": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Fixed 0–100 distance used when source resolves null (indicator warmup)."
}
},
"additionalProperties": false
}
],
"description": "Stop-loss distance from entry on the 0–100 scale, or a dynamic expression resolved at fire time. 0 disables SL."
},
"takeProfitPercentage": {
"anyOf": [
{
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/0"
},
{
"$ref": "#/properties/exit/properties/stopLossPercentage/anyOf/1"
}
],
"description": "Take-profit distance from entry on the 0–100 scale, or a dynamic expression resolved at fire time."
},
"breakevenAfterMinutes": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Soft TTL: minutes after open at which the engine intervenes. If the trade is in profit, it closes at market to lock in the gain. If underwater, SL moves to break-even. Null disables."
}
},
"description": "Full replace of rules.exit (not a merge). Every key required — null disables: stopLossPercentage + takeProfitPercentage = 0–100 number OR {source,op,value,fallbackPercentage,minPercentage,maxPercentage}; partialExitsAt = [{pricePercentage, exitAmountFraction}] | null (pricePercentage is a decimal fraction: 0.03 = +3%, NOT the 0–100 SL/TP scale); trail = [fire, extend] | null (fire in (0,1), extend >= 0; NOT {fire,extend}); breakevenAfterMinutes + maxHoldMinutes = number | null; signalExit = {long, short} condition arrays | null. Cooldown lives on the rules root (op=patch_cooldown), not here.",
"additionalProperties": false
},
"strategy_id": {
"type": "string",
"minLength": 1,
"description": "Strategy id. Prefer always: routes to that Lab tab, and NO_ACTIVE_LAB errors include a direct Lab URL to open."
}
},
"additionalProperties": false
}