# Troubleshooting Guide

This comprehensive troubleshooting guide helps you resolve common issues and get back to trading quickly. Most problems have simple solutions, and this guide covers the most frequent issues users encounter.

## Wallet Connection Issues

### Wallet Not Connecting

**Symptoms:** Wallet connection fails, authentication errors, or wallet not recognized.

**Solutions:**

1. **Refresh the Page:** Simple page refresh often resolves temporary connection issues
2. **Clear Browser Cache:** Clear your browser's cache and cookies, then try again
3. **Check Wallet Status:** Ensure your wallet is unlocked and connected to the correct network
4. **Update Wallet:** Make sure you're using the latest version of your wallet
5. **Try Different Browser:** Test with a different browser to isolate browser-specific issues
6. **Check Network:** Ensure you have a stable internet connection

**Advanced Solutions:**

* Disable browser extensions temporarily
* Check if your antivirus or firewall is blocking the connection
* Try incognito/private browsing mode
* Reset wallet connection permissions

### Authentication Failures

**Symptoms:** Login messages fail to sign, authentication timeouts, or signature errors.

**Solutions:**

1. **Check Wallet Balance:** Ensure you have sufficient ETH for gas fees
2. **Increase Gas Limit:** Some wallets allow you to increase gas limits for transactions
3. **Try Different Wallet:** Test with a different wallet to isolate the issue
4. **Check Network:** Ensure you're connected to the correct network (Ethereum mainnet)
5. **Restart Wallet:** Close and reopen your wallet application

### Permission Errors

**Symptoms:** Wallet requests permissions but connection still fails.

**Solutions:**

1. **Reset Permissions:** Disconnect and reconnect your wallet
2. **Check Wallet Settings:** Ensure the wallet allows connections to external sites
3. **Update Permissions:** Manually approve all required permissions
4. **Clear Site Data:** Remove stored site data and reconnect

## Trading Issues

### Bot Not Executing Trades

**Symptoms:** Bot is running but not placing orders, or orders are not being filled.

**Solutions:**

1. **Check Market Hours:** Ensure markets are open and liquid
2. **Verify Strategy Logic:** Review your strategy parameters and entry conditions
3. **Check Risk Limits:** Ensure you haven't hit daily loss limits or position limits
4. **Verify Balance:** Confirm you have sufficient balance for trading
5. **Check Network Status:** Verify Hyperliquid network is operational

**Advanced Troubleshooting:**

* Review bot logs for error messages
* Check if strategy conditions are being met
* Verify order size is within minimum/maximum limits
* Test with paper trading first

### Orders Not Filling

**Symptoms:** Orders are placed but not executing, or partial fills only.

**Solutions:**

1. **Check Order Type:** Ensure you're using appropriate order types for market conditions
2. **Adjust Price:** Consider using market orders or adjusting limit order prices
3. **Check Liquidity:** Verify sufficient liquidity exists for your order size
4. **Review Slippage:** Set appropriate slippage tolerance for volatile markets
5. **Check Market Conditions:** Some strategies work better in certain market conditions

### Strategy Performance Issues

**Symptoms:** Strategy is executing but not performing as expected.

**Solutions:**

1. **Review Backtest Results:** Compare live performance to backtest expectations
2. **Check Market Regime:** Ensure current market conditions match backtest period
3. **Adjust Parameters:** Fine-tune strategy parameters based on live performance
4. **Monitor Risk Controls:** Ensure risk management isn't overly restrictive
5. **Check Data Quality:** Verify market data feeds are accurate and timely

## Platform Performance Issues

### Slow Loading or Freezing

**Symptoms:** Platform loads slowly, freezes, or becomes unresponsive.

**Solutions:**

1. **Check Internet Connection:** Ensure stable, high-speed internet connection
2. **Close Other Tabs:** Close unnecessary browser tabs to free up memory
3. **Restart Browser:** Close and reopen your browser
4. **Clear Cache:** Clear browser cache and cookies
5. **Check System Resources:** Ensure your device has sufficient RAM and processing power

**Advanced Solutions:**

* Disable browser extensions
* Try a different browser
* Check for browser updates
* Restart your device

### Data Not Updating

**Symptoms:** Prices, charts, or other data not updating in real-time.

**Solutions:**

1. **Refresh the Page:** Simple refresh often resolves data sync issues
2. **Check Connection:** Ensure stable internet connection
3. **Clear Cache:** Clear browser cache to force fresh data load
4. **Check Time Settings:** Ensure your device time is correct
5. **Try Different Browser:** Test with a different browser

### Mobile App Issues

**Symptoms:** iOS app crashes, won't load, or features not working.

**Solutions:**

1. **Update App:** Ensure you're using the latest version from the App Store
2. **Restart App:** Force close and reopen the app
3. **Restart Device:** Restart your iPhone or iPad
4. **Check Storage:** Ensure sufficient storage space is available
5. **Reinstall App:** Delete and reinstall the app if issues persist

## Strategy Lab Issues

### Backtest Not Running

**Symptoms:** Backtest fails to start or produces errors.

**Solutions:**

