# Node reference

### Data sources

#### Market Data

Fetches real-time or historical OHLCV data.

* `symbol`: market identifier (example: `BTCUSD`).
* `timeframe`: chart timeframe (example: `1H`, `4H`, `1D`).

#### Resample Timeframe

Converts data from one timeframe to another.

* `timeframe`: target timeframe.

Connect: **Market Data → Resample → Indicator**.

### Technical indicators

#### Retail indicators

Common TA indicators operating on price data.

* RSI
  * `period` (default: `14`)
* MACD
  * `fast` (default: `12`)
  * `slow` (default: `26`)
  * `signal` (default: `9`)
* Bollinger Bands
  * `period` (default: `20`)
  * `mult` (default: `2.0`)
* EMA / SMA
  * `period` (common: `21`)

Connect: **Market Data (or Resample) → Indicator**.

### Smart Money Concepts (SMC)

#### Swing Highs/Lows

* `swing_length` (default: `50`)

#### Order Blocks (OB)

Requires **Market Data** plus **Swing Highs/Lows**.

* `close_mitigation` (default: `false`)
* `breaker` (default: `false`)

#### Fair Value Gaps (FVG)

* `join_consecutive` (default: `false`)

#### BOS/CHOCH

Requires **Market Data** plus **Swing Highs/Lows**.

* `close_break` (default: `true`)

#### Liquidity

Requires **Market Data** plus **Swing Highs/Lows**.

* `range_percent` (default: `0.01`)

### Logic & conditions

#### Compare

Compares a value to a threshold.

* `op`: one of `>`, `<`, `>=`, `<=`, `==`, `!=`
* `value`: numeric threshold

#### Logic gates

* AND: all inputs must be true
* OR: any input can be true
* NOT: inverts the input

#### Crosses Above / Crosses Below

Detects crossover events between two signals.

### Trading actions

#### Buy Order / Sell Order

Emits an order signal when upstream conditions are true. No node properties.

### Direction detection

* Buy only → long-only.
* Sell only → short-only.
* Buy + sell → long & short.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.quantbytes.net/bot-studio/node-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.