Blueprint Node Reference

Risk notice: Blueprint nodes can generate automated trading actions, but a node combination does not guarantee profit. Before live trading, backtest first, then validate with paper trading or small size. Do not enable withdrawal permission on exchange API keys.

1. How Blueprints Work

A blueprint is an event-driven strategy flowchart. An executable blueprint usually contains these node groups:

Event nodes: Decide when the strategy runs, such as startup, each candle, each Tick, a timer, or an order receipt.
Market nodes: Read the current mounted symbol, candles, latest price, order book, account, and position.
Indicator nodes: Calculate technical indicators from candles or numeric series.
Signal/logic nodes: Convert indicators and prices into boolean conditions for entry, exit, or chart output.
Risk nodes: Add rate limits, kill switches, minimum quantity checks, maximum position limits, cooldowns, stop loss, and take profit rules.
Order/function nodes: Generate entry, exit, close, cancel, and strategy exit rule actions.
State nodes: Store variables, maintain counters, persist state, and detect signal changes.
Tool nodes: Run expressions, cast types, calculate arithmetic, normalize values, and round precision.
Chart nodes: Display indicator lines, horizontal lines, backgrounds, markers, tables, and order markers on the chart.

A typical strategy chain looks like this:

OnBar / OnBarClose
  -> Symbol Selector
  -> Get OHLCV
  -> Indicator nodes
  -> Signal/logic nodes
  -> Risk nodes
  -> strategy.entry / strategy.close / order nodes

If the execution timeframe is 15m but the market filter uses 1h data, configure it like this:

event.on_bar(timeframe=15m)
  -> market.symbol_selector
  -> market.get_ohlcv(timeframe=1h, limit=200)
  -> 1h indicators and filters
  -> 15m execution chain

2. Ports, Connections, and Parameters

Each node consists of input ports, output ports, and parameters.

Concept	Description
Input port	Receives events or data. If not connected, some nodes use parameter defaults.
Output port	Outputs events, numbers, booleans, symbols, order intents, chart references, and other values.
Parameter	Configured in the right property panel. Exposed parameters appear in the strategy parameter panel and can be changed when mounting.
`multi` input	Allows multiple connections into the same input port. Common examples:`riskInputs`, order `plot`, and `chart.plotchar.shape`.

Flow Types

Flow type	Purpose	Common scenarios
`event`	Controls execution order and side-effect triggers	`eventIn` -> order, state write, chart drawing
`data`	Passes data values	Price, indicator, boolean condition, symbol, risk intent
`ui`	Legacy visual chain type for chart/UI nodes	Current chart nodes are mostly terminal visual nodes

Value Types

Type	Meaning	Common source
`any`	Any value type	Expression inputs, dynamic labels, compatibility ports
`voidType`	Event without data	Trigger outputs from event nodes
`number` / `integer` / `doubleType`	Number, integer, double	Indicators, price calculations, counters
`boolType`	Boolean condition	Compare, AND/OR, signal nodes
`text`	Text	Labels, comments, state text
`symbol`	Trading pair	Symbol Selector
`timeframe`	Timeframe	Timeframe filters
`timestamp`	Time	Date filters, chart time ranges
`seriesNumber`	Numeric series	Volume and time series
`ohlcvSeries`	Candle series	Open/high/low/close from Get OHLCV
`chartVisualRef` / `chartPlotRef` / `chartHLineRef`	Chart object reference	Plot, HLine, Fill, order marker templates
`price`	Price	Last Price, Bid/Ask, Mark Price
`orderIntent`	Risk or order intent	Risk node outputs, order node inputs
`orderUpdate`	Order receipt	Order event nodes
`position` / `balance` / `account`	Position, balance, account snapshot	Account and position market nodes

Compile and Connection Rules

A blueprint must contain at least one event source node, otherwise it will not run.
Data flow must be acyclic. If data nodes form a loop, compilation fails.
If event flow forms a loop, add logic.gate for throttling, otherwise high-frequency repeated triggers may occur.
Data port types must match. If types do not match, insert tool.cast_number, tool.cast_integer, or tool.cast_bool.
A normal input port allows only one connection. Ports that support multiple connections are marked in the node definition.
Order nodes must connect eventIn; without an event trigger, they will not execute.
When a blueprint contains order nodes, connect at least one risk node to riskInputs. The compiler may warn that order nodes exist without risk nodes or that order nodes have no risk input.
market.symbol_selector outputs the symbol from the current backtest, mount, or debug context. It is suitable for reusable blueprint templates, and avoids hardcoding a symbol in the template.
market.get_ohlcv with timeframe=runtime follows the runtime timeframe. For higher-timeframe filters, explicitly select 1h, 15m, or another timeframe.

