> ## Documentation Index
> Fetch the complete documentation index at: https://help.vole.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Chart Lab

> [!NOTE]
>
> This screen is part of the Vole Bot package.

**Chart Lab** lets you draw any symbol, layer indicators on top of it, and re-run one of your own strategies over that same window to see exactly where it would have entered and exited. It's pure analysis: nothing here places an order, changes a bot's settings, or saves your choices — refresh the page and you start from a blank symbol box again, on purpose.

The page has three parts: a toolbar and layer picker at the top, the chart itself, and a **Strategy Test** panel underneath it.

## Toolbar

Every field here reloads the chart when you change it, except **Volume**, which is instant.

* **Symbol** — a type-ahead search box. A small badge next to it shows whether the price data comes from the crypto side or the stocks/FX side; that's detected automatically from the symbol, nothing to pick.
* **Timeframe** — the candle period.
* **Candle Type** — Candle or Heikin Ashi. Heikin Ashi smooths the chart by averaging prices, which typically delays when a signal appears by roughly a bar, and the levels you see are not real trade prices.
* **Window** — how many days of history to load. This one setting decides three things at once: the candles drawn, the range overlays scan, and how far back Strategy Test runs.
* **Volume** — show or hide the volume bars under the chart.

## Overlay layers

The layer picker groups indicators into families — click one to open the list of individual layers inside it, each with a description on hover. A small badge on each layer shows what it draws: a horizontal level, a line, an icon on a candle, or a shape/zone. A lightning-bolt mark flags a heavier layer to compute; to keep the chart responsive, only so many heavier layers can be active at once, and the page stops you from adding past that point rather than letting the chart slow down.

Not every indicator in the wider catalog has a drawable chart form yet — the search here only lists ones that do, so if you can't find something you're looking for, that's usually why.

**Clear all** resets the chart back to plain candles.

## Reading the chart

One rule never changes: **an arrow on the chart is always a real entry or exit signal** — bright green up for a long entry, red down for a short or exit. Overlay pattern markers are deliberately small, muted icons or shapes, never arrows, and never use those same colors — so you can't mistake a pattern marker for a signal.

The strategy layer (entry/exit arrows and trade lines) only appears once you run Strategy Test below.

## Strategy Test

Pick one of your own saved strategies — only strategies you've created in Strategy Manager show up here — and a version, then press **Run — replay history**. It runs over exactly the symbol, timeframe, window and candle type set in the toolbar above.

The chart refreshes with that run's trades, and a summary appears alongside it: number of trades, win rate, P\&L, profit factor, and how many candles were scanned.

> [!NOTE]
>
> This run does not apply any of your execution policies — it uses the
> strategy's own signals with a simple built-in exit, not the exit rules your
> live instance actually uses. What you see here is the strategy's raw signal
> behavior, not what a live instance would have produced. To see the effect of
> a specific execution policy, use **Policy Compare** below.

If a run fails, it's usually because there isn't enough data for that symbol, timeframe and window combination — try a longer window or a different timeframe.

### Ensemble, Edge Rules and Policy Compare

Three tabs sit below the run, and all three only fill in after you've run a strategy — each works on that same run's trades.

* **Ensemble** — a what-if view. It shows what would have happened to this run's trades if a group of exit rules voting together had a say in when to close them, alongside the run's real result. It is analysis only. It does not switch on any live rule: the live **Ensemble Exit Score** rule is paused for everyone (see [Pro Exit Catalog](https://help.vole.bot/en/execution-rules/pro-exit-catalog.md)). The panel flags this view as *indicative*: it applies live-tuned logic to a hypothetical, which points a direction rather than proving one.
* **Edge Rules** — lets you apply candidate rules to this run's trades and see whether each one would have helped. It runs once automatically the first time you open the tab after a run.
* **Policy Compare** — different from the other two: instead of reinterpreting the same trades, it reruns the strategy from scratch, once per policy you pick, because a policy changes both when a trade exits and, indirectly, what the next entry ends up being. Choose a few saved execution policies to compare — the current baseline (no policy applied, the same plain run described above) is always included — and press **Compare**. Each policy gets its own row with standard figures (P\&L, win rate, profit factor, trade count, drawdown) and how it differs from the baseline.

Treat any of these as a directional read on a strategy's raw signals, not a verdict — a difference on a small handful of trades is usually noise.

### Inspecting a single trade

After a run, click any trade on the chart to open a per-trade breakdown showing which rules looked at it and what each one decided.

## Common snags

> [accordion] I picked a layer but it's not drawing
>
> Not every entry in the search list has a drawable chart form yet — the
> search only lists ones it can actually draw. If you can't find what you're
> looking for, it likely isn't drawable.

> [accordion] Which policy did Strategy Test run under?
>
> None. See the note above — it's the strategy's raw signals with a simple
> built-in exit. Use Policy Compare to test a specific policy.

> [accordion] My numbers don't match my live bot
>
> That's expected — Chart Lab is a simulation on historical data, not a
> replay of your live instance. For numbers closer to what actually
> happened, check the instance detail page and its What-If panel.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.