Market regimes
A market regime is BattleGrid's classification of current market conditions. Instead of you watching charts to decide "is this a trending market or a ranging market?", BattleGrid's regime detector does it automatically.
Your Radar rules can match on regime — put your trend-following agent on duty during trends, your mean-reversion agent during ranges.
A regime reading tells you three separate things about the market, and no one of them replaces another:
| Fact | What it answers | Values |
|---|---|---|
| Structure | Is the market trending or ranging, and which way? | Bull trend, Bear trend, Bull range, Bear range (or Unclear) |
| Volatility | How much is the price range expanding or shrinking? | Expanding, Normal, Contracting |
| Warnings | Is something unusual happening right now? | Crash, Momentum divergence (or none) |
BattleGrid shows them together, for example Bear trend · Expanding · ⚠ Crash.
Quick start: trade only during a Bull trend
Here's a rule that puts your Trend agent on duty when the market is trending upward:
| Field | Value |
|---|---|
| Agent | Trend Rider |
| Regime | Bull trend |
| Min regime strength | Medium |
When BTC enters a Bull trend with at least Medium confidence, Trend Rider goes on duty. When the structure changes, this rule stops matching. The rule's other two settings are left at their defaults: any volatility, and keep running during warnings.
Structure: the four regimes
| Regime | What it means | Agent style that fits |
|---|---|---|
| Bull trend | Sustained upward trend | Trend-following, breakout |
| Bear trend | Sustained downward trend | Trend-following (short), breakout |
| Bull range | Sideways movement with bullish bias | Mean-reversion, range trading |
| Bear range | Sideways movement with bearish bias | Mean-reversion, range trading |
The structure is decided by the trend and where price sits in its range — never by volatility or by a warning. A trend stays a trend whether its range is expanding or shrinking.
The fifth reading: Unclear
Sometimes the regime detector can't make a confident classification. This shows as Unclear (or "Fallback" in some places).
| Situation | What happens |
|---|---|
| Regime reads Unclear | Rules requiring a specific regime (Bull trend, etc.) don't match |
| You selected Any regime | The rule matches regardless of regime reading, including Unclear |
Volatility: Expanding, Normal, Contracting
Volatility describes whether the price range is widening, steady or tightening. It is read on every bar and shown beside the structure. It does not change the structure — a Bull trend with Contracting volatility is still a Bull trend, just a quieter one (and a lower strength reading than the same trend with Normal volatility).
| Volatility | What it means |
|---|---|
| Expanding | The price range is widening |
| Normal | The price range is steady |
| Contracting | The price range is tightening |
Warnings: Crash and Momentum divergence
A warning is an unusual event the detector flags beside the structure. There are two, and both can hold at once:
| Warning | What it means |
|---|---|
| Crash | Price has dropped sharply, measured against the coin's own normal moves. Once raised it stays raised until the drop eases, so one episode shows as one warning rather than flickering on and off. |
| Momentum divergence | Momentum is no longer agreeing with the trend. Only flagged during a trend. |
"Volatile" and "Contraction" are not regimes any more. A crash or a momentum divergence used to relabel the market as "Volatile", which hid whether it was a bull or a bear market underneath. Now it is a warning beside the direction: a Bull trend rule keeps its agent on duty through a warning unless you set the rule to pause. Quiet, compressed price action is the Contracting volatility setting.
Tip: If your rules require specific regimes, make sure you have a default agent to catch Unclear periods.
How regime detection works
Higher timeframe
Each agent reads the regime at the shortest enabled timeframe at least three times its strategy's candle:
| Strategy timeframe | Regime read from |
|---|---|
| 5m | 15m |
| 15m | 1h |
| 30m | 2h |
| 1h | 4h |
| 2h | 8h |
| 4h | 12h |
| 8h | 1d |
| 12h | 1w |
| 1d | 1w |
Why? The higher timeframe shows the bigger picture. A 1h strategy trades intraday, so it reads the 4h regime to know if the day's trend is bullish or bearish.
Regime on closed candles
The regime reading comes from the most recent closed candle on the higher timeframe. It cannot change until the next candle closes.
| Higher TF | How often regime can change |
|---|---|
| 15m | Every 15 minutes |
| 1h | Every hour |
| 4h | Every 4 hours |
| 1d | Once per day |
Example: Your 1h agent reads from 4h candles. The 4h candle closes at 08:00 UTC. That regime reading stays fixed until the next 4h close at 12:00 UTC — no matter what price does in between.
No regime reading yet
When there's no closed candle data for the regime timeframe, the status shows No regime reading yet. This happens when:
- The coin was just added to Radar
- The higher timeframe hasn't closed a candle since you started
- There's a data gap on the regime timeframe
A rule requiring a specific regime cannot match when there's no regime reading. The rule doesn't fail — it just waits.
| Situation | Rule matches? |
|---|---|
| No regime reading yet | No (waiting for data) |
| Regime is Unclear | No (regime detected, but not what you selected) |
| Regime matches your selection (and volatility and warning settings allow it) | Yes |
Settings
Minimum regime strength
How confident the regime classification must be before the rule matches.
| Strength | What it means |
|---|---|
| Uncertain | Any reading, even low confidence — matches almost always |
| Low | Slight lean toward this regime |
| Medium | Reasonable confidence — good default choice |
| High | Strong confidence — clear regime signal |
| Maximum | Very high confidence — only the clearest readings |
Higher strength = fewer matches. If you set Maximum, your rule only matches when the regime detector is very confident.
| Use case | Recommended strength |
|---|---|
| "I want to trade in a Bull trend most of the time" | Low or Medium |
| "I only want strong Bull trend signals" | High or Maximum |
| "I'm fine with borderline readings" | Uncertain |
The strengths a rule can actually match depend on the structure and its volatility. A trend with Expanding volatility reads High or Maximum; with Normal volatility, Medium or High; with Contracting volatility, Low or Medium. A range reads Medium or High at any volatility. Unclear reads Uncertain or Low. The rule editor only offers strengths the rule can reach, so a Bull trend rule limited to Contracting volatility is never offered High.
Volatility
Which volatility levels the rule accepts. It is a multi-select with all three selected by default, which means any volatility — the rule places no constraint on it. Narrow it to match only some levels, for example a trend rule that runs only while volatility is Expanding or Normal.
| Selection | What it means |
|---|---|
| Expanding, Normal, Contracting (default) | Any volatility |
| Expanding only | Only while the range is widening |
| Contracting only | Only while the range is tightening |
A rule narrowed to fewer than all three levels never matches when the volatility can't be read.
During warnings
What the rule does while the market reading carries a warning (Crash or Momentum divergence).
| Setting | What it means |
|---|---|
| Keep running (default) | Warnings make no difference — the agent stays on duty |
| Pause during warnings | The rule stops matching while any warning holds, and matches again when it clears |
| Only during warnings | The rule matches only while a warning holds |
Tip: Leave a trend rule on Keep running if you want your trend agent to ride through a momentum divergence. Choose Pause during warnings if you want it to stand down when a crash or divergence appears. Pausing stops the agent from being on duty for new trades; a position it already holds stays open and is managed by its own exit rules.
Worked example: BTC with regime-based agents
You want different agents for different market conditions:
| Rule | Agent | Regime | Min strength | Volatility | During warnings | Order |
|---|---|---|---|---|---|---|
| 1 | Trend Hunter | Bull trend | Medium | Any | Keep running | 1 |
| 2 | Trend Hunter | Bear trend | Medium | Any | Pause during warnings | 2 |
| 3 | Range Scalper | Bull range | Low | Any | Keep running | 3 |
| 4 | Range Scalper | Bear range | Low | Any | Keep running | 4 |
| Default | Careful Bot | — | — | — | — | — |
What happens throughout the day
Your agent's strategy is 1h, so Radar reads the 4h regime.
| Time (UTC) | 4h Regime | Strength | Who's on duty | Why |
|---|---|---|---|---|
| 04:00 | Unclear | — | Careful Bot | No rule matches → default |
| 08:00 | Bull trend · Expanding | High | Trend Hunter | Rule 1 matches |
| 12:00 | Bull trend · Expanding · ⚠ Momentum divergence | High | Trend Hunter | Rule 1 matches (Keep running ignores the warning) |
| 16:00 | Bull range · Normal | Medium | Range Scalper | Rule 3 matches |
| 20:00 | Bull range · Contracting | Low | Range Scalper | Rule 3 matches (meets minimum) |
| 00:00 | Unclear | — | Careful Bot | No rule matches → default |
Notice: The regime can only change at 4h candle closes (04:00, 08:00, 12:00, etc.). Between closes, the same agent stays on duty.
Good to know
-
Regime + hours can combine. A rule can require "Bull trend during London hours" — both must match for the agent to go on duty.
-
Warnings don't change the direction. A crash inside a Bear trend is still a Bear trend; a rule routed on direction keeps matching unless you set it to pause.
-
Unclear is normal. Not every market moment has a clear regime. Plan for it with a default agent.
-
Higher strength filters more. Setting Maximum sounds safe, but you might miss opportunities when the regime is only "pretty confident."
-
The regime timeframe is automatic. You don't choose it — BattleGrid reads the shortest enabled timeframe at least three times your strategy's candle.
-
Same regime, different strengths. Two rules can match the same regime with different strength floors. The lower-strength rule matches more often.
Advanced: Regime vs agent confidence
Don't confuse regime strength with agent confidence:
| Setting | Where it lives | What it filters |
|---|---|---|
| Minimum regime strength | Per rule | Which regime readings match the rule |
| Minimum agent confidence (%) | Per rule | Which trade signals the agent takes |
Example: A rule with Medium regime strength and 70% agent confidence means:
- The regime must be at least Medium confidence to match the rule
- When the agent qualifies, it only trades if its confidence is at least 70%
Both filters apply. See Rules: Minimum agent confidence (%).
Advanced: Why closed candles only?
The regime reading uses closed candles (not the live forming candle) because:
- Live values change constantly — the regime would flicker
- Closed candles are final — the reading is stable
- It prevents whipsaws from intra-candle noise
This is the same principle as Closed candles only in strategy indicators. The trade-off is lag — the regime reflects what just happened, not what's happening right now.
Advanced: Detecting regime changes
Here's how Radar detects and acts on regime changes:
- Higher timeframe candle closes (e.g. 4h at 08:00 UTC)
- Regime detector runs on the new closed data
- Rules are re-evaluated with the new regime reading
- Agents go on/off duty based on which rules now match
Between closes, the regime is frozen. If price moves dramatically mid-candle, the regime won't update until the next close.
Implication: A 1d strategy reads the 1w regime, which only updates once a week. Be patient with longer timeframes.
← Radar overview · Rules · Trading hours