3. High-Frequency Strategy Guidelines

High-frequency or high-turnover strategies should control trigger frequency and order frequency first:

Prefer event.on_bar or event.on_bar_close as the main trigger. Use event.on_tick only when Tick-level reaction is explicitly required.
If you use event.on_tick or a short event.on_timer, add one or more of logic.gate, risk.max_order_rate, and logic.once_per_bar downstream.
If you do not want repeated entries on the same candle, use logic.once_per_bar or state.last_signal.
Avoid repeatedly requesting a large candle count at Tick level. Set market.get_ohlcv.limit based on indicator needs; 100-300 is usually enough.
Execution timeframe and decision timeframe can be separated. For example: 15m execution with 1h filtering means the event node uses 15m, while the market node uses 1h.
For live trading chains, keep risk.kill_switch, risk.order_validation, risk.max_position_size, and risk.max_order_rate connected by default.
For strategies that pause after losses, add risk.cooldown_after_loss or risk.daily_consecutive_loss_cooldown.

4. Event Nodes

Event nodes are blueprint execution entry points. Without an event node, market, indicator, logic, and order nodes will not form runtime frames.

Node ID	Name	Main inputs	Main outputs	Parameters	Purpose and notes
`event.on_start`	OnStart	None	`out` trigger	None	Triggers once when the strategy starts. Useful for initializing variables or reading the first snapshot.
`event.on_stop`	OnStop	`enabled`	`out` trigger	None	Triggers once when the strategy stops. Useful for cleanup logic. If `enabled` is not connected, it is treated as enabled by default.
`event.on_bar`	OnBar	`timeframe`	`out` trigger	`timeframe` defaults to `1m`, options: `1s/1m/5m/15m/1h`	Triggers by timeframe and is the recommended default strategy entry.
`event.on_bar_open`	OnBarOpen	`timeframe`	`out` trigger	Same as OnBar	Triggers when each candle opens. Useful for open-of-bar execution.
`event.on_bar_close`	OnBarClose	`timeframe`	`out` trigger	Same as OnBar	Triggers when each candle closes. Use confirmed candles to reduce repainting.
`event.on_tick`	OnTick	None	`out` trigger	None	Triggers on each Tick and has the highest frequency. Must be paired with throttling and risk control.
`event.on_timer`	OnTimer	`enabled`, `intervalSec`	`out` trigger	`intervalSec=60`, range 1-86400 seconds	Triggers at a fixed interval. Inputs can override parameters.
`event.on_order_update`	OnOrderUpdate	`symbol`, `side`, `status` filters	`event`, `order`	None	Triggers on order/fill receipts. Useful for updating state or adding TP/SL after a fill.
`event.on_trade_transaction`	OnTradeTransaction	`symbol`, `side`, `status` filters	`event`, `order`	None	Triggers on trade transaction updates. Useful for finer-grained order state handling.
`event.on_position_update`	OnPositionUpdate	`symbol`, `side` filters	`event`, `position`	None	Triggers on position changes. Useful for position sync and risk state updates.

5. Market Nodes

Market nodes read symbol, candles, prices, account, and position data from the current runtime context.

Node ID	Name	Main inputs	Main outputs	Parameters	Purpose and notes
`market.symbol_selector`	Symbol Selector	`eventIn`	`eventOut`, `symbol`	None	Outputs the currently mounted or backtested symbol. Do not hardcode symbol in the blueprint.
`market.get_ohlcv`	Get OHLCV	`symbol`	`series/open/high/low/close/hlc3/ohlc4/volume/time`	`limit=200`, `timeframe=runtime/1m/5m/15m/1h`	Fetches the latest N candles. Indicators usually connect to `series` or `close`; volatility indicators can use high/low/close.
`market.last_price`	Get Last Price	`symbol`	`price`	None	Reads the latest traded price. Useful for real-time conditions or chart levels.
`market.bid_ask`	Get Bid/Ask	`symbol`	`bid`, `ask`	None	Reads best bid and best ask. Useful for estimating slippage or active/passive execution.
`market.mark_price`	Get Mark Price	`symbol`	`price`	None	Reads perpetual futures mark price. Useful for futures risk checks.
`market.account_snapshot`	Get Balance/Position	`eventIn`	`eventOut`, `balance`, `position`	None	Reads account balance and position snapshot. Connect event input to control read timing.
`market.position_state`	Get Position State	`symbol`	`qty/absQty/side/entryPrice/openTimeMs/unrealizedPnl/isFlat`	None	Outputs current symbol position state. Commonly used for “enter only when flat” and “exit only when holding”.

6. Indicator Nodes

Most indicator nodes receive ohlcvSeries and output the current bar value. For multi-timeframe filters, set Get OHLCV.timeframe to the target timeframe.

