Troubleshooting

Help & Support · Updated 2026-07-27

Common Issues

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

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

See Buy Options and Copy Trading for the full gate model.

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

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

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

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

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)

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 for system status and announcements