What do SetLeverageStartup and SetMaxLeverage do?

Leverage Synchronization & Startup Enforcement

These settings ensure that your exchange leverage configuration remains synchronized with your bot configuration.

They prevent one of the most dangerous futures trading mistakes:

Bot leverage ≠ Exchange leverage

If mismatched, real exposure may be dramatically higher than expected — which can wipe an account rapidly.

⚙️ Configuration

SetLeverageStartup: false   # Apply configured leverage to ALL symbols at startup
SetMaxLeverage: false       # Force symbols to use maximum allowed leverage
Leverage: 10                # Default futures leverage

1️⃣ Why This Is Critical

Example misconfiguration:

  • Exchange leverage manually set to 100x
  • Bot Leverage set to 10x
  • SetLeverageStartup disabled

The bot calculates risk assuming 10x.

The exchange executes trades at 100x.

This results in:

  • Liquidation occurring ~10× faster than expected
  • Invalid risk calculations
  • Unexpected account wipeout

Leverage mismatch is one of the most common causes of sudden futures account failures.

2️⃣ What Does SetLeverageStartup Do?

SetLeverageStartup: true

When enabled, the bot will:

  • Connect to the exchange at startup
  • Apply the configured Leverage value
  • Update leverage for all synchronized symbols
  • Override any manual exchange configuration

This guarantees:

Bot Leverage = Exchange Leverage

🔎 When Should You Enable It?

  • After changing leverage (e.g., 10x → 15x)
  • When running the bot for the first time
  • If unsure about current exchange leverage settings
  • After resetting or re-syncing symbols

After synchronization is confirmed, disable it to avoid unnecessary updates on every startup.

3️⃣ What Does SetMaxLeverage Do?

SetMaxLeverage: true

When enabled, the bot will:

  • Detect the maximum leverage allowed per symbol
  • Automatically apply that maximum value

⚠️ This is an aggressive configuration.

Some exchanges allow:

  • 75x leverage
  • 100x leverage
  • 125x leverage

If enabled, the bot will use the maximum available.

Not recommended unless:

  • Running short-term scalping strategies
  • Using very small allocated capital
  • Fully aware of liquidation mechanics

🚨 Risk Amplification Warning

High leverage combined with:

  • Dynamic trade sizing
  • Martingale scaling
  • DCA multipliers
  • Cross margin

Can multiply exposure exponentially.

5% Dynamic Sizing
× 4x Martingale
× 20x Leverage
× Cross Margin

This configuration can escalate liquidation risk extremely quickly during volatility spikes.

🔄 Recommended Safe Procedure When Changing Leverage

Step 1 — Stop the Bot

Completely shut down the bot.

Step 2 — Update Configuration

Leverage: 15

Step 3 — Reset Symbols

Edit symbols.json:

{
  "symbols": []
}

Keep the parent structure intact, remove all symbol entries.

Step 4 — Enable Symbol Sync

SyncSymbolsOnStartup: true

Run the bot until symbols.json is recreated and populated.
Then stop the bot.

Step 5 — Enable Leverage Synchronization

SetLeverageStartup: true

Run the bot.

The bot will:

  • Update leverage across all synchronized symbols
  • This process may take several minutes

After completion, stop the bot again.

Step 6 — Disable Startup Enforcement

SetLeverageStartup: false

Restart the bot normally.

Your leverage is now fully synchronized and controlled.

❌ What You Should NOT Do

  • Do not manually adjust leverage per symbol on the exchange
  • Do not mix manual exchange changes with bot configuration
  • Do not assume exchanges reset leverage automatically

Allow the bot to control leverage for consistency and predictable risk modeling.

📊 Risk Comparison

Scenario Risk Level
Leverage synced via bot ✅ Controlled
Manual exchange override ⚠️ Dangerous
Max leverage auto enabled 🚨 Very High
Mismatched bot vs exchange ❌ Critical Risk

🧠 Why Synchronization Matters

Futures exchanges store leverage per symbol.

If not synchronized:

  • Backtesting assumptions become invalid
  • Liquidation price calculations become inaccurate
  • Margin modeling breaks
  • Risk control becomes unpredictable

These settings ensure the bot operates with predictable, controlled exposure.

📌 Final Summary

SetLeverageStartup

  • Forces exchange leverage to match bot configuration
  • Prevents mismatch risk
  • Recommended when modifying leverage

SetMaxLeverage

  • Applies maximum exchange-allowed leverage
  • Highly aggressive
  • Use only for controlled, high-risk strategies

Used correctly, these settings:

  • Eliminate silent leverage mismatches
  • Ensure predictable liquidation levels
  • Maintain professional-grade risk governance

Used recklessly, they can accelerate account wipeout within minutes.

📎 Related Topics