Backtests

Use the Test button (Running code) in the QuantCraft IDE to open Run backtest. There you set symbols, price data, optional fundamentals, the simulation window, account defaults, and (if your script uses them) input parameters for a single run. The engine invokes your strategy lifecycle callbacks. Results appear in Test results; OHLCV explains bar shapes.

The dialog explains which price source applies at the top (a short banner). Everything else is grouped so you can work top‑to‑bottom before you click Continue to start the backtest.

---

Price source (Alpaca vs. B2)

You do not pick the price vendor manually — the app chooses it from your active trading account:

• Alpaca is used when the active account has API key + secret, or an OAuth-linked Alpaca connection with a valid link id. Intraday and daily-style Alpaca timeframes are available.
• QuantCraft B2 is used when the active account has no Alpaca credentials that qualify. In that case only daily (d), weekly (w), and monthly (m) OHLCV timeframes are available.

If B2 is selected, you must be signed in to QuantCraft so a session token can be sent for B2 OHLCV (and for fundamentals when enabled).

---

Bar timeframe and asset class (Alpaca only)

When the price source is Alpaca, you can set:

When the price source is B2, you only choose B2 timeframe: Daily, Weekly, or Monthly (no intraday on B2).

---

Symbols

Use Symbols to choose one or more tickers for the run:

• With Alpaca, the list comes from your Alpaca asset universe (equity vs. crypto follows Asset class). You can search and multi-select.
• With B2, the list comes from the same catalog as fundamentals paths on the server.

Rules:

• At least one symbol is required.
• Symbols are normalized to uppercase for the run.
• Valid characters: letters, digits, . and - (typical for exchange suffixes like BRK.B or RHM.XETRA).

The first symbol in your selection order is the default clock symbol (primary execution bar) unless your strategy overrides it with a top-level SYMBOL = "..." that matches a loaded ticker.

---

Fundamentals (optional)

Tick Uses fundamentals when your strategy reads the fundamentals argument in on_bar / on_tick / on_timer, or uses fundamentals-aware logic.

When fundamentals are on:

• You must be signed in (QuantCraft token is sent to load B2 fundamentals files).
• Pick one or more fundamentals bundles from the Fundamentals multi-select (paths like fundamentals/AAPL.json.gz). The dialog shows the normalized path under each selection.

Important: OHLCV symbols and fundamentals symbols are independent. You can backtest RNMBY on Alpaca while loading RHM.XETRA fundamentals — the UI reminds you that in that case you must pass the correct ticker into fundamentals.current(..., symbol="RHM.XETRA") (or equivalent) in code.

When multiple fundamentals bundles are selected, the engine builds a per-path map. The primary fundamentals bundle used for bar-aligned snapshots defaults to the first OHLCV symbol in your symbol list unless the engine applies another rule; use explicit symbol= on fundamentals.current / get_data_with_offset when you need a specific bundle.

---

Simulation window (dates and warmup)

---

Account — starting balance and advanced defaults

Under Advanced — stops, targets, risk (optional) you can set defaults passed into the paper account (your strategy must still enforce exits; these configure default distances for open_trade):

• Stop-loss % or Stop-loss $ — not both. Percent can be entered as 2 or 0.02 for 2%.
• Take-profit % or Take-profit $ — not both.
• Risk % per trade or Risk fixed $ per trade — not both; used with position_size_for_risk when you size from risk.

---

Script parameters (single run)

If your strategy imports from ide.inputs_module import params and references params.NAME, the dialog shows a Script Parameters section with one row per discovered name: Parameter, Type (int / float / str / bool), and Value.

Fill every row before Continue — values are required for each declared parameter. They are sent on the wire as strings and coerced by the engine before your file loads, so params.PERIOD (for example) is already the correct Python type when your module executes.

This doc does not cover parameter optimization (grid or genetic search). Leave the “Optimize script parameters” option unchecked for a normal single backtest.

---

What happens when you click Continue

The app validates the form (dates, symbols, balance, mutual exclusivity of SL/TP/risk fields, fundamentals if enabled, and script parameter types). On success it starts one backtest with the assembled configuration; progress and logs appear in the Output panel, and structured results open in Test Results.

---

Quick reference

---

Tips

• If Alpaca symbols never load, open Trade once or confirm Alpaca connectivity; for B2, confirm you’re signed in and the symbol catalog loaded.
• Warmup only extends loaded history — it does not add trading days outside your date range.
• Match fundamentals bundles to the tickers you actually read in code when OHLCV and fundamentals tickers differ.
• Use Min bars sparingly — it is easy to accidentally shorten a run more than you intended.