Skip to main content

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:

FactWhat it answersValues
StructureIs the market trending or ranging, and which way?Bull trend, Bear trend, Bull range, Bear range (or Unclear)
VolatilityHow much is the price range expanding or shrinking?Expanding, Normal, Contracting
WarningsIs 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:

FieldValue
AgentTrend Rider
RegimeBull trend
Min regime strengthMedium

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​

RegimeWhat it meansAgent style that fits
Bull trendSustained upward trendTrend-following, breakout
Bear trendSustained downward trendTrend-following (short), breakout
Bull rangeSideways movement with bullish biasMean-reversion, range trading
Bear rangeSideways movement with bearish biasMean-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).

SituationWhat happens
Regime reads UnclearRules requiring a specific regime (Bull trend, etc.) don't match
You selected Any regimeThe 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).

VolatilityWhat it means
ExpandingThe price range is widening
NormalThe price range is steady
ContractingThe 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:

WarningWhat it means
CrashPrice 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 divergenceMomentum 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 timeframeRegime read from
5m15m
15m1h
30m2h
1h4h
2h8h
4h12h
8h1d
12h1w
1d1w

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 TFHow often regime can change
15mEvery 15 minutes
1hEvery hour
4hEvery 4 hours
1dOnce 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.

SituationRule matches?
No regime reading yetNo (waiting for data)
Regime is UnclearNo (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.

StrengthWhat it means
UncertainAny reading, even low confidence — matches almost always
LowSlight lean toward this regime
MediumReasonable confidence — good default choice
HighStrong confidence — clear regime signal
MaximumVery 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 caseRecommended 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.

SelectionWhat it means
Expanding, Normal, Contracting (default)Any volatility
Expanding onlyOnly while the range is widening
Contracting onlyOnly 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).

SettingWhat it means
Keep running (default)Warnings make no difference — the agent stays on duty
Pause during warningsThe rule stops matching while any warning holds, and matches again when it clears
Only during warningsThe 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:

RuleAgentRegimeMin strengthVolatilityDuring warningsOrder
1Trend HunterBull trendMediumAnyKeep running1
2Trend HunterBear trendMediumAnyPause during warnings2
3Range ScalperBull rangeLowAnyKeep running3
4Range ScalperBear rangeLowAnyKeep running4
DefaultCareful Bot—————

What happens throughout the day​

Your agent's strategy is 1h, so Radar reads the 4h regime.

Time (UTC)4h RegimeStrengthWho's on dutyWhy
04:00Unclear—Careful BotNo rule matches → default
08:00Bull trend · ExpandingHighTrend HunterRule 1 matches
12:00Bull trend · Expanding · ⚠ Momentum divergenceHighTrend HunterRule 1 matches (Keep running ignores the warning)
16:00Bull range · NormalMediumRange ScalperRule 3 matches
20:00Bull range · ContractingLowRange ScalperRule 3 matches (meets minimum)
00:00Unclear—Careful BotNo 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:

SettingWhere it livesWhat it filters
Minimum regime strengthPer ruleWhich regime readings match the rule
Minimum agent confidence (%)Per ruleWhich trade signals the agent takes

Example: A rule with Medium regime strength and 70% agent confidence means:

  1. The regime must be at least Medium confidence to match the rule
  2. 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:

  1. Higher timeframe candle closes (e.g. 4h at 08:00 UTC)
  2. Regime detector runs on the new closed data
  3. Rules are re-evaluated with the new regime reading
  4. 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