Feature Priority

What it does
When multiple features want to affect the same order at the same time, at most one multiplier wins. Deficit rebalancing is the exception: it stacks on top of whatever multiplier is active. This page defines the exact rules so you can predict how the bot will behave when features are active together.
GridBT has several features that modify order sizing: Exo Indicator, Hedge Guard, Rebalancer, Position Balancer, and PnD Protection.

OPEN-side priority

OPEN orders (the ones that build position) can be affected by three features. They are evaluated in this order:
  1. Hedge Guard (highest priority): if Hedge Guard is active, its multiplier is applied and Exo Indicator is skipped entirely. Hedge Guard replaces the indicator, it does not stack on top of it.
  2. Exo Indicator: if Hedge Guard is not active and indicator conditions are met, the indicator multiplier is applied.
  3. Deficit rebalancing (stacks): if the bot detects a position deficit, rebalancing amplification is added on top of whichever multiplier is active (Hedge Guard or Exo Indicator).
Why deficit stacks instead of yields
Deficit is triggered when the bot detects missed OPEN orders, typically from downtime or PnD cooldown. An unaddressed deficit means the bot is running fewer OPEN orders than the grid expects, which can make pure grid profit go negative. Because of this, deficit correction is treated as urgent and stacks on top of any existing OPEN amplification rather than waiting for it to clear.
In formula form:
OPEN order size = (base x activeMultiplier) + rebalanceAmplification
Where activeMultiplier is either the Hedge Guard multiplier or the Exo Indicator multiplier (never both), and rebalanceAmplification is the per-fill correction from deficit rebalancing (zero if no deficit exists). If neither Hedge Guard nor Exo Indicator is active, activeMultiplier = 1.0 and the formula reduces to base + rebalanceAmplification.

Example

Setup: orderSizeUsd = $10  ·  deficit amplification = $2.50/fill ($50 deficit at 5% distribution rate)
Active featureCalculationOPEN order size
Exo Indicator($10 × 1.25) + $2.50$15.00
Hedge Guard($10 × 1.50) + $2.50$17.50
Hedge Guard and Exo Indicator are mutually exclusive. If both would qualify, Hedge Guard wins and Exo is skipped.

CLOSE-side priority

CLOSE orders (the ones that reduce position) can be affected by two features:
  1. Excess rebalancing (highest priority): if the bot is correcting excess inventory, rebalancing amplification is applied to CLOSE orders. Position Balancer is disabled while this is active.
  2. Position Balancer: if excess rebalancing is not running and profit/utilization conditions are met, the Position Balancer tier multiplier is applied.
Excess rebalancing and Position Balancer never run at the same time. Rebalancing takes priority because correcting inventory drift is more urgent than accelerating profit-taking.

Example

Setup: orderSizeUsd = $10
Active featureCalculationCLOSE order size
Excess rebalancing$10 + $3.00 amplification ($60 excess at 5% rate)$13.00
Position Balancer$10 × 1.50$15.00
Excess rebalancing and Position Balancer are mutually exclusive. Rebalancing always takes priority.

PnD protection overrides OPEN orders

When PnD Protection is active, OPEN orders are suppressed entirely, regardless of what amplification would otherwise apply. If Hedge Guard, Exo Indicator, and deficit rebalancing would all produce an amplified OPEN order, PnD cooldown still blocks it.
CLOSE orders are never blocked by PnD protection. Reducing exposure is always allowed.

Exposure Freeze overrides the larger side

When net exposure breaches the configured limit, the larger side can enter Exposure Freeze. The affected side stops placing OPEN orders and only places safe reduce-only CLOSE orders from the frozen trigger price. The smaller side can continue normal OPEN and CLOSE behavior because growing it reduces net exposure.
Exposure Freeze does not override Profit Lock. If Profit Lock is triggered for the pair, Profit Lock owns the symbol until its reduce flow finishes or is manually handled.

Quick reference

FeatureAffectsPriorityHow it combines
Hedge GuardOPENHighestReplaces Exo Indicator multiplier
Exo IndicatorOPENSecondApplied when Hedge Guard is not active
Deficit rebalancingOPENStacksAdded on top of Hedge Guard or Exo Indicator
Excess rebalancingCLOSEHighestBlocks Position Balancer
Position BalancerCLOSESecondApplied when excess rebalancing is not active
PnD cooldownOPENOverrideSuppresses all OPEN orders
Exposure FreezeLarger side OPEN and CLOSESafety overrideBlocks OPEN orders and allows only safe reduce-only CLOSE orders
Profit LockBoth sidesSymbol lockTakes priority over Exposure Freeze while triggered

Key rules to remember

  • Hedge Guard and Exo Indicator are mutually exclusive. Hedge Guard always wins.
  • Deficit rebalancing stacks with whichever OPEN multiplier is active.
  • Excess rebalancing and Position Balancer are mutually exclusive. Rebalancing always wins.
  • PnD cooldown suppresses OPEN orders regardless of any other feature.
  • CLOSE orders are never blocked by PnD protection.
  • Exposure Freeze keeps the larger side reduce-only until exposure recovers or the freeze is cleared while stopped.
  • Profit Lock takes priority over Exposure Freeze for the same pair.
  • Each feature change (activation, deactivation, tier change) triggers a grid reconstruction. Outstanding orders are cancelled and replaced with correctly sized ones. No fills are lost.