Node ID	Name	Main inputs	Main outputs	Key parameters	Use cases
`indicator.sma`	SMA	`series`	`value`	`period=20`	Simple moving average for trend direction and mean-reversion baseline.
`indicator.ema`	EMA	`series`	`value`	`period=21`	Exponential moving average, faster than SMA.
`indicator.kama`	KAMA	`series`	`value/previous/slope/trend`	`erPeriod=10`, `fastPeriod=2`, `slowPeriod=30`, `slopeLookback=5`	Adaptive moving average for filtering noisy ranges.
`indicator.rsi`	RSI	`series` or high/low/close	`value`	`period=14`	Overbought/oversold, momentum divergence, pullback confirmation.
`indicator.atr`	ATR	`series` or high/low/close	`value`	`period=14`	Volatility, stop distance, low-volatility filter.
`indicator.atr_median`	ATR Median	`high/low/close`	`atr/median`	`atrPeriod=14`, `medianPeriod=50`	Checks whether current volatility is above normal.
`indicator.bb`	Bollinger Bands	`series`	`upper/middle/lower`	`period=20`	Bollinger breakout, mean reversion, bandwidth filtering.
`indicator.macd`	MACD	`series`	`macd/signal/hist`	`fastPeriod=12`, `slowPeriod=26`, `signalPeriod=9`	Trend momentum and zero-line filtering.
`indicator.donchian`	Donchian	`series`	`upper/middle/lower`	`period=20`	Range breakout and turtle-style strategies.
`indicator.candle_streak`	Candle Streak	`open/high/low/close`	`bullStreak/bearStreak/bullMoveAtr/bearMoveAtr/bodyAtr/direction`	`atrPeriod=14`, `minBodyPct=0.00005`	Consecutive bullish/bearish candles and body strength filter.
`indicator.adx`	ADX	`series` or high/low/close	`value`	`period=14`	Trend strength filter, common thresholds: 20/25.
`indicator.chop`	CHOP	`series` or high/low/close	`value`	`period=14`	Identifies trending versus choppy markets; higher values mean more range-bound.
`indicator.vwap`	VWAP	`series`	`value`	`period=20`	Volume-weighted average price for intraday deviation checks.
`indicator.stoch`	Stoch	`series`	`k/d`	`period=14`, `smoothK=3`, `smoothD=3`	Stochastic oscillator for range entries and exits.
`indicator.stoch_rsi`	Stochastic RSI	`series`	`k/d`	`period=14`, `smoothK=3`, `smoothD=3`	Stochastic applied to RSI; more sensitive signals.
`indicator.highest`	Highest N	`series`	`value`	`period=20`	Highest value over the last N candles for breakout thresholds.
`indicator.lowest`	Lowest N	`series`	`value`	`period=20`	Lowest value over the last N candles for breakdown thresholds.
`indicator.ichimoku`	Ichimoku	`series`	`conversion/base/spanA/spanB/lagging`	`conversionPeriod=9`, `basePeriod=26`, `spanBPeriod=52`, `displacement=26`	Ichimoku cloud for multi-part trend structure.
`indicator.supertrend`	Supertrend	`series`	`value/trend`	`period=10`, `multiplier=3.0`	Trend following and stop reference.
`indicator.fibonacci`	Fibonacci Retracement	`series`	`level0/236/382/500/618/786/100`	`period=100`	Fibonacci retracement levels over the recent range.
`indicator.cci`	CCI	`series`	`value`	`period=20`	Commodity Channel Index for trend and extreme readings.
`indicator.williams_r`	Williams %R	`series`	`value`	`period=14`	Overbought/oversold oscillator.
`indicator.parabolic_sar`	Parabolic SAR	`series`	`value/trend`	`afStart=0.02`, `afStep=0.02`, `afMax=0.2`	Trend reversal and trailing stop reference.
`indicator.obv`	OBV	`series`	`value`	None	On-Balance Volume for price/volume direction confirmation.
`indicator.mfi`	MFI	`series`	`value`	`period=14`	Money Flow Index, a volume-aware overbought/oversold indicator.
`indicator.volume`	Volume	`seriesNumber`	`value/average`	`period=20`	Current volume versus average volume; helps filter false breakouts.
`indicator.keltner`	Keltner Channels	`series`	`upper/middle/lower`	`emaPeriod=20`, `atrPeriod=10`, `multiplier=2.0`	ATR-based channel breakout and pullback.
`indicator.roc`	ROC	`series`	`value`	`period=12`	Rate of Change for price speed.
`indicator.momentum`	Momentum	`series`	`value`	`period=10`	Momentum oscillator.
`indicator.smoothed_momentum`	Smoothed Momentum	`series`	`momentum/value/bull/bear`	`period=10`, `smooth=3`	Smoothed momentum with direct bullish/bearish boolean outputs.
`indicator.wavetrend`	WaveTrend	`series`	`wt1/wt2/bull/bear/crossOver/crossUnder`	`channelLength=9`, `averageLength=12`, `maLength=3`, `overbought=60`, `oversold=-60`	Oscillator and crossover signals for pullback confirmation.
`indicator.aroon`	Aroon	`series`	`up/down/oscillator`	`period=25`	Measures trend strength driven by new highs/lows.
`indicator.cmf`	CMF	`series`	`value`	`period=20`	Chaikin Money Flow for inflow/outflow filtering.
`indicator.pivot_points`	Pivot Points	`series`	`pp/r1/r2/r3/s1/s2/s3`	`period=20`	Support, resistance, breakout, and pullback targets.

