Troubleshooting Guide

Solutions to common issues and problems in Nimbus automated trading

Common Issues and Solutions

This troubleshooting guide addresses the most frequently encountered issues in Nimbus. Use this guide to quickly diagnose and resolve problems with your automated trading strategies.

Strategy Issues

Problems with strategy execution and performance

Connection Problems

Exchange connectivity and API issues

Performance Issues

Slow performance and optimization problems

Account Issues

Account setup and authentication problems

Strategy-Related Issues

Strategy Not Executing Trades

Check Strategy Status

Verify your strategy is active and properly configured

Common Causes:

• Strategy is paused or stopped
• Insufficient account balance
• Risk limits exceeded
• Market conditions don’t meet entry criteria

Solutions:

1. Navigate to Strategy Dashboard
2. Check strategy status indicator
3. Review recent activity logs
4. Verify account balance exceeds minimum requirements
5. Check risk management settings

Insufficient Balance

Your account doesn’t have enough funds to execute trades

Error Messages:

• “Insufficient balance for trade execution”
• “Account balance below minimum threshold”
• “Not enough collateral for position”

Solutions:

{
  "troubleshooting_steps": [
    "Check current account balance",
    "Review minimum balance requirements",
    "Add funds to your account",
    "Reduce position sizes in strategy settings",
    "Adjust risk parameters to lower requirements"
  ]
}

Risk Limits Exceeded

Strategy stopped due to risk management controls

Common Triggers:

• Daily loss limit reached
• Maximum drawdown exceeded
• Position size limit violated
• Correlation limits breached

Resolution Steps:

1. Review risk management dashboard
2. Check which limit was exceeded
3. Adjust risk parameters if appropriate
4. Wait for daily limits to reset
5. Consider strategy modifications

Poor Strategy Performance

High Slippage

Trades executing at worse prices than expected Symptoms: - Large difference between expected and actual fill prices - Reduced profitability compared to backtests - Frequent partial fills Causes and Solutions: - Low Liquidity Assets: Switch to more liquid trading pairs - Large Position Sizes: Reduce position sizes relative to market volume - Market Volatility: Adjust order types and timing - Poor Timing: Avoid trading during low volume periods

Frequent Stop-Loss Triggers

Strategies getting stopped out too frequently Analysis Steps: mermaid graph TD A[Frequent Stops] --> B[Check Volatility] A --> C[Review Stop Distance] A --> D[Analyze Entry Quality] B --> B1[High Volatility Period?] B1 --> B2[Widen Stops Temporarily] C --> C1[Stops Too Tight?] C1 --> C2[Use ATR-Based Stops] D --> D1[Poor Entry Timing?] D1 --> D2[Add Confirmation Filters] Solutions: - Use volatility-adjusted stop losses - Implement multiple confirmation signals - Consider market regime in stop placement - Review and optimize entry criteria

Low Win Rate

Strategy winning fewer trades than expected Diagnostic Questions: - Is this a new market regime? - Have market conditions changed? - Are entry signals still valid? - Is the strategy over-optimized? Improvement Actions: 1. Market Analysis: Check if current conditions match strategy assumptions 2. Signal Quality: Review and potentially add filters 3. Parameter Adjustment: Consider modest parameter changes 4. Portfolio Approach: Diversify across multiple strategies

Strategy Configuration Errors

Invalid Parameter Values

Strategy fails to start due to configuration issues

Common Errors:

{
  "parameter_errors": {
    "position_size": "Cannot exceed 100% of account",
    "stop_loss": "Must be positive value less than 50%",
    "take_profit": "Must be greater than stop loss",
    "timeframe": "Unsupported timeframe selected",
    "indicators": "Period cannot be greater than available data"
  }
}

Validation Checklist:

Conflicting Strategy Rules

Contradictory entry/exit conditions preventing execution

Examples:

• Entry requires RSI < 30 AND RSI > 70 (impossible)
• Long and short signals triggered simultaneously
• Stop loss set above entry price for long positions

Resolution:

1. Review all strategy conditions systematically
2. Test logic with sample data
3. Simplify complex rule sets
4. Use strategy validation tools

