Managing Your Grid Bots
Learn how to effectively manage your grid trading bots throughout their lifecycle, from creation to deletion.
Bot Status Lifecycle
Understanding bot statuses helps you manage them effectively.
Draft
What it means:
- Bot is created but not yet active
- Orders are calculated but not placed on exchange
- Configuration can still be edited
- No trading activity
What you can do:
- Review configuration settings
- Edit any parameters
- Delete the bot
- Start the bot (moves to Running status)
Use case:
You've created a bot and want to review the grid visualization
and order placement before activating it.
Running
What it means:
- Bot is actively trading
- Orders are placed on the exchange
- Automatic buy/sell execution happening
- Cannot edit configuration
What you can do:
- Monitor performance in real-time
- View order status and fills
- Pause the bot (moves to Paused status)
- Stop the bot (moves to Stopped status)
What's happening:
Buy orders fill → Sell orders placed above
Sell orders fill → Buy orders placed below
Continuous profit capture as price oscillates
Paused
What it means:
- Bot temporarily halted
- Existing orders remain on exchange
- No new orders are placed
- Positions maintained
What you can do:
- Resume trading (moves back to Running)
- Stop the bot completely
- Monitor existing positions
Use case:
Market conditions changed temporarily, you want to pause
without cancelling all orders and losing your positions.
note
Paused bots keep orders active but won't place new ones. Useful for temporary holds during major news events.
Stopped
What it means:
- Bot completely deactivated
- All orders cancelled from exchange
- No trading activity
- Positions remain (not auto-sold)
What you can do:
- Restart with same configuration
- Edit configuration (returns to Draft)
- Delete the bot
- Review historical performance
What happens to your positions:
- Orders are cancelled
- You keep any filled positions (crypto you bought/sold)
- Positions are not automatically closed
- You can manually sell or hold
Bot Actions
Starting a Bot
Prerequisites:
- Bot must be in Draft status
- Sufficient exchange balance available
- Valid API connection (for live mode)
Steps:
- Navigate to bot detail page
- Review the grid visualization
- Verify order placement looks correct
- Click "Start Bot" button
- Confirm in the dialog popup
- Orders are immediately placed on exchange
What happens:
1. System validates configuration
2. Calculates all grid levels
3. Places buy orders below current price
4. Places sell orders above current price
5. Bot status changes to "Running"
6. 24/7 automated trading begins
warning
Once started, orders are placed immediately on the exchange. Ensure you've reviewed all settings carefully.
Pausing a Bot
When to pause:
- Temporary market uncertainty
- Major news event pending
- Want to review strategy without cancelling orders
- Short-term risk management
Steps:
- Go to bot detail page
- Click "Pause" button
- Confirm the action
What happens:
- Bot stops placing new orders
- Existing orders remain active on exchange
- Filled orders are not replaced
- You can resume anytime
Example scenario:
Bitcoin at $50,000 in your $40k-$60k grid
News: Fed announces interest rate decision in 2 hours
Action: Pause bot to avoid new positions during volatility
Result: Existing orders stay, but no new orders placed
Resume: After news settles and direction is clear
Stopping a Bot
When to stop:
- Market has broken out of your range
- Strategy is no longer profitable
- Want to reallocate capital
- Ending the trading session
Steps:
- Click "Stop Bot" button
- Review the warning message
- Understand that all pending orders will be cancelled
- Confirm stop action
Warning message:
⚠️ This will cancel all active orders
All pending and partially filled orders will be cancelled immediately.
Your current positions will remain unchanged.
What happens:
1. All pending orders cancelled from exchange
2. Bot status changes to "Stopped"
3. No more trading activity
4. Positions you hold remain (not sold)
5. Historical data preserved
After stopping:
Your Positions:
- Keep any BTC you bought
- Keep any USDT from sells
- Manually manage these positions
- Or restart bot to continue
tip
Before stopping, check your current positions. You may be holding more of one asset than the other, which affects your portfolio balance.
Editing a Bot
Important: You can only edit bots in Draft status.
To edit a running bot:
- Stop the bot first
- Status changes to "Stopped"
- Click "Edit" button
- Modify any parameters
- Click "Save" (bot returns to Draft)
- Start the bot again with new settings
Editable parameters:
- Trading pair
- Price range (upper/lower)
- Grid count
- Investment amounts
- Strategy type
- All advanced settings
What gets reset:
- All order calculations redone
- Grid levels recalculated
- New orders will be placed
- Previous order history preserved
caution
Editing a bot requires stopping it first, which cancels all orders. Plan edits during low-volatility periods.
Deleting a Bot
Prerequisites:
- Bot must be in Stopped status
- All orders already cancelled
- You've documented any important information
Steps:
- Stop the bot (if not already stopped)
- Click "Delete" button in bot actions menu
- Confirm deletion in dialog
- Bot is permanently removed
What happens:
✅ Bot configuration deleted
✅ Historical data preserved (for reference)
✅ No impact on your exchange balance
✅ Positions you hold remain unchanged
What's preserved:
- Trade history (for your records)
- Performance metrics
- Profit/loss data
warning
Deletion is permanent! Make sure you've closed or managed any positions from this bot before deleting.
Bot Management Dashboard
Summary Statistics
At the top of the Grid Bots page, you'll see:
Active Bots
- Number of currently running bots
- Indicates how many strategies are live
Paused Bots
- Temporarily halted bots
- Quick reference for paused strategies
Total Investment
- Sum of capital allocated across all bots
- Converted to USD for easy comparison
- Helps track overall exposure
Total Profit
- Realized profit across all bots
- Shows actual earnings captured
- Excludes unrealized P&L
Total Trades
- Number of completed trade cycles
- Higher number indicates active market conditions
- Helps gauge strategy effectiveness
Average APR
- Annualized Percentage Rate across all bots
- Quick performance benchmark
- Compare against holding (HODL)
Multi-Bot Management
Running Multiple Bots
Benefits:
- Diversification across pairs
- Different strategies simultaneously
- Hedge market directional risk
Best practices:
Strategy 1: BTC/USDT Grid (50% capital)
- Conservative: ±20% range, 15 grids
Strategy 2: ETH/USDT Grid (30% capital)
- Moderate: ±25% range, 20 grids
Strategy 3: ALT/USDT Grid (20% capital)
- Aggressive: ±30% range, 25 grids
Capital Allocation
Portfolio approach:
Total Capital: $10,000
Allocation:
- BTC Grid: $4,000 (40%)
- ETH Grid: $3,000 (30%)
- Stable Grid: $2,000 (20%)
- Reserve: $1,000 (10%) - for opportunities
Monitoring Multiple Bots
Daily checklist:
- Check overall dashboard metrics
- Review each bot's current status
- Identify any stopped/errored bots
- Check if any hit take profit/stop loss
- Verify orders are filling as expected
Weekly review:
- Compare bot performance
- Identify best/worst performers
- Adjust underperforming bots
- Rebalance capital allocation
- Check for new opportunities
Status Transitions
Valid Transitions
Draft → Running (Start bot)
Running → Paused (Pause bot)
Running → Stopped (Stop bot)
Paused → Running (Resume bot)
Paused → Stopped (Stop bot)
Stopped → Draft (Edit bot)
Stopped → Running (Restart bot)
Draft → Deleted (Delete bot)
Stopped → Deleted (Delete bot)
Invalid Transitions
❌ Running → Draft (Must stop first)
❌ Running → Deleted (Must stop first)
❌ Draft → Paused (Must start first)
Best Practices
Before Starting
Checklist:
- Verified all configuration parameters
- Reviewed grid visualization
- Checked current market conditions
- Confirmed sufficient balance
- Set appropriate stop loss
- Documented strategy reasoning
During Operation
Do:
- ✅ Monitor daily (at minimum)
- ✅ Check after major market moves
- ✅ Keep exchange API keys secure
- ✅ Maintain sufficient balance for fees
- ✅ Document performance observations
Don't:
- ❌ Make impulsive changes
- ❌ Edit bots during high volatility
- ❌ Ignore stop loss signals
- ❌ Overleverage with too many bots
- ❌ Forget about running bots
When to Intervene
Stop the bot if:
- Price breaks out of range and continues trending
- Consistent losses over 2+ weeks
- Major market regime change (bull to bear)
- Exchange issues or API problems
- Need capital for other opportunities
Pause the bot if:
- Temporary uncertainty (major news pending)
- Want to review without losing positions
- Short-term risk management
- Testing if issue resolves itself
Keep running if:
- Price oscillating within range
- Consistent profitability
- Normal market conditions
- Strategy working as expected
Troubleshooting Bot States
Bot Stuck in Draft
Possible causes:
- Insufficient balance
- Invalid configuration
- API connection error
Solutions:
- Check error messages
- Verify exchange balance
- Test API connection
- Review configuration parameters
Bot Auto-Stopped
Possible causes:
- Hit stop loss threshold
- Hit take profit threshold
- API connection lost
- Exchange error
Solutions:
- Check performance tab for trigger reason
- Review error logs
- Verify API keys still valid
- Restart if appropriate
Orders Not Filling
Possible causes:
- Price outside grid range
- Low liquidity
- Orders placed but not visible
Solutions:
- Check current price vs grid range
- Verify orders on exchange directly
- Review bot status (should be "Running")
- Check exchange for order status
Next Steps
Learn how to effectively monitor and optimize your grid bot performance: