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:
- Agent Profile - Basic agent information (name, ID)
- 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 Profile Section
The Profile section contains basic agent information that you can modify.
Agent Name
Edit your agent's display name:
| Field | Details |
|---|---|
| Required | Yes |
| Maximum length | 255 characters |
| Auto-save | Changes save automatically after 1.5 seconds |
The agent name appears:
- In the Agent Switcher dropdown
- On the dashboard
- In all agent-related pages
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:
| Tab | Description |
|---|---|
| Position | Position sizing, purchase limits, and price impact protection |
| Signals | Configure which signals your agent chooses to execute trades on |
| Stop Loss | Stop loss strategy and configuration |
| DCA | Dollar cost averaging settings |
| Stale Trade | Stale trade detection and closure settings |
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:
| Setting | Description | Default |
|---|---|---|
| Position Size Percentage | Percentage 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 Threshold | Balance 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
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 Settings
Basic Settings
| Setting | Description | Default |
|---|---|---|
| Enabled | Enable/disable stop loss protection | Yes |
| Default Percentage | Stop 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
| Setting | Description | Default |
|---|---|---|
| Enabled | Enable/disable DCA purchases | Yes |
| Mode | DCA mode (Aggressive, Moderate, Conservative, Custom) | Moderate |
| Cooldown | Minimum time between DCA purchases (in hours) | 1 hour |
| Max Count | Maximum number of DCA purchases per position | 3 |
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:
- Position drops below average purchase price
- Check if drop percentage matches a DCA level
- Verify cooldown period has passed since last DCA
- Verify max DCA count hasn't been reached
- 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
| Setting | Description | Default |
|---|---|---|
| Enabled | Enable/disable stale trade detection | Yes |
| Profit Target | Minimum profit percentage required to avoid stale trade closure (0-100%) | 20% |
| Time Limit (Hours) | Maximum hours a position can remain open without reaching profit target | 168 hours (7 days) |
How it works:
- Position is created and timer starts
- If position reaches profit target within time limit → Position stays open (no stale trade)
- 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 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:
| Feature | Details |
|---|---|
| Save trigger | Changes save automatically after 1.5 seconds of inactivity |
| Status indicator | Shows "Saving...", "Saved", or "Save failed" in header |
| No manual save | No save button needed - all changes are automatic |
| Form validation | Invalid 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.