Exchange and API Issues

Connection Problems

API Connection Failed

Cannot connect to exchange APIs

Error Messages:

• “Connection timeout”
• “API key authentication failed”
• “Exchange unreachable”
• “SSL certificate error”

Troubleshooting Steps:

1. Check Exchange Status: Verify exchange is operational
2. API Key Validation: Ensure keys are correct and active
3. Network Connectivity: Test internet connection
4. Firewall Settings: Check for blocking rules
5. Rate Limiting: Verify not exceeding API limits

API Rate Limiting

Requests being throttled by exchange

Symptoms:

• Delayed order execution
• “Rate limit exceeded” errors
• Partial data updates
• Increased latency

Solutions:

{
  "rate_limit_fixes": {
    "reduce_frequency": "Lower update frequencies",
    "batch_requests": "Combine multiple requests",
    "upgrade_account": "Higher tier accounts get more requests",
    "distribute_load": "Use multiple API keys if allowed",
    "optimize_calls": "Cache data when possible"
  }
}

Authentication Errors

API key or authentication issues

Common Causes:

• Expired API keys
• Incorrect permissions
• IP address restrictions
• Wrong passphrase or secret

Resolution Steps:

1. Regenerate API Keys: Create new keys with proper permissions
2. Check Permissions: Ensure trading permissions enabled
3. IP Whitelist: Add current IP to allowed list
4. Test Connection: Use exchange’s API testing tools

Order Execution Issues

Orders Not Filling

Orders placed but not executing

Possible Reasons:

• Price moved away from limit order
• Insufficient liquidity at price level
• Order size too large for market
• Exchange technical issues

Diagnostic Steps:

Partial Fills

Orders only partially executed

Understanding Partial Fills:

• Large orders may fill in multiple parts
• Normal in illiquid markets
• Can affect strategy performance

Management Strategies:

• Accept Partials: Allow partial fills for large orders
• Size Reduction: Use smaller order sizes
• Time Limits: Set maximum time for order completion
• Iceberg Orders: Break large orders into smaller pieces

Price Slippage

Significant difference between expected and actual fill prices

Slippage Causes:

• Market volatility
• Low liquidity
• Large order sizes
• Network latency

Mitigation Techniques:

1. Limit Orders: Use limit orders instead of market orders
2. Size Management: Reduce order sizes in volatile markets
3. Timing: Avoid trading during low liquidity periods
4. Slippage Tolerance: Set acceptable slippage limits

Performance and Technical Issues

Slow Performance

Dashboard Loading Slowly

Web interface taking too long to load

Quick Fixes:

• Clear browser cache and cookies
• Disable browser extensions
• Try incognito/private browsing mode
• Switch to different browser
• Check internet connection speed

Advanced Solutions:

• Reduce chart timeframe or indicators
• Limit number of strategies displayed
• Close unnecessary browser tabs
• Restart browser or device

Strategy Execution Delays

Trades executing later than expected

Latency Sources:

{
  "latency_breakdown": {
    "signal_generation": "1-5 seconds",
    "strategy_processing": "0.1-1 seconds", 
    "order_routing": "0.1-0.5 seconds",
    "exchange_processing": "0.1-2 seconds",
    "network_latency": "0.01-0.1 seconds"
  }
}

Optimization Tips:

• Use faster execution modes
• Simplify strategy logic
• Reduce number of indicators
• Choose closer server locations

High CPU/Memory Usage

System resources being overutilized

Resource Optimization:

Data Issues

Missing Price Data

Gaps or missing data in charts and analysis Common Causes: - Exchange downtime - Network connectivity issues - Data provider problems - Maintenance periods Solutions: 1. Data Backfill: Request historical data refresh 2. Multiple Sources: Use backup data providers 3. Cache Management: Clear data cache and reload 4. Time Adjustment: Check timezone settings

Incorrect Indicators

Technical indicators showing unexpected values Verification Steps:

Error Messages and Codes

Common Error Codes

Error Code Reference