7. Signal and Logic Nodes

Signal nodes usually output booleans. Logic nodes combine conditions or control event flow.

Node ID	Name	Main inputs	Main outputs	Parameters	Purpose and notes
`logic.compare`	Compare	`left/right`	`result`	`operator` options: `> = true`, avoiding repeated orders while a condition stays true.
`logic.if_else`	If-Else	`eventIn/condition`	`trueOut/falseOut`	None	Splits event flow by condition.
`bool.expression`	Bool Expression	Dynamic variable inputs	`result`	`expression`, `variableCount`, variable aliases	Replaces multi-level Compare/AND/OR/NOT chains; supports `and/or/not`, `&&/
`logic.bool_expr`	Bool Expr	`a/b/c/d`	`result`	`expression`	Legacy boolean expression node with fixed variables a-d.
`logic.ternary`	Select / Ternary	Dynamic variable inputs	`result`	`expression`, variable aliases	Ternary expression such as `a ? b : c`; useful for choosing colors, numbers, or text.
`logic.select_value`	Select Value	`condition/trueValue/falseValue`	`result`	None	Selects one of two values based on a boolean condition.
`logic.gate`	Gate	`eventIn`	`eventOut`	`cooldownSec=10`	Event throttling. Important for high-frequency, Tick, and looped event flows.
`logic.once_per_bar`	Once Per Bar	`eventIn`	`eventOut`	None	Allows only one event per candle.

Expression node notes:

bool.expression, math.expression, and tool.number_expr support dynamic variable counts. variableCount ranges from 1 to 32.
Variables default to a/b/c...; use aliases such as close, emaFast, or atr to make expressions readable.
Boolean expressions are suitable for `close > ema and rsi order node riskInputs


## 9. Function Nodes and Order Nodes

Function nodes are Pine Script-style trading functions. They output `eventOut`, `triggered`, and `label`, which makes them suitable for chaining. Order nodes are terminal action nodes and are usually placed at the end of the trading chain.

### Function Nodes

| Node ID                 | Name                | Main inputs                             | Main outputs                 | Key parameters                                                                                                | Purpose and notes                                                                                                    |
| ----------------------- | ------------------- | --------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `strategy.entry`      | strategy.entry      | `eventIn/when/symbol/riskInputs/plot` | `eventOut/triggered/label` | `enabled`, `entryId`, `direction`, `orderType`, `qtyMode`, `qty`, `limitOffsetPct`, `comment` | Generates long or short entry intent when `when` is true. `entryId` is a strategy tag, not an exchange order ID. |
| `strategy.cancel`     | strategy.cancel     | `eventIn/when/riskInputs/plot`        | `eventOut/triggered/label` | `enabled`, `orderId`, `comment`                                                                         | Cancels a specified exchange order. Live cancellation usually requires the real `orderId`.                         |
| `strategy.close`      | strategy.close      | `eventIn/when/symbol/riskInputs/plot` | `eventOut/triggered/label` | `enabled`, `entryId`, `orderType`, `qtyMode`, `qty`, `limitOffsetPct`, `comment`                | Closes the current symbol position by all, quantity, or percent.                                                     |
| `strategy.cancel_all` | strategy.cancel_all | `eventIn/when/riskInputs/plot`        | `eventOut/triggered/label` | `enabled`, `comment`                                                                                      | Generates cancel-all intent when the condition is true.                                                              |
| `strategy.close_all`  | strategy.close_all  | `eventIn/when/symbol/riskInputs/plot` | `eventOut/triggered/label` | `enabled`, `orderType`, `limitOffsetPct`, `comment`                                                   | Closes all positions for the current symbol when the condition is true.                                              |
| `strategy.exit`       | strategy.exit       | `eventIn/when/symbol/riskInputs/plot` | `eventOut/triggered/label` | `exitId`, `fromEntry`, `stop`, `limit`, `profit`, `loss`, `trailPoints`, `trailOffset`        | Pine-style exit rule with stop loss, take profit, and trailing stop settings.                                        |

