Signals Configuration
Signal configuration controls which trading signals your agent responds to. This guide explains how to filter signals by strength, type, and token address.
Overview
Signal configuration consists of three main settings:
- Signal Strength - Minimum strength threshold (1-5) for signals
- Signal Types - Which signal types to accept (buy, sell, custom)
- Token Filter - Blacklist or whitelist specific tokens
Access signal configuration in Agent Configuration > Trading Strategy > Signals tab.
Signal Strength
What It Is
Signal strength filtering sets a minimum quality threshold. Only signals meeting or exceeding this threshold trigger trades.
How It Works
- Signal arrives with a strength rating (1-5)
- Compare to threshold — Is signal strength ≥ configured minimum?
- Accept or reject — Process if meets threshold, ignore otherwise
Configuration
| Setting | Description | Default | Range |
|---|---|---|---|
| Minimum Signal Strength | Signals below this are ignored | 1 | 1-5 |
The slider displays strength levels from "1 (Weakest)" to "5 (Strongest)".
Strength Levels Explained
| Strength | Meaning | Agent Behavior |
|---|---|---|
| 1 | Very weak | Usually filtered out by most configs |
| 2 | Weak | Low confidence signal |
| 3 | Moderate | Standard threshold (recommended) |
| 4 | Strong | High confidence signal |
| 5 | Very strong | Maximum confidence |
Recommended Settings
| Strategy | Min Strength | Use Case |
|---|---|---|
| Aggressive | 1-2 | Trade on any signal, maximum opportunities |
| Balanced | 3 | Standard filtering (recommended) |
| Conservative | 4-5 | Only high-confidence signals, fewer trades |
Higher minimum strength means fewer trades but potentially higher quality entries. Start with 3 and adjust based on results.
Signal Types
What It Is
Control which types of signals your agent responds to. By default, all signal types are accepted.
How It Works
- Signal arrives with a type (e.g., "BUY", "Hypersurge", "Breakout confirmation")
- Check allowed types — Is this type in the allowed list?
- Accept or reject — Process if type is allowed, ignore otherwise
Configuration
| Setting | Description | Default |
|---|---|---|
| Allowed Signal Types | List of signal types to respond to | Empty (all accepted) |
Available Signal Types
Select from common preset types:
| Type | Description |
|---|---|
BUY | Standard buy signal |
Hypersurge | High-momentum detection |
Breakout confirmation | Breakout validation |
Price Reversal | Potential trend reversals |
Custom Signal Types
For signals from your own systems:
- Select "Other (custom)..." from the dropdown
- Enter your custom type name (e.g., "my-trading-bot")
- Click Add
This allows you to create signals with custom types from your API and only respond to those specific signals.
Managing Signal Types
- Add: Select from dropdown or enter custom type
- Remove: Click the X on any badge to remove it
- View: Selected types appear as badges above the dropdown
When no signal types are selected, the agent accepts ALL signal types. Add specific types to filter.
Configuration Examples
Accept All Signal Types
Configuration: Empty list (default)
Behavior: Agent responds to any signal type
Use case: General trading, accepting signals from multiple sources
Token Filter
What It Is
Control which tokens your agent will trade. Use blacklists to block specific tokens, or whitelists to only trade specific tokens.
Filter Modes
| Mode | Icon | Behavior |
|---|---|---|
| No Filter | Shield (muted) | Accept signals for any token (default) |
| Blacklist | Shield Off | Block specific tokens, accept all others |
| Whitelist | Shield | Only accept specific tokens, block all others |
No Filter Mode
Behavior: Agent responds to signals for any token address.
Configuration: No additional setup needed.
Use case: General trading without token restrictions.
Blacklist Mode
Block specific tokens from trading:
- Select Blacklist mode
- Enter the Solana token address (32-44 characters)
- Click Add
Behavior: Agent trades any token except those in the blacklist.
Use case:
- Block known scam tokens
- Exclude tokens with bad historical performance
- Prevent trading specific tokens you want to avoid
Whitelist Mode
Only trade specific tokens:
- Select Whitelist mode
- Enter the Solana token address (32-44 characters)
- Click Add
Behavior: Agent only trades tokens in the whitelist.
Use case:
- Focus on specific tokens you've researched
- Create a curated trading list
- Dedicated agent for specific token strategies
Switching between blacklist and whitelist modes clears your token list. Copy addresses before switching if needed.
Token Address Requirements
| Requirement | Details |
|---|---|
| Minimum length | 32 characters |
| Maximum length | 44 characters |
| No duplicates | Each address can only appear once |
| Valid format | Must be a valid Solana token mint address |
Managing Token Lists
Adding tokens:
- Enter address in the input field
- Click Add or press Enter
- Token appears in the list below
Removing tokens:
- Click the X button next to any token address
Viewing tokens:
- Tokens display in a table with full address (monospace font)
- Empty state shows "No tokens added yet"
Token Filter Examples
No Filter (Default)
Mode: No Filter
Token List: Empty
Behavior: Agent responds to signals for any token
Alert message: "Your agent will respond to signals for any token address."
Configuration Best Practices
Choosing Signal Strength
| Use Case | Recommended Setting |
|---|---|
| Testing new signal source | 1 (accept all, analyze results) |
| Production trading | 3 (balanced filtering) |
| High-value account | 4-5 (only strong signals) |
Managing Signal Types
| Strategy | Recommendation |
|---|---|
| Single signal source | Filter to that source's type only |
| Multiple signal sources | Leave empty (accept all) or add all relevant types |
| Custom integration | Use unique custom type for your signals |
Token Filter Strategy
| Strategy | Mode | Use Case |
|---|---|---|
| General trading | No Filter | Accept all tokens |
| Risk management | Blacklist | Block known bad tokens |
| Focused trading | Whitelist | Only trade researched tokens |
| Token-specific agent | Whitelist (1 token) | Dedicated agent per token |
Consider creating multiple agents with different token filters for different strategies (e.g., one for memecoins, one for established tokens).
Complete Configuration Examples
Example 1: Accept Everything
"I want to trade any signal"
Configuration:
- Signal Strength: 1
- Signal Types: Empty (all)
- Token Filter: No Filter
Example 2: High-Quality Signals Only
"Only strong signals from my bot"
Configuration:
- Signal Strength: 4
- Signal Types:
[my-custom-bot] - Token Filter: No Filter
Example 3: Curated Token List
"Only trade specific tokens I've researched"
Configuration:
- Signal Strength: 3
- Signal Types: Empty (all)
- Token Filter: Whitelist with researched tokens
Example 4: Block Known Scams
"Trade anything except bad tokens"
Configuration:
- Signal Strength: 3
- Signal Types:
[BUY] - Token Filter: Blacklist with known scam addresses
Common Questions
What if I set strength to 5?
Behavior: Only signals with strength = 5 trigger trades. This is very restrictive and may result in few or no trades depending on your signal source.
Recommendation: Start with 3, then increase if you're getting too many low-quality signals.
Do signal sources always include strength?
Yes. All signals must include a signalStrength value (1-5). If creating signals via API, you must specify the strength.
Can I change strength without affecting open positions?
Yes. Changing signal strength only affects future signals. Existing positions are not impacted.