Script headers

Every script starts with a header: a kind, a title in quotes and, optionally, a block of settings, one key = value per line.

QuaScriptengine result

Loading the engine result…

header.qs

strategy "Trend Breakout" {
    overlay    = true
    capital    = 100000
    commission = 0.05
    sizing     = percent_equity
    size       = 20
}

quatick-charts · QuaScript engine on synthetic 1-minute bars · drag to pan · scroll to zoom · Run executes the script on the engine (⌘/Ctrl+Enter while editing)

The header must be the first statement (comments and doc comments may come before it).
A script has one header. A script without a header is an analysis.
Values are numbers, text in quotes, true / false or a name such as percent_equity.
Settings can share a line when separated by commas: analysis "RSI" { overlay = false, render = webgl }.
Unknown settings and invalid values are compile errors that name the setting and list the valid choices.

analysis

Draws on the chart. Orders are not allowed (E_ORDER_IN_ANALYSIS).

Setting	Values	Default	Meaning
`pane`	`price`, `hpane`, `vpane`	`price`	where the analysis lives: on the price pane, in an H pane of its own below it, or in V panes beside the price axis (see Panes)
`height`	0.05 .. 0.9	0.2	share of the chart taken by the H pane (`pane = hpane` only)
`width`	40 .. 600	120	default width in px of the script's V panes
`overlay`	`true`, `false`	`true`	shorthand: `false` is `pane = hpane` (set `pane` or `overlay`, not both)
`render`	`auto`, `canvas`, `webgl`, `webgpu`	`auto`	preferred renderer; `auto` lets the chart choose (backends)
`max_objects`	1 .. 2000	500	drawing objects kept per kind (the oldest are removed)
`precision`	0 .. 12	price	decimals shown for values
`format`	`price`, `percent`, `volume`, `inherit`	`price`	how values are labelled
`scale`	`right`, `left`, `none`	`right`	price scale of a separate pane
`short_title`	text		compact legend title

strategy

An analysis plus a simulated broker. Everything from analysis applies, and:

Setting	Values	Default	Meaning
`capital`	number > 0	10000	starting equity
`commission`	number >= 0	0	cost per fill, in the unit of `commission_model`
`commission_model`	`percent`, `per_contract`, `per_order`	`percent`
`slippage`	number >= 0	0	adverse price move per fill
`slippage_unit`	`ticks`, `percent`	`ticks`
`sizing`	`fixed_qty`, `fixed_cash`, `percent_equity`, `risk_percent`	`fixed_qty`	how an order without `qty` is sized
`size`	number	1 (or 100 for `percent_equity`)	quantity, cash, percent of equity, or percent of equity at risk
`max_leverage`	number 0.01 .. 100	none	caps every automatically sized order so the position value stays within this multiple of equity
`pyramiding`	1 .. 100	1	entries allowed in one direction
`fill`	`open`, `close`	`open`	market orders fill at the next bar's open, or at this bar's close
`close_end`	`true`, `false`	`false`	close the position on the last bar
`risk_free`	0 .. 1	0	annual risk-free rate for the Sharpe / Sortino ratios
`periods_per_year`	`auto` or number	`auto`	bars per year for annualised ratios

risk_percent sizes each entry so that hitting its bracket stop loses size percent of equity. A very tight stop would make that position huge; max_leverage = 1 keeps it at or below one times equity.

bot

A strategy whose orders on confirmed live bars are published as bot signals with stable, deterministic ids (the same script, bar and order always give the same id, so a signal is never executed twice). It takes the strategy settings plus:

Setting	Values	Default	Meaning
`on`	`close`, `update`	`close`	emit when a bar closes, or on every price update of the live bar
`mode`	`paper`, `live`	`paper`	where the terminal routes the signals

History is never live: a bot opened on 10,000 bars emits nothing until new bars arrive.

library

library.qs

library "smc/zones"

pub DEFAULT_ATR = 14
pub fn width(top: float, bottom: float) -> float { return top - bottom }

The title is the library's name, used by use "smc/zones". Names are lowercase snake_case and may contain up to three folder segments. A library has no settings block. See Libraries.

Appearance

Script headers

analysis

strategy

bot

library