QuantCraft documentation reference
QuantCraft ships two complementary kinds of documentation: in-app topics you read inside the IDE, and developer Markdown bundled with the product for deeper API detail. Together they describe how to write strategies, run backtests, and use the IDE. These web docs mirror many of those topics — start with Introduction or Getting started.
Where to read docs in the app
- Open QuantCraft from the main app.
- Expand the right sidebar (if it is collapsed).
- Open the Documentation tab (alongside QuantCraft AI).
You land on a searchable index of topics. Type in the search box to filter by title, summary, or embedded keywords (for example on_finish, PaperAccount, chart_indicator_series).
Tap a topic card to open the full article. Use Back to return to the index.
Topic index (in-app)
Topics are grouped into two sections, matching the Documentation sidebar.
Getting started
| Topic | What you will learn |
|---|---|
| Fundamentals | Financial statement data, date-keyed tables, how fundamentals align to bars, and how to read them in a strategy. |
| Account | PaperAccount: balances, positions, orders, PnL, and performance metrics exposed during a backtest. |
| Life cycle | Callback order: on_init, on_bar, on_tick, on_timer, on_finish — including multi-symbol basics and optional full-series on_finish(bars). |
Reference
| Topic | What you will learn |
|---|---|
| Input parameters | Declaring ide.inputs_module.params, types, and how values are supplied from the Test (backtest) modal. |
| OHLCV | Bar shape (OhlcvBarView), loaders (Alpaca vs B2), time ranges, and using bar data in callbacks. |
| Indicator series | Building chart_indicator_series overlays (lines, histograms, panes) on backtest result charts. |
Any card in the index that does not open a full article yet is labeled Soon in the UI.
How the in-app docs relate to your workflow
Use this quick map when you are doing something in the IDE:
| You want to… | Start with |
|---|---|
| Configure symbols, dates, fundamentals, and run a simulation | Strategy lifecycle + OHLCV; then Running code (Test) and Test results. |
| Size positions, stops, or read Sharpe / drawdown | Account model |
| Let users tune thresholds without editing code | Input parameters |
| Plot custom series on the equity chart | Indicator series |
| Mix price and filings / statements | Fundamentals |
The in-app articles are written for strategy authors and IDE users, not for server operators.
Bundled developer reference (Markdown)
For line-level module behavior, message formats, and engine orchestration, the product also includes Markdown under the quantcraft-dev bundle (conceptually: “QuantCraft development docs”). A typical table of contents looks like this:
| Document | Focus |
|---|---|
| BACKTEST_README | High-level backtest package overview |
| BACKTEST_ENGINE | Engine orchestration, config, callbacks, result payload |
| BACKTEST_MODULE | WebSocket backtest entry from the IDE |
| IDE_BACKTEST_RUNNER | Subprocess runner next to the Python service |
| RUNTIME | Runtime globals: account, chart_indicators, fundamentals / OHLCV handles |
| INPUTS_MODULE | params wiring from the Test modal |
| ACCOUNT_MODULE | PaperAccount implementation details |
| OHLCV_MODULE | QcOhlcv loaders and bar types |
| INDICATOR_SERIES_MODULE | Chart series payload and helpers |
| FUNDAMENTALS_MODULE | Fundamentals JSON shape and API |
Those files are aimed at advanced users and contributors who need exact names and contracts. QuantCraft AI in the IDE is preloaded with this material so answers stay aligned with the shipped modules.
Other help surfaces in QuantCraft
These are not the Documentation tab but are part of the same “reference ecosystem” for users:
- QuantCraft AI — Ask natural-language questions; answers can cite the same dev corpus. Requires your own model API key (see your product guide for Connect model).
- Import and export — Move
.py(and related) files between disk and the workspace. - Test results — Equity chart, metrics, trades, and HTML export after a backtest.
Search tips
- Prefer short tokens that appear in code:
on_finish,qc_ohlcv,params,chart_indicator_series. - If nothing matches, clear the search — the index lists every topic by section.
- Cross-topic ideas (for example “fundamentals +
on_bar”) often need two articles: open Fundamentals for data shape, then Strategy lifecycle for when it is available.
Document history
In-app Documentation is maintained alongside the strategy runtime. When the Python modules or backtest payload change, the in-app topics and bundled Markdown are updated together so examples and names stay in sync.