| Error Code | Description | Solution | |------------|-------------|----------| | 1001 | Invalid API Key | Regenerate API key with proper permissions | | 1002 | Insufficient Balance | Add funds or reduce position size | | 1003 | Rate Limit Exceeded | Reduce request frequency | | 2001 | Strategy Validation Failed | Check strategy parameters | | 2002 | Risk Limit Violated | Adjust risk settings | | 3001 | Exchange Connection Lost | Check network and exchange status | | 3002 | Order Rejected | Verify order parameters | | 4001 | Data Feed Interrupted | Check data provider status | | 5001 | System Maintenance | Wait for maintenance completion |

Exchange-Specific Errors

Different exchanges may return unique error messages Hyperliquid Common Errors: - “Insufficient margin”: Need more collateral - “Invalid size”: Order size outside allowed range - “Rate limited”: Too many requests - “Market closed”: Trading not available General Exchange Errors: - “Symbol not found”: Invalid trading pair - “Order not found”: Order already filled or cancelled - “Precision error”: Incorrect decimal places - “Minimum size”: Order below minimum amount

Diagnostic Tools

Built-in Diagnostics

Strategy Health Check

Use Nimbus’s built-in diagnostic tools Health Check Items:

Accessing Diagnostics: 1. Navigate to Strategy Dashboard 2. Click “Health Check” button 3. Review all diagnostic results 4. Follow recommended actions

Connection Testing

Test exchange connectivity and API functionality Test Components: - Network latency measurement - API authentication verification - Market data feed quality - Order routing functionality - Error handling capabilities Running Tests: bash # Example diagnostic commands curl -X GET "https://api.hyperliquid.xyz/info" # Test basic connectivity ping api.hyperliquid.xyz # Check network latency

Performance Monitoring

Monitor system and strategy performance metrics Key Metrics: - Order execution latency - Strategy signal generation time - Data feed reliability

• System resource usage - Network connectivity quality Monitoring Dashboard: - Real-time performance graphs - Historical trend analysis - Alert configuration - Comparative benchmarks

Getting Additional Help

Support Resources

Documentation and Guides

Comprehensive resources for learning and troubleshooting Available Resources: - User Manual: Complete feature documentation - Video Tutorials: Step-by-step visual guides - FAQ Database: Common questions and answers - Best Practices: Recommended approaches - API Documentation: Technical integration guides

Community Support

Connect with other users and experts Community Channels: - Discord Server: Real-time chat and support - Telegram Groups: Strategy discussions - Reddit Community: Tips and experiences - YouTube Channel: Educational content - Blog and Updates: Latest features and news

Direct Support

Contact Nimbus support team Support Channels: - Email Support: [e-mail] - Live Chat: Available during business hours - Ticket System: Track support requests - Priority Support: Available for premium users Before Contacting Support:

Preparing for Support

Information to Gather

Collect relevant information before contacting support System Information: - Operating system and version - Browser type and version - Internet connection speed - Time zone and location Account Information:

• Account email address - Subscription tier - Connected exchanges - Affected strategies Issue Details: - Exact error messages - Steps to reproduce - When issue first occurred - Screenshots or screen recordings

Effective Communication

How to communicate issues clearly for faster resolution Best Practices:

1. Be Specific: Provide exact error messages 2. Include Context: Describe what you were trying to do 3. Provide Examples: Include specific trades or strategies 4. Be Patient: Allow time for investigation 5. Follow Up: Provide additional information if requested Sample Support Request: ``` Subject: Strategy not executing trades - Error 2001 Hello, I’m experiencing an issue with my DCA strategy on BTC/USDT. The strategy shows as “Active” but hasn’t executed any trades for the past 3 hours. Error message: “Strategy Validation Failed - Error Code 2001” Strategy details: - Name: BTC DCA Conservative - Exchange: Hyperliquid

• Position size: 1% of account - Account balance: $10,000 Screenshots attached showing the error and strategy settings. Please help resolve this issue. Best regards, [Your name] ```

Preventive Measures

Best Practices for Avoiding Issues

Next Steps

Strategy Building Guide

Learn to build robust strategies that avoid common issues

Risk Management Best Practices

Implement proper risk controls to prevent problems

Getting Started

Review setup fundamentals to ensure proper configuration

Support

Contact support for additional assistance