OS Trading Engine
Platform Guide
Agents
Agent Configuration

Agent Configuration

The Agent Configuration page allows you to customize your agent's profile information and all trading strategy settings. Changes are saved automatically as you make them.

Overview

The Agent Configuration page is divided into two main sections:

  1. Agent Profile - Basic agent information (name, ID)
  2. Trading Strategy - All trading configuration settings organized in tabs

Access the page by navigating to Agent Configuration > Profile & Strategy in the sidebar, or visit /dashboard/agent-profile.

Agent Configuration Page
Agent Configuration page showing profile and trading strategy sections

Agent Profile Section

The Profile section contains basic agent information that you can modify.

Agent Name

Edit your agent's display name:

FieldDetails
RequiredYes
Maximum length255 characters
Auto-saveChanges save automatically after 1.5 seconds

The agent name appears:

  • In the Agent Switcher dropdown
  • On the dashboard
  • In all agent-related pages
Agent Profile Section
Profile section showing agent name and ID fields

All changes in the Profile section save automatically. You'll see a "Saving..." indicator when changes are being saved, and "Saved" confirmation when complete.


Trading Strategy Section

The Trading Strategy section contains all trading configuration settings, organized in tabs for easy navigation:

TabDescription
PositionPosition sizing, purchase limits, and price impact protection
SignalsConfigure which signals your agent chooses to execute trades on
Stop LossStop loss strategy and configuration
DCADollar cost averaging settings
Stale TradeStale trade detection and closure settings
Trading Strategy Tabs
Trading strategy section with tab navigation

Like the Profile section, all Trading Strategy changes save automatically with a 1.5 second debounce. No manual save button needed!


Position Tab

The Position tab controls how much your agent spends on trades, position sizing, and price impact protection. These settings work together to manage your capital allocation and protect against slippage.

Position Sizing

Controls how positions are sized based on available balance:

SettingDescriptionDefault
Position Size PercentagePercentage of available balance to use per position (0-100%). Example: 50% means half your balance per position.50%
Position Size Percentage (Larger Balances)Position size percentage when balance exceeds the larger balance threshold. Allows smaller position sizes for larger balances.25%
Larger Balance ThresholdBalance amount (in SOL) where the larger balance percentage kicks in.10.0 SOL

How it works:

  • If balance is below threshold → Use Position Size Percentage
  • If balance is above threshold → Use Position Size Percentage (Larger Balances)

Example:

  • Balance: 5 SOL, Position Size: 50% → Each position uses 2.5 SOL
  • Balance: 15 SOL, Larger Balance Threshold: 10 SOL, Larger Position Size: 25% → Each position uses 3.75 SOL
Position Sizing
Position sizing configuration with balance threshold

Signals Tab

The Signals tab enables you to configure which signals your agent chooses to execute trades on.

Signals Overview

Configure signal filtering to control which trading signals trigger trades for your agent:

  • Minimum Signal Strength — Filter signals by strength (1-5)
  • Signal Types — Select which signal types to trade
  • Token Filter — Blacklist or whitelist specific tokens

See Trading Signals for details on signal filtering.


Stop Loss Tab

The Stop Loss tab configures how your agent protects positions from losses.

Stop Loss Overview

Stop loss automatically closes positions when prices drop to protect your investment. Configure:

  • Stop loss mode (Fixed, Exponential, Zones, Custom)
  • Default percentage
  • Mode-specific settings

For detailed explanations of each mode, see Stop Loss Modes.

Stop Loss Configuration
Stop loss configuration showing mode selector and settings

Stop Loss Settings

Basic Settings

SettingDescriptionDefault
EnabledEnable/disable stop loss protectionYes
Default PercentageStop loss percentage used below 20% gain (negative = below purchase price)-32%

How it works:

  • Below 20% gain → Default percentage applies
  • Above 20% gain → Trailing stop loss (mode-dependent) applies

The default percentage prevents stop loss from triggering on normal volatility for small gains.


DCA Tab

The DCA (Dollar Cost Averaging) tab configures automatic additional purchases when positions drop in value.

DCA Overview

DCA automatically buys more of a token when its price drops below your average purchase price, lowering your average cost basis.

DCA Settings

SettingDescriptionDefault
EnabledEnable/disable DCA purchasesYes
ModeDCA mode (Aggressive, Moderate, Conservative, Custom)Moderate
CooldownMinimum time between DCA purchases (in hours)1 hour
Max CountMaximum number of DCA purchases per position3
DCA Configuration
DCA configuration showing mode selector and settings

DCA Modes

Moderate Mode

Balanced DCA levels with moderate capital usage.

Levels:

  • Level 1: -10% drop → Buy 33% of original
  • Level 2: -20% drop → Buy 50% of original
  • Level 3: -30% drop → Buy 75% of original

Best for: Most traders, balanced approach.

DCA Behavior

How DCA works:

  1. Position drops below average purchase price
  2. Check if drop percentage matches a DCA level
  3. Verify cooldown period has passed since last DCA
  4. Verify max DCA count hasn't been reached
  5. Execute DCA purchase if all conditions met

Important:

  • DCA only triggers when price is below average purchase price
  • Cooldown prevents rapid consecutive purchases
  • Max count prevents unlimited DCA purchases
  • Each DCA purchase recalculates the weighted average price

Stale Trade Tab

The Stale Trade tab configures automatic closure of positions that haven't met profit targets within a time limit.

Stale Trade Overview

Stale trade detection closes positions that haven't reached their profit target within a specified time period, freeing up capital for better opportunities.

Stale Trade Settings

SettingDescriptionDefault
EnabledEnable/disable stale trade detectionYes
Profit TargetMinimum profit percentage required to avoid stale trade closure (0-100%)20%
Time Limit (Hours)Maximum hours a position can remain open without reaching profit target168 hours (7 days)

How it works:

  1. Position is created and timer starts
  2. If position reaches profit target within time limit → Position stays open (no stale trade)
  3. If time limit expires without reaching profit target → Position is closed (stale trade)

Example:

  • Profit Target: 20%
  • Time Limit: 168 hours (7 days)
  • If position doesn't reach 20% gain within 7 days → Position closes automatically
Stale Trade Configuration
Stale trade configuration showing profit target and time limit

Stale Trade Behavior

Important considerations:

  • Stale trade detection applies to all positions regardless of current profit/loss
  • Timer starts from position creation, not from last DCA purchase
  • Positions that reach the profit target are exempt from stale trade closure
  • Stale trades free up capital for new opportunities

Best practices:

  • Set profit target based on your typical position gains
  • Adjust time limit based on your trading timeframe (short-term vs. long-term)
  • Monitor stale trade closures to fine-tune settings

Auto-Save Feature

All configuration changes save automatically:

FeatureDetails
Save triggerChanges save automatically after 1.5 seconds of inactivity
Status indicatorShows "Saving...", "Saved", or "Save failed" in header
No manual saveNo save button needed - all changes are automatic
Form validationInvalid values prevent saving until corrected

Save status indicators:

  • "Saving..." - Changes are being saved
  • "Saved" - Changes saved successfully (displays for 2 seconds)
  • "Save failed" - Error occurred, please check your settings
⚠️

If you see "Save failed", check for form validation errors (red text under fields). Fix any errors and the form will save automatically once valid.


Common Questions

Can I change my agent name?

Yes! Edit the agent name in the Profile section. Changes save automatically.

Can I delete my agent?

Agent deletion is available through your agent settings. See your platform's agent management features.

What is the Agent ID used for?

The Agent ID is a unique identifier for API calls, webhooks, and technical troubleshooting. You can copy it using the copy button.