### Order Nodes

| Node ID                  | Name                 | Main inputs                                                     | Output | Key parameters                                                                                    | Purpose and notes                                                                                                              |
| ------------------------ | -------------------- | --------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `strategy.entry_block` | Strategy Entry Block | `eventIn/longCondition/shortCondition/symbol/riskInputs/plot` | None   | `orderType`, `qtyMode`, `qty`, `preferLongWhenBoth`, `longLabel`, `shortLabel`        | Strategy-level entry block that accepts both long and short conditions. If both trigger, the preferred side can be configured. |
| `strategy.exit_block`  | Strategy Exit Block  | `eventIn/longCondition/shortCondition/symbol/riskInputs/plot` | None   | `orderType`, `qtyMode`, `qty`, `longLabel`, `shortLabel`                                | Strategy-level exit block that generates close intents directly from long/short exit conditions.                               |
| `order.place_market`   | Place Market Order   | `eventIn/sideInput/riskInputs/plot`                           | None   | `side=buy/sell/auto`, `qtyMode=fixed/percent/quantity`, `qty`                               | Generates market order intent.`qty` is currently interpreted as USDT amount; `percent` uses a percent of available funds.  |
| `order.place_limit`    | Place Limit Order    | `eventIn/sideInput/riskInputs/plot`                           | None   | `side`, `qtyMode`, `qty`, `priceOffsetPct`                                                | Generates limit order intent. BUY offsets downward, SELL offsets upward.                                                       |
| `order.cancel_order`   | Cancel Order         | `eventIn/riskInputs/plot`                                     | None   | `orderId`                                                                                       | Cancels a specified exchange order.                                                                                            |
| `order.close_position` | Close Position       | `eventIn/riskInputs/plot`                                     | None   | `qtyMode=all/quantity/percent`, `qty`, `orderType`, `priceOffsetPct`, `reduceOnly=true` | Closes the current position. Defaults to reduce-only.                                                                          |
| `order.set_tpsl`       | Set TP/SL            | `eventIn/riskInputs/plot`                                     | None   | `stopLossPct=1.0`, `takeProfitPct=2.0`                                                        | Sets take profit and stop loss intent for a position or order.                                                                 |

Order chain example:

OnBarClose(15m).out

-> Edge Trigger.eventIn

Compare.result

-> Edge Trigger.condition

Edge Trigger.eventOut

-> strategy.entry.eventIn

Symbol Selector.symbol

-> strategy.entry.symbol

risk.max_order_rate.intent

risk.max_position_size.intent

risk.stop_take_rule.intent

-> strategy.entry.riskInputs


## 10. State Nodes

State nodes remember variables and signals during runtime. Use `persistent_*` when the value must survive restarts.

| Node ID                  | Name              | Main inputs             | Main outputs                       | Parameters                        | Purpose and notes                                                                               |
| ------------------------ | ----------------- | ----------------------- | ---------------------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------- |
| `state.var_set`        | Var Set           | `value`               | `value`                          | `key=signal`                    | Sets a strategy variable, usually scoped to the runtime instance.                               |
| `state.var_get`        | Var Get           | None                    | `value`                          | `key=signal`                    | Reads a strategy variable.                                                                      |
| `state.counter`        | Counter           | `eventIn`             | `value/eventOut`                 | `initialValue=0`, `step=1`    | Counts each event trigger. Useful for trigger statistics.                                       |
| `state.persistent_set` | Persistent KV Set | `eventIn/value`       | `value/eventOut`                 | `key=last_signal`               | Writes a cross-restart persistent variable.                                                     |
| `state.persistent_get` | Persistent KV Get | None                    | `value`                          | `key=last_signal`, `fallback` | Reads a persistent variable. Returns fallback when the key does not exist.                      |
| `state.rolling_window` | Rolling Window    | `eventIn/value`       | `values/latest/count/eventOut`   | `size=20`                       | Maintains a rolling window of the latest N numeric values.                                      |
| `state.last_signal`    | Last Signal       | `eventIn/signal`      | `signal/changed/eventOut`        | `key=signal`                    | Stores the previous signal and outputs whether it changed. Useful for avoiding repeated orders. |
| `state.overbought`     | Overbought State  | `value/threshold`     | `result`                         | `threshold=70`                  | Indicator value is greater than or equal to the threshold.                                      |
| `state.oversold`       | Oversold State    | `value/threshold`     | `result`                         | `threshold=30`                  | Indicator value is less than or equal to the threshold.                                         |
| `state.midline`        | Midline State     | `value/threshold`     | `result`                         | `threshold=50`                  | Indicator value is greater than or equal to the midline threshold.                              |
| `strategy.trend_state` | Trend State       | `changeUp/changeDown` | `state/stateCode/isLong/isShort` | `longCode=B`, `shortCode=S`   | Also a state node; maintains trend state from switch signals.                                   |