1. **Check Data Range:** Ensure selected date range has sufficient data
2. **Verify Parameters:** Check that all required parameters are set correctly
3. **Reduce Complexity:** Simplify strategy if it's too complex for backtesting
4. **Check Market Data:** Ensure historical data is available for selected period
5. **Try Different Timeframe:** Test with different timeframes or date ranges

### Paper Trading Issues

**Symptoms:** Paper trading not working or producing unexpected results.

**Solutions:**

1. **Check Mode:** Ensure you're in paper trading mode, not live trading
2. **Verify Balance:** Check simulated balance is sufficient for trading
3. **Review Strategy:** Ensure strategy logic is correct for paper trading
4. **Check Market Data:** Verify live market data is being received
5. **Restart Paper Trading:** Stop and restart paper trading if needed

### Strategy Optimization Problems

**Symptoms:** Optimization fails or produces unrealistic results.

**Solutions:**

1. **Check Parameter Ranges:** Ensure parameter ranges are realistic
2. **Reduce Complexity:** Simplify strategy for optimization
3. **Check Data Quality:** Ensure high-quality historical data
4. **Adjust Optimization Settings:** Modify optimization parameters
5. **Try Different Methods:** Test different optimization algorithms

## Risk Management Issues

### Stop Loss Not Triggering

**Symptoms:** Stop loss orders not executing when price targets are hit.

**Solutions:**

1. **Check Order Type:** Ensure stop loss is properly configured
2. **Verify Price Levels:** Check that stop loss levels are realistic
3. **Check Market Conditions:** Ensure sufficient liquidity for stop execution
4. **Review Risk Settings:** Verify risk management parameters
5. **Test with Paper Trading:** Validate stop loss logic with paper trading

### Position Limits Not Working

**Symptoms:** Bot exceeds position limits or risk parameters.

**Solutions:**

1. **Check Settings:** Verify position limit configurations
2. **Review Strategy Logic:** Ensure strategy respects position limits
3. **Check Risk Controls:** Verify all risk management systems are active
4. **Monitor Closely:** Watch for any system overrides
5. **Adjust Limits:** Modify position limits if needed

## Notification Issues

### Not Receiving Alerts

**Symptoms:** Mobile notifications not appearing or delayed.

**Solutions:**

1. **Check App Permissions:** Ensure notification permissions are enabled
2. **Check Device Settings:** Verify notification settings in iOS settings
3. **Check Internet Connection:** Ensure stable connection for push notifications
4. **Restart App:** Force close and reopen the app
5. **Check Notification Settings:** Verify alert preferences in app settings

### Too Many Notifications

**Symptoms:** Receiving excessive or irrelevant notifications.

**Solutions:**

1. **Adjust Settings:** Modify notification preferences in app settings
2. **Filter Alerts:** Set up notification filters for important events only
3. **Check Frequency:** Adjust notification frequency settings
4. **Review Strategy:** Ensure strategy isn't generating too many signals
5. **Customize Alerts:** Set up custom alert conditions

## Data and Analytics Issues

### Charts Not Displaying

**Symptoms:** Price charts not loading or displaying incorrectly.

**Solutions:**

1. **Refresh Page:** Simple refresh often resolves chart issues
2. **Check Data Range:** Ensure selected time range has data
3. **Clear Cache:** Clear browser cache to force fresh data load
4. **Check Browser:** Try different browser if issues persist
5. **Check Network:** Ensure stable internet connection

### Performance Metrics Incorrect

**Symptoms:** P\&L, win rate, or other metrics showing incorrect values.

**Solutions:**

1. **Check Data Source:** Verify data is coming from correct source
2. **Review Calculation Period:** Ensure metrics are calculated over correct time period
3. **Check Strategy Logic:** Verify strategy is calculating metrics correctly
4. **Refresh Data:** Force refresh of performance data
5. **Contact Support:** If metrics seem consistently incorrect

## When to Contact Support

Contact our support team if:

* **Critical Issues:** Trading is completely blocked or funds are at risk
* **Persistent Problems:** Issues that persist after trying basic solutions
* **Data Inconsistencies:** Performance metrics or data that seem incorrect
* **Security Concerns:** Any suspicious activity or security-related issues
* **Feature Requests:** Suggestions for new features or improvements

## Prevention Tips

**Regular Maintenance:**

* Keep your browser and wallet updated
* Clear cache regularly
* Monitor your strategies closely
* Review risk settings periodically

**Best Practices:**

* Always test strategies with paper trading first
* Start with small position sizes
* Monitor performance regularly
* Keep backups of successful strategies
* Stay informed about platform updates

## Emergency Procedures

**If Trading is Completely Blocked:**

1. Stop all active bots immediately
2. Check your wallet connection
3. Contact emergency support
4. Monitor your positions manually

**If You Suspect a Security Issue:**

1. Stop all trading immediately
2. Disconnect your wallet
3. Contact security support
4. Change your wallet passwords
5. Monitor your accounts closely

> **Remember:** Most issues have simple solutions. Start with basic troubleshooting steps before contacting support, and always test changes with paper trading first.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://quantsedge.gitbook.io/quantsedge-docs/help-and-support/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.