# Troubleshooting

> Source: https://www.archr.bot/docs/troubleshooting
> Section: Help & Support
> Last updated: 2026-07-27

## Common Issues

### Auto-Buy Not Firing

Auto-buy uses multiple independent gates. A toggle can look ON in one menu while trades still do not execute.

1. Open **🤖 Auto** on the main menu → **🔍 Diagnostics**
2. Check the main menu label: **OFF** = master switch off; **SETUP** = something still blocking; **ACTIVE** = at least one path ready
3. **Signal auto-buy** needs all three: Global Auto-Trade, per-signal auto-buy (Signal Preferences), and execution-wallet auto-buy (Manage Wallets)
4. **Copy-trade auto-buy** needs all three: Global Auto-Trade, Copy Auto-Buy (Auto panel), and per-wallet Copy Trade ON
5. Confirm filters, balance (0.01 SOL minimum), and Auto-Buy Protection are not blocking the token
6. Check for a **low-balance pause** (see below)

See [Buy Options](/docs/buy-options) and [Copy Trading](/docs/copy-trading) for the full gate model.

### Auto-Buy Paused — Low Balance

If you see **“Auto-Buy Paused — Low Balance”**:

- ARCHR skipped the auto-buy so you’d keep enough SOL to sell existing positions (~0.01 SOL reserved per open position, including the new one)
- **Nothing was turned off** — deposit more SOL, lower buy amount, or close positions; auto-buy resumes when the wallet is sufficient again
- Manual buys still work (subject to the normal fee buffer)
- Use **💰 Deposit** on the alert, or open Wallet / Diagnostics on the Auto-Buy panel

See [Trading Settings → Low-Balance Auto-Buy Protection](/docs/trading-settings).

### Signal Reception Problems
- Check **Signal Preferences** (🚀 button on main menu or Settings → Signal Preferences) and verify the desired signal types have alerts enabled
- Ensure Telegram notifications are enabled for the bot in your device settings
- Confirm account has sufficient balance (0.01 SOL minimum for full access)
- Remember: alerts and auto-buy are independent toggles — having auto-buy on does not mean alerts are on

### Trading Execution Issues
- **Insufficient Balance**: Verify adequate SOL for trade and network fees
- **High Slippage**: Increase slippage tolerance for volatile tokens (Settings → Slippage)
- **Network Congestion**: Retry during lower network activity periods
- **Token Issues**: Check if token has trading restrictions, is delisted, or fails shield checks

### Balance Display Problems
- Tap **🔄 Refresh** on the main menu to pull the latest on-chain balance
- Check for pending transactions that may not have finalized
- Verify your active wallet is the one you expect (check Wallet menu)
- If using multiple wallets, the total balance line shows combined SOL across all wallets

### Position Tracking Issues
- Use position sync feature to reconcile with blockchain
- Check for ghost positions using cleanup tools
- Verify token addresses match actual holdings
- Use the live dashboard for most current position data

### AI Agent Issues
- **Agent not responding**: Verify your API key is set correctly in Settings → 🤖 Agent Mode → Set API Key
- **"Invalid API key" error**: Your key may be expired, revoked, or have insufficient credits. Generate a new key from your provider's dashboard.
- **Agent rate limited**: The agent has a 10 trade/day limit and a 30-second cooldown between trades. Wait and try again.
- **Slow responses**: Try switching to a faster model (e.g., Claude Haiku 4.5 or GPT-5.4 Mini)
- **Provider outage**: If your LLM provider is experiencing issues, try switching to the other provider (Anthropic ↔ OpenAI)

## Getting Help

### Built-In Support
- **Help Menu**: Comprehensive command reference and documentation (`/help` or ❓ Help button)
- **Feedback System**: Direct feedback submission to development team (`/feedback`)
- **Error Messages**: Detailed error descriptions with suggested solutions
- **Updates Channel**: [@archr_updates](https://t.me/archr_updates) for system status and announcements

### Documentation Resources
- **Complete User Guide**: https://docs.archr.bot
- **Command Reference**: Available through `/help` command
- **Video Tutorials**: [YouTube](https://www.youtube.com/@ARCHRdotbot)
- **FAQ**: Answers to frequently asked questions