## 11. Tool Nodes

Tool nodes handle intermediate calculation and formatting. Prefer expression nodes for complex calculations and arithmetic nodes for simple operations.

| Node ID               | Name            | Main inputs             | Main outputs  | Parameters                                          | Purpose and notes                                                            |
| --------------------- | --------------- | ----------------------- | ------------- | --------------------------------------------------- | ---------------------------------------------------------------------------- |
| `math.expression`   | Math Expression | Dynamic variable inputs | `value`     | `expression`, `variableCount`, variable aliases | Numeric expression supporting `+ - * / %` and parentheses.                 |
| `tool.number_expr`  | Number Expr     | Dynamic variable inputs | `value`     | `expression`, `variableCount`, variable aliases | Legacy numeric expression node, useful for replacing Add/Sub/Mul/Div chains. |
| `tool.cast_number`  | Cast -> Number  | `value`               | `value`     | None                                                | Explicitly casts to number.                                                  |
| `tool.cast_integer` | Cast -> Int     | `value`               | `value`     | None                                                | Explicitly casts to integer.                                                 |
| `tool.cast_bool`    | Cast -> Bool    | `value`               | `value`     | None                                                | Explicitly casts to boolean.                                                 |
| `tool.clamp`        | Clamp           | `value`               | `value`     | `min=0`, `max=100`                              | Restricts a value to a range.                                                |
| `tool.normalize`    | Normalize       | `value`               | `value`     | `min=0`, `max=100`                              | Normalizes a value to 0-1.                                                   |
| `tool.add`          | Add             | `a/b`                 | `value`     | None                                                | Addition.                                                                    |
| `tool.sub`          | Sub             | `a/b`                 | `value`     | None                                                | Subtraction.                                                                 |
| `tool.mul`          | Mul             | `a/b`                 | `value`     | None                                                | Multiplication.                                                              |
| `tool.div`          | Div             | `a/b`                 | `value`     | None                                                | Division.                                                                    |
| `tool.map_symbol`   | Map Symbol      | `symbol`              | `symbol`    | `exchange=binance/okx/bybit`                      | Maps a symbol to the target exchange format.                                 |
| `tool.tag`          | JSON/Tag        | `value`               | `value/tag` | `tag`                                             | Adds a text tag or JSON fragment to data.                                    |
| `tool.round`        | Round/Precision | `value`               | `value`     | `precision=2`                                     | Handles numeric precision for prices, quantities, and chart display.         |

## 12. Chart Nodes

Chart nodes visualize the strategy. Some nodes receive `eventIn` to control whether the current bar is drawn; others are purely data-driven. Chart nodes usually do not participate in order decisions and are best used as side outputs.

### Common Chart Parameters

| Parameter       | Description                                                                                                         |
| --------------- | ------------------------------------------------------------------------------------------------------------------- |
| `pane`        | Display area:`main` main chart, `chart` chart layer, `volume` volume pane, `indicator:0/1` indicator panes. |
| `visible`     | Whether to display.                                                                                                 |
| `zIndex`      | Layer order, from -200 to 200. Higher values render above lower values.                                             |
| `layer`       | Render layer:`background`, `underlay`, `overlay`, `annotation`.                                             |
| `style`       | Plot style:`line`, `linebr`, `stepline`, `area`, `histogram`, `columns`, `circles`, `cross`.        |
| `strokeStyle` | Line style:`solid`, `dashed`, `dotted`.                                                                       |

### Chart Node Index

