Skip to main content

Managing Your Trailing Bots

Learn how to effectively manage your trailing stop 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
  • Configuration can still be edited
  • No trading activity
  • Ready to deploy or backtest

What you can do:

  • Review configuration settings
  • Edit any parameters
  • Delete the bot
  • Start the bot (moves to Running status)
  • Run backtest

Use case:

You've created a trailing bot and want to backtest it
or review the parameters before activating it for trading.

Running​

What it means:

  • Bot is actively trading
  • Monitoring market for entry signals
  • Managing open positions with trailing stops
  • Cannot edit configuration

What you can do:

  • Monitor performance in real-time
  • View position status and P&L
  • Pause the bot (moves to Paused status)
  • Stop the bot (moves to Stopped status)

What's happening:

Position Phase 1 - Entry:
Bot enters position at current market price

Position Phase 2 - Initial Protection:
Initial stop loss active until activation profit reached

Position Phase 3 - Trailing Active:
Once activation profit hit, trailing stop follows price

Position Phase 4 - Exit:
Trailing stop triggered OR take profit hit → Position closed

Position Phase 5 - Re-entry:
Based on re-entry strategy, bot may enter new position

Paused​

What it means:

  • Bot temporarily halted
  • Current position remains open
  • Stop loss protection still active
  • No new entries will be made

What you can do:

  • Resume trading (moves back to Running)
  • Stop the bot completely
  • Monitor existing position

Use case:

Major market news pending, you want to:
- Keep current position and protection
- But prevent new entries
- Resume after news settles
note

Paused bots maintain existing positions and their trailing stops but won't enter new trades.

Stopped​

What it means:

  • Bot completely deactivated
  • No trading activity
  • Position closed (if any was open)
  • Historical data preserved

What you can do:

  • Restart with same configuration
  • Edit configuration (returns to Draft)
  • Delete the bot
  • Review historical performance

What happens to your position:

If position was open:
- Position closed at market price
- Trailing stop is cancelled
- Final P&L recorded
- Funds returned to available balance

If no position:
- Bot simply stops
- Ready to restart or edit
warning

Stopping a bot will close any open position immediately at market price, not at your trailing stop level.

Bot Actions​

Starting a Bot​

Prerequisites:

  • Bot must be in Draft status
  • Sufficient exchange balance available
  • Valid API connection (for live mode)

Steps:

  1. Navigate to bot detail page
  2. Review configuration parameters
  3. Verify trailing stop settings
  4. Click "Start Bot" button
  5. Confirm in the dialog popup
  6. Bot begins monitoring for entry

What happens:

1. System validates configuration
2. Bot status changes to "Running"
3. Begins monitoring market price
4. Waits for entry signal or immediate entry (based on strategy)
5. Once entry conditions met, opens position
6. Initial stop loss immediately active
7. Trailing begins after activation profit reached
warning

Once started, the bot will enter positions with real money. Ensure you've tested thoroughly in paper trading mode first.

Pausing a Bot​

When to pause:

  • Temporary market uncertainty
  • Major news event pending
  • Want to prevent new entries but keep position
  • Short-term risk management

Steps:

  1. Go to bot detail page
  2. Click "Pause" button
  3. Confirm the action

What happens:

- Bot stops entering new positions
- Existing position remains open
- Trailing stop continues to protect
- Initial or trailing stop loss still active
- You can resume anytime

Example scenario:

BTC at $60,000, your bot in position at $58,000
Activation profit hit, trailing at $59,100 (5% trail)
News: Fed announces interest rate decision in 2 hours

Action: Pause bot to prevent new entry if stopped out
Result: Current position protected, but won't re-enter during volatility
Resume: After news settles and direction is clear
tip

Use pause when you want to keep your current position and its protection, but want to prevent the bot from taking new positions.

Stopping a Bot​

When to stop:

  • Strategy is no longer profitable
  • Want to reallocate capital
  • Major market regime change
  • Need to close position immediately
  • Ending the trading session

Steps:

  1. Click "Stop Bot" button
  2. Review the warning message
  3. Understand that any open position will be closed
  4. Confirm stop action

Warning message:

⚠️ This will close any open positions
Any active position will be closed immediately at market price.
Your trailing stop will be cancelled.
Historical data will be preserved.

What happens:

1. Any open position closed at market price
2. Bot status changes to "Stopped"
3. No more trading activity
4. P&L finalized and recorded
5. Capital returned to available balance
6. Historical data preserved

After stopping:

Your Capital:
- Available balance updated with closed position value
- Realized profit/loss recorded
- Bot can be restarted or edited
- Historical trades preserved for review
tip

