Core Pages

Conditional Bots

10 min read

What it is

The orchestrator that AUTO-SWITCHES between your other bots based on detected market regime. Define rules like "when BTC is in Uptrend → activate Smart Trade momentum strategy; when Range → activate Grid Bot; when Strong Downtrend → pause everything." Regime is detected from real price action (trend strength + RSI + Bollinger volatility) every 5 minutes. Lets you run "the right bot for the right market" without manually deploying and stopping bots all day.

How to think about it

The single most powerful bot on the platform when configured correctly — and one of the most dangerous when misconfigured. Conditional Bot doesn't trade directly; it activates/deactivates OTHER bots based on rules. If your inner bots are bad, this just makes the bad trades faster. Get the inner bots working first, then orchestrate.

Step-by-step

  1. Pick a Reference Symbol + Timeframe

    The regime is detected from ONE symbol you specify (typically BTC/USDT or ETH/USDT) on ONE timeframe (1h is the standard). Even if your inner bots trade SOL/ETH/etc., the regime decision is made from the reference. Why: BTC drives the overall market; regime detection on the leader is more reliable than on the followers.

  2. The 6 Regimes

    STRONG UPTREND (high momentum, clear bullish trend), UPTREND (mild bullish), RANGE/SIDEWAYS (no clear direction — what Grid Bot loves), DOWNTREND (mild bearish), STRONG DOWNTREND (clear bearish), HIGH VOLATILITY (whipsawing without direction — most dangerous regime).

  3. How regimes are computed

    From three indicators on the reference symbol: TREND STRENGTH (EMA slope), VOLATILITY (Bollinger Band width as %), RSI (overbought/oversold). The detail panel shows all three live so you can verify the classifier. Trend > 0.5 + RSI > 60 = Uptrend. Volatility > 5% with mixed trend = High Volatility. Etc.

  4. Rule structure: WHEN → THEN

    Each rule has a WHEN condition (regime is X, OR trend is between Y/Z, OR vol is below W, OR RSI is in band) and a THEN action (activate strategy ABC, OR pause all bots, OR fallback to default). Rules evaluate top-to-bottom; first match wins. Always add a fallback rule at the end.

  5. THEN options — pick a strategy or pause

    Strategies available: trend-following (Alpha Momentum Pro), mean-reversion (DCA Guardian), breakout (Breakout Hunter), range (Bollinger Squeeze Pro), and 3 Grid Bot variants (tight/medium/wide range). OR pick "pause all bots" — useful for Strong Downtrend or extreme volatility regimes.

  6. Build rules from regime down to action — most-restrictive first

    Best practice: rule 1 = "Strong Downtrend → Pause." Rule 2 = "High Volatility → Pause." Rule 3 = "Uptrend → Trend strategy." Rule 4 = "Range → Grid Bot tight." Last rule = "Always → Default strategy." Order matters because first match wins.

  7. Activate + monitor in the List tab

    After creating, click Activate. The orchestrator evaluates the reference symbol every 5 minutes. Detail panel shows: current regime, the active rule, the active inner strategy, live trend strength + RSI + volatility, and a "Last evaluated" timestamp.

  8. Evaluate now button (manual trigger)

    Forces an immediate re-evaluation without waiting for the 5-minute tick. Useful after market news / volatility spike when you want to know if the regime classifier has caught up.

  9. Pause vs Delete

    PAUSE = stops evaluating, leaves rules intact, can be resumed. The currently-active inner bot is NOT stopped — only the orchestrator stops switching. DELETE = permanently removes the rule set (cannot be undone). For temporary pauses always use Pause.

  10. Active state card (top of detail)

    Color-coded by regime: green (uptrend), amber (range), red (downtrend), violet (volatile). Shows which rule fired, which inner strategy is active, and 3 live numbers — Trend Strength, Volatility %, RSI. If "fallback" appears, no rule matched and the default action fired.

  11. Switch history (in detail panel)

    Log of every regime → rule → strategy switch that's happened on this orchestrator. Useful for debugging "why did the bot do X at time Y?" After 1-2 weeks of operation, you can review and tune rules.

Tips & pitfalls

  • Conditional Bot does NOT trade directly. It only activates/pauses OTHER bots. Make sure your inner bots are PROVEN PROFITABLE in their target regime BEFORE wiring them up. Bad inner bots × auto-switching = faster losses.
  • BTC/USDT 1h is the standard reference. Crypto regimes correlate heavily with BTC; using BTC as the regime trigger captures the broader market state.
  • Always include a "Strong Downtrend → Pause" rule at the top. Strong downtrends are when most strategies bleed; pausing is structurally better than trying to short or hedge.
  • High Volatility regime is the most dangerous — strategies designed for trends OR range BOTH fail in whipsaws. Default to pause in High Volatility unless you have a specific high-vol strategy.
  • Auto-evaluation runs every 5 minutes. If you're trying to debug "why didn't this fire," check the timestamp + click Evaluate Now to force a fresh check.
  • Rules evaluate top-to-bottom — FIRST MATCH WINS. Always order from most-restrictive (pause conditions, extreme regimes) to least-restrictive (fallback always-active).
  • After deploying, watch the Switch History for a week. If the bot's switching every few hours, your regime thresholds are too sensitive — widen them. If it never switches, they're too tight — narrow them.
  • For DEX-side regime orchestration (wallet-connected, swaps via CoW/Velora), see DEX Conditional Bot — same logic, different execution layer.