| Node ID                      | Name            | Main inputs                                             | Main outputs | Key parameters                                                                                         | Purpose and notes                                                                               |
| ---------------------------- | --------------- | ------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- |
| `chart.color`              | Color           | None                                                    | `color`    | `color=#FF38BDF8`                                                                                    | Outputs color text for reuse by multiple chart nodes.                                           |
| `chart.background`         | Background      | `eventIn/color/startValue/endValue/startTime/endTime` | None         | `color`, `rangeMode=bars/time`, `startBarsAgo/endBarsAgo`                                        | Draws a background region by candle range or time range.                                        |
| `chart.bar_color`          | Bar Color       | `eventIn`                                             | None         | `colorMode=single/trend/theme`, body/wick/border/up/down colors                                      | Changes candle colors, useful for visualizing trend state.                                      |
| `chart.plots`              | Plot            | `color/value`                                         | `plotRef`  | `style`, `color`, `lineWidth`, `histBase`, `offset`, `showLast`, `trackPrice`            | Draws indicator lines, columns, areas, and more. Outputs a Plot reference.                      |
| `strategy.plot_trend_line` | Plot Trend Line | `value/trend`                                         | `plotRef`  | `style`, `upColor`, `downColor`, `neutralColor`, `lineWidth`                                 | Indicator line that changes color by trend state.                                               |
| `chart.fill`               | Fill            | `color/plot1/plot2`                                   | None         | `color`, `showLast`, `fillGaps`                                                                  | Fills the area between two Plot/HLine references. Both references must be in the same pane.     |
| `chart.hline`              | HLine           | `price/color/startValue/endValue/startTime/endTime`   | `hlineRef` | `price`, `title`, `color`, `linestyle`, `linewidth`, `rangeMode`                           | Draws a horizontal line and can be used as a Fill reference.                                    |
| `chart.levels`             | Levels          | `value/color`                                         | None         | `value`, `color`, `lineWidth`, `strokeStyle`, `label`, range parameters                      | Draws price level lines for support, resistance, TP/SL references.                              |
| `chart.line`               | Line            | `startValue/endValue`                                 | None         | `lineColor`, `lineWidth`, `strokeStyle`, `leftBarsAgo/rightBarsAgo`                            | Draws a segment from a historical bar to current or future offset.                              |
| `chart.box`                | Box             | `top/bottom/text`                                     | None         | `fillColor`, `borderColor`, `textColor`, `borderWidth`, `leftBarsAgo/rightBarsAgo`           | Draws a price range box for consolidation zones or supply/demand zones.                         |
| `chart.tables`             | Tables          | `eventIn` and dynamic `value1...valueN`             | None         | `title`, `placement`, `itemCount=1-12`, `labelPosition`, `columnCount`, colors and alignment | Displays a chart dashboard.`itemCount` dynamically expands value inputs and label parameters. |
| `chart.text`               | Text            | `value`                                               | `text`     | `color`, `textFallback`, `size`, `barsAgo`                                                     | Outputs text. When a value is connected, it concatenates “text + value”.                      |
| `chart.shapes`             | Shapes          | `value/series/text`                                   | `shape`    | `shape`, `location=abovebar/belowbar/absolute`, colors, size, offset                               | Draws shape markers. If `series` is false, it usually does not draw.                          |
| `chart.plotchar`           | PlotChar        | `series/value/text/shape`                             | None         | `location`, `value`, `color`, `offset`, `yOffset`                                            | Draws text or shape markers by condition.`shape` supports multiple connections.               |
| `chart.entry_plot`         | Entry Plot      | None                                                    | `plotRef`  | `shape=arrow_right_sharp`, `size`, `textSize`                                                    | Outputs an entry chart template. Actual drawing happens when an order fills.                    |
| `chart.exit_plot`          | Exit Plot       | None                                                    | `plotRef`  | `shape=arrow_left_sharp`, `size`, `textSize`                                                     | Outputs an exit chart template. Actual drawing happens when an order fills.                     |

Common chart usage:

EMA.value -> chart.plots.value

RSI.value -> chart.tables.value1

Entry Plot.plotRef -> strategy.entry.plot

Exit Plot.plotRef -> strategy.close.plot


## 13. Common Strategy Templates

### 15m Execution, 1h Trend Filter

event.on_bar_close(timeframe=15m)

-> market.symbol_selector.eventIn

market.symbol_selector.symbol

-> market.get_ohlcv.symbol

market.get_ohlcv(timeframe=1h).close

-> indicator.ema(period=50)

market.get_ohlcv(timeframe=1h).close

-> indicator.ema(period=200)

EMA50.value > EMA200.value

-> logic.compare.result

logic.compare.result

-> strategy.entry.when

event.on_bar_close.out

-> logic.edge_trigger.eventIn

logic.compare.result

-> logic.edge_trigger.condition

logic.edge_trigger.eventOut

-> strategy.entry.eventIn


### Breakout Entry with ATR Risk

Get OHLCV.close -> indicator.donchian.series

Last Price.price -> signal.breakout.value

Donchian.upper -> signal.breakout.level

Get OHLCV -> indicator.atr

ATR.value -> strategy.atr_stop_block.atr

risk.max_order_rate.intent

risk.order_validation.intent

strategy.atr_stop_block.intent

-> strategy.entry.riskInputs


### Prevent Repeated Orders from the Same Signal

Compare.result -> state.last_signal.signal

OnBar.out -> state.last_signal.eventIn

state.last_signal.changed -> strategy.entry.when

state.last_signal.eventOut -> strategy.entry.eventIn


## 14. Troubleshooting