Before stopping, check your current position P&L. You might want to wait for a better exit if position is temporarily down.

Editing a Bot​

Important: You can only edit bots in Draft status.

To edit a running bot:

  1. Stop the bot first (closes any position)
  2. Status changes to "Stopped"
  3. Click "Edit" button
  4. Modify any parameters
  5. Click "Save" (bot returns to Draft)
  6. Start the bot again with new settings

Editable parameters:

  • Bot name and description
  • Trailing stop type and value
  • Activation profit
  • Initial stop loss
  • Take profit settings
  • Re-entry strategy
  • All configuration settings

What gets reset:

- Configuration updated
- Bot ready for fresh start
- Previous position history preserved
- Performance metrics maintained
caution

Editing a bot requires stopping it first, which closes any open position. Only edit when you're ready to exit the current trade.

Deleting a Bot​

Prerequisites:

  • Bot must be in Stopped status
  • Any position already closed
  • You've documented any important information

Steps:

  1. Stop the bot (if not already stopped)
  2. Click "Delete" button in bot actions menu
  3. Confirm deletion in dialog
  4. Bot is permanently removed

What happens:

✅ Bot configuration deleted
✅ Historical data preserved (for reference)
✅ No impact on your exchange balance
✅ All capital returned to available balance

What's preserved:

  • Trade history (for your records)
  • Performance metrics
  • Profit/loss data
  • Backtest results
warning

Deletion is permanent! Make sure you've closed any position and documented important learnings before deleting.

Bot Management Dashboard​

Summary Statistics​

At the top of the Trailing Bots page, you'll see:

Active Bots

  • Number of currently running bots
  • Indicates how many strategies are live
  • Shows bots in position vs waiting for entry

Paused Bots

  • Temporarily halted bots
  • Quick reference for paused strategies
  • May have open positions

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
  • From closed positions only

Total Trades

  • Number of completed position cycles
  • Entry → Exit = 1 trade
  • Indicates strategy activity level

Average APR

  • Annualized Percentage Rate across all bots
  • Quick performance benchmark
  • Compare against holding (HODL)

Position Management​

Understanding Position States​

No Position (Waiting for Entry)

Status: Monitoring market
Stop Loss: None (not in position)
Action: Waiting for entry signal
Your Risk: Zero (no capital deployed yet)

Position Open - Before Activation

Status: In position
Entry: $50,000
Current Price: $52,000 (+4%)
Stop Loss: $47,500 (initial stop at -5%)
Trailing: Not active yet (needs +10% activation)
Your Risk: Limited to initial stop (-5%)

Position Open - Trailing Active

Status: In position with trailing
Entry: $50,000
Peak: $58,000
Current Price: $57,500
Trailing Stop: $54,150 (5% below peak)
Protection: +8.3% profit locked in
Your Risk: Can only lose if drops >6% from current

Position Closed

Status: Out of position
Exit: $56,000
Entry was: $50,000
Profit: +$6,000 (+12%)
Next Action: Based on re-entry strategy

Monitoring Open Positions​

Key Metrics to Watch:

Current Position

Entry Price: Where you bought
Entry Time: When position opened
Position Size: Amount of asset held
Current Price: Real-time market price
Unrealized P&L: Current profit/loss

Stop Protection

Current Stop: Either initial or trailing
Distance to Stop: How far price can drop
Protection Level: Profit currently locked in
Peak Reached: Highest price since entry

Activation Status

Activation Target: Profit % needed for trailing to start
Current Progress: How close to activation
Status: "Initial Stop" or "Trailing Active"

Example Display:

Position: OPEN
Entry: $50,000 @ Jan 15, 10:30 AM
Current: $57,800 (+15.6%)
Peak: $58,500 (+17%)

Stop Protection:
Type: Trailing Active ✓
Trailing Stop: $55,575 (5% below peak)
Locked Profit: +11.2%

Re-entry Strategy: Pullback
Next Entry: If drops below $55,575

Multi-Bot Management​

Running Multiple Trailing Bots​

Benefits:

  • Diversification across assets
  • Different risk profiles simultaneously
  • Hedge directional bets
  • Multiple strategies in parallel

Best practices:

Bot 1: BTC Conservative (40% capital)
- 7% trailing stop
- 15% activation
- Lower risk

Bot 2: ETH Moderate (30% capital)
- 5% trailing stop
- 10% activation
- Balanced approach

Bot 3: ALT Aggressive (20% capital)
- 3% trailing stop
- 8% activation
- Higher risk/reward

Reserve: 10% for opportunities

Capital Allocation​

Portfolio approach:

Total Capital: $10,000

Allocation:
- BTC Trailing: $4,000 (40%)
- ETH Trailing: $3,000 (30%)
- ALT Trailing: $2,000 (20%)
- Reserve: $1,000 (10%) - for rebalancing

Dynamic Allocation:

As profits accumulate:
- Let winners grow position size
- Reduce or stop underperformers
- Rebalance monthly
- Maintain reserve fund

Monitoring Multiple Bots​

Daily checklist:

  • Check overall dashboard metrics
  • Review each bot's position status
  • Identify any stopped/closed positions
  • Check trailing stop distances
  • Verify no error messages
  • Note any activation profit hits

Weekly review:

  • Compare bot performance
  • Identify best/worst performers
  • Check win rates per bot
  • Review re-entry patterns
  • Adjust underperforming bots
  • Rebalance if needed

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
  • Backtested the strategy
  • Paper traded successfully
  • Checked current market conditions
  • Confirmed sufficient balance
  • Set appropriate stops and trailing
  • Documented strategy reasoning
  • Understood risk/reward

During Operation​

Do:

  • ✅ Monitor daily (at minimum)
  • ✅ Check position status regularly
  • ✅ Watch trailing stop movement
  • ✅ Track activation profit hits
  • ✅ Keep exchange API keys secure
  • ✅ Document observations
  • ✅ Let strategy work (don't interfere)

Don't:

  • ❌ Stop bot impulsively during drawdowns
  • ❌ Edit parameters mid-position
  • ❌ Ignore trailing stop triggers
  • ❌ Overleverage with too many bots
  • ❌ Chase losing positions
  • ❌ Second-guess the strategy

When to Intervene​

Stop the bot if:

  • Strategy consistently losing
  • Market conditions drastically changed
  • Multiple failed trades in a row
  • Better opportunity identified
  • Need capital elsewhere
  • System/exchange issues

Pause the bot if:

  • Major news event pending
  • Want to prevent new entries temporarily
  • Currently in good position, want to hold
  • Short-term uncertainty
  • Testing strategy modification

Keep running if:

  • Performing as expected
  • Within normal win/loss pattern
  • Trailing stops working properly
  • No technical issues
  • Market conditions still suitable

Troubleshooting Bot States​

Bot Stuck in Draft​

Possible causes:

  • Insufficient balance
  • Invalid configuration
  • API connection error
  • Exchange connectivity issue

Solutions:

  1. Check error messages in bot details
  2. Verify exchange balance
  3. Test API connection
  4. Review configuration parameters
  5. Try reducing investment amount

Bot Not Entering Positions​

Possible causes:

  • Waiting for favorable entry
  • Market conditions not met
  • Price moving too fast
  • Insufficient balance at entry time

Solutions:

  1. Check current market price
  2. Verify bot is actually "Running"
  3. Review entry strategy settings
  4. Check exchange balance is sufficient
  5. Wait patiently (good entries take time)

Position Closed Unexpectedly​

Possible causes:

  • Trailing stop triggered (normal behavior)
  • Initial stop loss hit
  • Take profit target reached
  • Exchange issues
  • API connection lost

Solutions:

  1. Check Performance tab for exit reason
  2. Review timeline of events
  3. Verify stop levels were appropriate
  4. Check if take profit was hit
  5. Review error logs if system issue

Bot Auto-Stopped​

Possible causes:

  • API connection lost
  • Exchange error
  • System error
  • Balance insufficient during operation

Solutions:

  1. Check performance tab for trigger reason
  2. Review error logs
  3. Verify API keys still valid
  4. Check exchange status
  5. Restart if appropriate

Position Closure Scenarios​

Understanding why positions close:

Trailing Stop Triggered (Most Common)​

Entry: $50,000
Peak: $60,000
Trail: 5%
Trigger: Price drops to $57,000
Exit: $57,000
Profit: +14%

This is NORMAL and DESIRED behavior
The trailing stop did its job!

Initial Stop Loss Hit​

Entry: $50,000
Initial Stop: -5% = $47,500
Price drops to: $47,500
Exit: $47,500
Loss: -5%

Activation profit never reached
Initial stop protected from larger loss

Take Profit Reached​

Entry: $50,000
Take Profit: 30% = $65,000
Price hits: $65,000
Exit: $65,000 immediately
Profit: +30%

Overrides trailing stop
Locked in target profit

Manual Stop​

You clicked "Stop Bot"
Exit: Current market price
Reason: Manual intervention
Result: Position closed immediately

Next Steps​

Learn how to effectively monitor and optimize your trailing bot performance:

→ Monitoring Performance

Learn how to troubleshoot common issues:

→ Troubleshooting