Bot Issues
Troubleshooting guide for Signal Bot and Trading Bot problems.
Signal Bot Issues
Webhook Not Receiving Signals
Symptoms
- Webhook health indicator is yellow or red
- No trades executing despite sending signals
- TradingView shows alert fired but nothing happens
Diagnostic Steps
Step 1: Verify Webhook URL
Expected format:
https://www.tradestaq.com/api/webhooks/trade/{your-webhook-id}
| Check | How to Verify |
|---|---|
| Correct domain | Must be www.tradestaq.com |
| HTTPS | Must use https:// not http:// |
| Correct path | /api/webhooks/trade/ |
| Valid ID | 36-character UUID |
Step 2: Test Webhook Manually
Using curl:
curl -X POST https://www.tradestaq.com/api/webhooks/trade/YOUR-ID \
-H "Content-Type: application/json" \
-d '{"action":"buy","symbol":"BTCUSDT"}'
Expected success response:
{"success": true, "message": "Signal received"}
Step 3: Check TradingView Configuration
| Setting | Required Value |
|---|---|
| Webhook URL | Your TradeStaq webhook URL |
| Alert expires | Never (recommended) |
| Alert actions | Check all needed |
Invalid JSON Errors
Error:
Invalid webhook payload: Unexpected token...
Common JSON Mistakes:
| Wrong | Correct |
|---|---|
{action: "buy"} | {"action": "buy"} |
{'action': 'buy'} | {"action": "buy"} |
{"action": buy} | {"action": "buy"} |
Trailing comma {"action": "buy",} | {"action": "buy"} |
Validation Tool: Use jsonlint.com to validate.
Signal Received But Not Executed
Diagnostic Questions:
| Question | If No |
|---|---|
| Bot active? | Resume bot |
| Exchange connected? | Reconnect exchange |
| Sufficient balance? | Deposit funds |
| Valid symbol? | Check symbol format |
| Within rate limits? | Slow down signals |
Check Bot Logs:
- Go to Signal Bots
- Click on your bot
- View "Recent Signals" section
- Look for error messages
Duplicate Signals Ignored
Behavior: Same signal sent twice is ignored.
Why: Prevents accidental double-trades.
Deduplication Window: 5 seconds
Solution: If intentional, wait 5+ seconds between signals.
Trading Bot Issues
Bot Not Spinning
Symptoms:
- "Last Spin" shows old timestamp
- No new trades despite market movement
- Strategy not executing
Diagnostic Checklist:
| Check | Solution |
|---|---|
| Bot status | Must be "Active" |
| Exchange status | Must be "Active" |
| Spin interval | Wait for next spin |
| Subscription active | Check billing |
Strategy Not Opening Positions
Possible Causes:
| Cause | How to Check |
|---|---|
| Entry conditions not met | Review strategy logic |
| Existing position | Check positions page |
| Insufficient balance | Check exchange balance |
| Risk limits hit | Review bot settings |
Debug Steps:
- Check spin logs for strategy output
- Verify indicator values match expectations
- Compare to strategy conditions
Strategy Not Closing Positions
Possible Causes:
| Cause | Solution |
|---|---|
| Exit conditions not met | Wait or manual close |
| Stop loss not triggered | Price didn't reach SL |
| Take profit not triggered | Price didn't reach TP |
| Strategy logic issue | Review strategy code |
Spin Errors
Error in Spin Log:
Strategy execution failed: [error]
Common Causes:
| Error | Cause | Solution |
|---|---|---|
| Timeout | Strategy too slow | Simplify logic |
| Memory limit | Too much data | Reduce state size |
| Indicator error | Bad candle data | Wait for more candles |
Copy Bot Issues
Not Copying Master's Trades
Diagnostic Steps:
| Check | Expected |
|---|---|
| Copy bot active | Status: Active |
| Master bot active | Must be trading |
| Exchange connected | Active connection |
| Sufficient balance | For copied position |
Position Size Different from Master
Why This Happens:
| Reason | Explanation |
|---|---|
| Size multiplier | Applied to master's size |
| Balance difference | Scaled to your balance |
| Minimum order size | Exchange minimums apply |
| Rounding | Exchange precision |
Example:
Master trades: $1,000
Your multiplier: 0.5x
Your trade: $500
But if $500 is below minimum, trade may be $600 (exchange minimum)
Copy Delay
Normal Delay: 100-500ms
If Longer:
- High server load
- Exchange latency
- Network issues
Impact: Entry price may differ slightly from master.
Bot Configuration Issues
"Bot Cannot Use This Exchange"
Causes:
- Exchange type mismatch (spot bot on futures exchange)
- Exchange not active
- Exchange in error state
Solution:
- Verify exchange type matches bot type
- Check exchange status
- Reconnect exchange if needed
"Symbol Not Available"
Causes:
- Symbol doesn't exist on exchange
- Symbol delisted
- Wrong format (BTC vs BTCUSDT)
Solution:
- Verify symbol exists on your exchange
- Use correct format for exchange
- Update bot configuration
"Leverage Setting Failed"
Causes:
- Leverage too high for symbol
- Futures not enabled
- Position mode issues
Solutions:
- Reduce leverage
- Check exchange's max leverage for pair
- Enable futures trading on exchange
Performance Issues
Trades Not Matching Backtest
Expected Differences:
| Factor | Backtest | Live |
|---|---|---|
| Fills | Instant at signal price | May have slippage |
| Fees | Estimated | Actual |
| Timing | Perfect | Has latency |
| Liquidity | Unlimited | Real orderbook |
This is normal. Backtests are approximations.
High Slippage
Causes:
| Cause | Solution |
|---|---|
| Large position size | Reduce size |
| Low liquidity | Trade liquid pairs |
| Volatile markets | Use limit orders |
| High latency | Check connection |
Missing Trades
Where to Check:
- Bot's trade history
- Exchange order history
- Positions page
If Trade Not Found:
- May have been rejected
- Check bot error logs
- Verify on exchange directly
Recovering from Issues
Resync Bot State
If bot state seems incorrect:
- Pause the bot
- Check positions on exchange directly
- Close positions manually if needed
- Resume bot
- Bot will sync on next cycle
Reset Bot
For persistent issues:
- Pause the bot
- Close all positions
- Delete the bot
- Create new bot with same settings
- Use fresh webhook URL
Emergency Stop
To immediately stop all bot activity:
- Go to bot settings
- Click "Pause" or "Stop"
- Bot will not execute new trades
- Existing positions remain open
- Close positions manually if needed
Best Practices
Monitoring
| Practice | Why |
|---|---|
| Check daily | Catch issues early |
| Set up notifications | Get alerts |
| Review logs | Understand behavior |
| Compare to expectations | Spot anomalies |
Prevention
| Practice | Why |
|---|---|
| Paper test first | Validate before live |
| Start small | Limit risk |
| Use stop losses | Protect capital |
| Keep backups | Webhook URL, settings |
Next Steps
- Common Errors - General errors
- Exchange Issues - Exchange problems
- FAQ - Frequently asked questions