Signal Bots Overview
Signal Bots are automated trading bots that execute trades based on external webhook signals. They're the bridge between your trading signals (from TradingView, custom scripts, or signal providers) and your exchange accounts.
What is a Signal Bot?
A Signal Bot listens for incoming signals via a unique webhook URL and automatically executes trades on your connected exchange. The flow is:
Signal Source → Webhook → Signal Bot → Exchange → Trade Executed
Common Signal Sources
- TradingView: Pine Script strategies and alerts
- Custom Scripts: Python, Node.js, or any HTTP-capable code
- Signal Providers: Third-party trading signal services
- Other Platforms: Any service that can send HTTP requests
How It Works
1. Create a Signal Bot
Configure a bot with:
- Connected exchange
- Trading pair (e.g., BTC/USDT)
- Position sizing
- Risk management settings
2. Get Your Webhook URL
Each bot has a unique webhook URL:
https://www.tradestaq.com/api/webhooks/trade/abc123-def456-...
3. Configure Your Signal Source
Point your signal source to your webhook URL. When an alert fires, it sends a signal to TradeStaq.
4. Automatic Execution
TradeStaq receives the signal, validates it, and executes the trade on your exchange.
Signal Format
Signal bots accept JSON payloads with trading instructions:
{
"action": "buy",
"symbol": "BTCUSDT",
"size": "100%",
"leverage": "10"
}
Supported Actions
| Action | Description |
|---|---|
buy / long | Open a long position |
sell / short | Open a short position |
close | Close current position |
close_long | Close long position only |
close_short | Close short position only |
Key Features
Multi-Exchange Support
Connect a single bot to multiple exchanges to execute the same signals across different accounts.
Risk Management
Built-in tools to protect your capital:
- Stop loss automation
- Take profit targets
- Position size limits
- Leverage controls
Webhook Health Monitoring
Track signal reception with health indicators:
- 🟢 Healthy: Signal received within 24 hours
- 🟡 Warning: No signal in 24-48 hours
- 🔴 Stale: No signal in 48+ hours
- ⚪ New: Never received a signal
Master Trading
Share your signals with followers through copy trading. As a master trader, you can:
- Monetize your trading strategy
- Build a following
- Earn from subscription fees
Bot Lifecycle
Created → Active → Receiving Signals → Executing Trades
↓
Paused (temporary stop)
↓
Stopped/Deleted
Status States
| Status | Meaning |
|---|---|
| Active | Processing signals and executing trades |
| Paused | Temporarily stopped, can be resumed |
| Stopped | Permanently stopped |
| Error | Issue occurred, needs attention |
Use Cases
Automated TradingView Strategies
Convert your TradingView strategies into live trades:
- Create a Pine Script strategy
- Set up alerts with webhook
- Bot executes trades automatically
Note: This is the most common use case. See our TradingView Integration guide.
Signal Service Integration
Subscribe to a signal provider and automate execution:
- Get signals from provider (Telegram, Discord, API)
- Forward signals to your webhook
- Trades execute without manual intervention
Custom Algorithm Trading
Build your own trading system:
- Develop your algorithm in any language
- Send HTTP requests to your webhook
- Full control over entry/exit logic
Multi-Account Trading
Execute the same strategy across multiple accounts:
- Create one bot with multiple exchanges
- Signals execute on all linked accounts
- Perfect for managing multiple portfolios
Limits by Subscription Tier
| Tier | Signal Bots | Exchanges per Bot |
|---|---|---|
| Free | 0 | 1 |
| Pro | 3 | 1 |
| Trader | 10 | 3 |
| Whale | 100 | 10 |
Getting Started
Best Practices
- Start with Paper Trading - Test your setup before going live
- Use Descriptive Names - "BTC RSI Strategy" not "Bot 1"
- Configure Stop Losses - Always protect your downside
- Monitor Webhook Health - Ensure signals are being received
- Review Trade Logs - Check execution quality regularly
Related Guides
- Connect an Exchange — set up your exchange account first
- TradeStaq Bots — strategy-based bots (no webhook required)
- Backtesting — validate strategies before deploying
- Risk Management — configure stop-loss and position sizing
- DCA Settings — dollar-cost averaging for signal bots