| Problem                        | Check first                                                                                                                                                     |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Blueprint cannot compile       | Whether there is an event source; whether port types match; whether data flow forms a loop; whether an input port has duplicate connections.                    |
| Strategy does not trigger      | Whether event timeframe is correct; whether `when` is true; whether `Edge Trigger` has already fired; whether date filter has expired.                      |
| Order node does not execute    | Whether `eventIn` is connected; whether `riskInputs` is connected; whether risk control rejected it; whether runtime mode allows trading.                   |
| High-frequency repeated orders | Add `logic.gate`, `logic.once_per_bar`, `state.last_signal`, and/or `risk.max_order_rate`.                                                              |
| 1h filter does not work        | Check whether `market.get_ohlcv.timeframe` is explicitly set to `1h`; do not accidentally use `runtime`.                                                  |
| Indicator is empty or abnormal | Whether `limit` covers the indicator period; whether input connects to the correct series; whether the backtest range has enough historical candles.          |
| Chart does not display         | Whether required chart inputs exist; whether `visible` is enabled; whether `pane/layer/zIndex` is reasonable; whether Fill references are in the same pane. |
| Type mismatch                  | Insert `tool.cast_number`, `tool.cast_integer`, or `tool.cast_bool`.                                                                                      |

## 15. Full Node ID Index

Use this index to quickly check `schemaId` in blueprint files.

| Category   | Node IDs                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Events     | `event.on_start`, `event.on_stop`, `event.on_bar`, `event.on_bar_open`, `event.on_bar_close`, `event.on_tick`, `event.on_timer`, `event.on_order_update`, `event.on_trade_transaction`, `event.on_position_update`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Market     | `market.symbol_selector`, `market.get_ohlcv`, `market.last_price`, `market.bid_ask`, `market.mark_price`, `market.account_snapshot`, `market.position_state`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Indicators | `indicator.sma`, `indicator.ema`, `indicator.kama`, `indicator.rsi`, `indicator.atr`, `indicator.atr_median`, `indicator.bb`, `indicator.macd`, `indicator.donchian`, `indicator.candle_streak`, `indicator.adx`, `indicator.chop`, `indicator.vwap`, `indicator.stoch`, `indicator.stoch_rsi`, `indicator.highest`, `indicator.lowest`, `indicator.ichimoku`, `indicator.supertrend`, `indicator.fibonacci`, `indicator.cci`, `indicator.williams_r`, `indicator.parabolic_sar`, `indicator.obv`, `indicator.mfi`, `indicator.volume`, `indicator.keltner`, `indicator.roc`, `indicator.momentum`, `indicator.smoothed_momentum`, `indicator.wavetrend`, `indicator.aroon`, `indicator.cmf`, `indicator.pivot_points` |
| Signals    | `logic.cross_over`, `logic.cross_under`, `signal.enter_range`, `signal.leave_range`, `signal.breakout`, `signal.breakdown`, `strategy.date_range_filter`, `strategy.cross_signal`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Logic      | `logic.compare`, `logic.boolean_and`, `logic.boolean_or`, `logic.boolean_not`, `logic.edge_trigger`, `logic.if_else`, `bool.expression`, `logic.bool_expr`, `logic.ternary`, `logic.select_value`, `logic.gate`, `logic.once_per_bar`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Risk       | `risk.max_order_rate`, `risk.kill_switch`, `risk.order_validation`, `risk.max_position_size`, `risk.cooldown_after_loss`, `risk.daily_consecutive_loss_cooldown`, `risk.stop_take_rule`, `strategy.atr_stop_block`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Functions  | `strategy.entry`, `strategy.cancel`, `strategy.close`, `strategy.cancel_all`, `strategy.close_all`, `strategy.exit`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Orders     | `strategy.entry_block`, `strategy.exit_block`, `order.place_market`, `order.place_limit`, `order.cancel_order`, `order.close_position`, `order.set_tpsl`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| State      | `strategy.trend_state`, `state.var_set`, `state.var_get`, `state.counter`, `state.persistent_set`, `state.persistent_get`, `state.rolling_window`, `state.last_signal`, `state.overbought`, `state.oversold`, `state.midline`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Tools      | `math.expression`, `tool.number_expr`, `tool.cast_number`, `tool.cast_integer`, `tool.cast_bool`, `tool.clamp`, `tool.normalize`, `tool.add`, `tool.sub`, `tool.mul`, `tool.div`, `tool.map_symbol`, `tool.tag`, `tool.round`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Chart      | `chart.color`, `chart.background`, `chart.bar_color`, `chart.plots`, `strategy.plot_trend_line`, `chart.fill`, `chart.hline`, `chart.levels`, `chart.line`, `chart.box`, `chart.tables`, `chart.text`, `chart.shapes`, `chart.plotchar`, `chart.entry_plot`, `chart.exit_plot                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |