ScreenerBot
DocsTrading GuidesTrading Controls

Trading Controls

Advanced controls for managing automated trading: emergency stops, independent monitor management, and period-based loss limits for comprehensive risk protection.

Overview

Control Your Trading

ScreenerBot provides granular control over automated trading through three key features:

Force Stop

Emergency halt for all trading operations

Monitor Controls

Independent entry/exit monitor toggles

Loss Limit

Period-based loss protection

Force Stop Everything

Emergency Trading Halt

The Force Stop button immediately halts all trading operations. This is your emergency brake for situations requiring instant control.

When to Use: Market crash, unexpected volatility, security concern, or any situation where you need to immediately stop all trading activity.

What Gets Stopped

  • Entry Monitor (no new positions)
  • Exit Monitor (no automatic exits)
  • Manual Trading (buy/sell blocked)
  • Swap Execution (all swaps halted)
  • DCA Operations (no averaging buys)

What Continues Running

  • Web Dashboard (full access)
  • Events System (logging continues)
  • Core Services (pools, tokens, OHLCV)
  • Position Tracking (P&L updates)
  • Price Monitoring (real-time prices)
Resuming Trading: After a Force Stop, you must explicitly resume trading from the dashboard. Navigate to the Trader Control page and click the Start button. This intentional design prevents accidental resumption.

Location: Dashboard → Trader Control → Force Stop button (prominent red button at top of page)

Independent Monitor Controls

Entry & Exit Monitor Toggles

Control the Entry Monitor and Exit Monitor independently. This flexibility enables advanced trading workflows like wind-down mode or research-only operation.

Entry Monitor

Scans for opportunities

Continuously evaluates tokens that pass your filters for entry signals based on configured strategies.

  • • Checks passed tokens every cycle
  • • Respects position limits
  • • Evaluates strategy conditions
  • • Executes buy orders on signals

Exit Monitor

Manages open positions

Watches all open positions and executes exits based on ROI targets, stop losses, trailing stops, and time overrides.

  • • Monitors P&L in real-time
  • • Triggers stop losses
  • • Manages trailing stops
  • • Executes profit targets

Common Use Cases

Wind-Down Mode

Stop entries, let exits manage positions

Entry Monitor: OFF

Exit Monitor: ON

Use when you want to close out existing positions without opening new ones.

Research Mode

Entries only, manual exit control

Entry Monitor: ON

Exit Monitor: OFF

Use when testing entry strategies while maintaining manual control over exits.

Full Automation

Complete hands-free trading

Entry Monitor: ON

Exit Monitor: ON

Standard operation: bot finds entries and manages all exits automatically.

Manual Only

Full manual control

Entry Monitor: OFF

Exit Monitor: OFF

Use when you want to manually control all trading decisions.

Dashboard Visibility: The Trader Control page shows the status of each monitor with clear ON/OFF toggles. Status indicators update in real-time so you always know exactly what's running.

Period Loss Limit Protection

Automatic Loss Control

Protect your capital with configurable maximum loss limits per time period. When cumulative realized losses exceed your threshold, the entry monitor automatically pauses while exit monitor continues protecting open positions.

How It Works: Set a maximum loss (e.g., 2 SOL per 24 hours). If your realized losses hit that limit, the bot stops opening new positions until the period resets. This prevents emotional trading and protects against cascading losses.

Configuration Options

Configure loss limit settings in Dashboard → System → Config under the Trader section.

Loss Limit Enabled

Master switch for loss limit protection

trader.loss_limit_enabled

Default: false

Loss Limit (SOL)

Maximum allowed loss in SOL per period

trader.loss_limit_sol

Example: 2.0 (2 SOL max loss)

Period Duration (Hours)

Time window for loss calculation

trader.loss_limit_period_hours

Common: 1, 6, 24 hours

Auto Resume

Automatically resume when period resets

trader.loss_limit_auto_resume

Default: true

Dashboard Indicator

When loss limit protection is enabled, the dashboard displays a progress bar showing:

  • Current Period Loss: Cumulative realized losses in the current period
  • Limit Progress: Visual bar showing how close you are to the limit
  • Time Remaining: Countdown until the current period resets
  • Status: Active (trading) or Paused (limit reached)

Example Configurations

Conservative

Loss Limit: 1 SOL

Period: 24 hours

Auto Resume: false

Tight daily limit, requires manual review to resume

Moderate

Loss Limit: 2 SOL

Period: 24 hours

Auto Resume: true

Standard protection with automatic daily reset

Active Trader

Loss Limit: 0.5 SOL

Period: 6 hours

Auto Resume: true

Shorter periods for frequent monitoring

Best Practices

Recommendations

  • Set a Loss Limit: Even experienced traders benefit from automatic circuit breakers. Start with a limit you're comfortable with.
  • Use Wind-Down Mode: When stepping away, disable entries but keep exits active to protect open positions.
  • Know Your Force Stop: Familiarize yourself with the Force Stop button location before you need it. In emergencies, speed matters.
  • Review After Pause: When loss limits trigger, use it as a signal to review your strategy before resuming.
  • Start Conservative: Begin with tighter limits and shorter periods, then adjust as you learn your trading patterns.