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:
- 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.
- Exo Indicator: if Hedge Guard is not active and indicator conditions are met, the indicator multiplier is applied.
- 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 feature | Calculation | OPEN 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:
- 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.
- 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 feature | Calculation | CLOSE 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
| Feature | Affects | Priority | How it combines |
|---|---|---|---|
| Hedge Guard | OPEN | Highest | Replaces Exo Indicator multiplier |
| Exo Indicator | OPEN | Second | Applied when Hedge Guard is not active |
| Deficit rebalancing | OPEN | Stacks | Added on top of Hedge Guard or Exo Indicator |
| Excess rebalancing | CLOSE | Highest | Blocks Position Balancer |
| Position Balancer | CLOSE | Second | Applied when excess rebalancing is not active |
| PnD cooldown | OPEN | Override | Suppresses all OPEN orders |
| Exposure Freeze | Larger side OPEN and CLOSE | Safety override | Blocks OPEN orders and allows only safe reduce-only CLOSE orders |
| Profit Lock | Both sides | Symbol lock | Takes 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.
Exo Indicator
How the indicator triggers accumulation windows.
Hedge Guard
How Hedge Guard detects and corrects long/short imbalance.
Rebalancer
How deficit and excess rebalancing work.
Position Balancer
How profit-taking tiers accelerate close orders.
PnD Protection
How PnD cooldown suppresses OPEN orders during sharp moves.