Getting Started•Documentation

User Guide

Complete guide to using SignalBee

SignalBee User Guide

Welcome to SignalBee! This guide will help you set up automated cryptocurrency trading using signals from TradingView.

Table of Contents

  1. Getting Started
  2. Connecting Your Exchange
  3. Configuring Webhooks
  4. Trading Configuration
  5. Viewing History
  6. Troubleshooting
  7. FAQ

Getting Started

Creating Your Account

  1. Visit SignalBee: Go to https://app.signalbee.com
  2. Click "Sign Up": On the homepage
  3. Enter Your Email: Use a valid email address you can access
  4. Create a Password: Minimum 8 characters (use a strong password)
  5. Click "Create Account"

Verifying Your Email

  1. Check Your Inbox: Look for an email from SignalBee
  2. Click the Verification Link: This confirms your email address
  3. You're Verified: You can now log in to your account

Didn't receive the email?

  • Check your spam folder
  • Wait a few minutes (emails can take up to 5 minutes)
  • Click "Resend Verification Email" on the login page

Logging In

  1. Go to: https://app.signalbee.com/login
  2. Enter Your Email and Password
  3. Click "Log In"

You'll be taken to your dashboard where you can configure trading automation.

Connecting Your Exchange

SignalBee needs access to your exchange account to place trades. Currently, we support Binance (more exchanges coming soon).

Getting Your Binance API Key

  1. Log in to Binance: Go to https://www.binance.com
  2. Go to API Management:
    • Click your profile icon (top right)
    • Select "API Management"
  3. Create API Key:
    • Click "Create API"
    • Label it "SignalBee Trading"
    • Complete 2FA verification
  4. Save Your Keys:
    • API Key: Long string starting with letters/numbers
    • Secret Key: IMPORTANT - This is shown only once. Copy it immediately!
    • Store both keys securely (you'll need them in the next step)

Required API Key Permissions

Enable ONLY these permissions:

  • ✅ Enable Reading (to check balances)
  • ✅ Enable Spot & Margin Trading (to place orders)
  • ❌ Disable everything else (futures, withdrawals, etc.)

Adding Your Binance Account to SignalBee

  1. Go to Dashboard: Log in to SignalBee
  2. Click "Exchanges" in the sidebar
  3. Click "Add Exchange"
  4. Select "Binance"
  5. Enter Your API Keys:
    • Paste your API Key
    • Paste your Secret Key
    • Testnet: Leave unchecked (unless testing)
  6. Click "Save and Test Connection"

What happens next:

  • SignalBee tests your credentials by fetching your account balance
  • If successful, you'll see your current balances
  • If failed, check your API keys and permissions

Security Note: Your API keys are encrypted and stored securely. SignalBee can only read balances and place trades - NOT withdraw funds.

Testing Your Connection

  1. Go to Exchanges page
  2. Find your Binance connection
  3. Click "Test Connection"
  4. View Results:
    • ✅ Success: Shows your current balances
    • ❌ Failed: Check API key permissions and expiration

Configuring Webhooks

Webhooks connect TradingView to SignalBee. When your TradingView strategy triggers an alert, it sends a signal to SignalBee to execute the trade.

Creating a Webhook in SignalBee

  1. Go to "Webhooks" in the sidebar
  2. Click "Create Webhook"
  3. Enter a Name: e.g., "BTC Scalping Strategy" or "Main Trading Bot"
  4. Click "Create"
  5. IMPORTANT: Copy your Webhook URL and Webhook Secret immediately
    • URL Format: https://api.signalbee.com/webhook/{your-user-id}
    • The webhook secret is shown only once - save it securely!
    • The secret must be included in your JSON payload (see examples below)

Setting Up TradingView Alerts

  1. Open TradingView: Go to https://www.tradingview.com

  2. Open Your Chart: For the pair you want to trade (e.g., BTCUSDT)

  3. Create Alert:

    • Click the alarm clock icon (top right)
    • Or right-click chart → "Add alert"

  4. Configure Alert:

    • Condition: Select your strategy or indicator
    • Alert Actions: Check "Webhook URL"
    • Webhook URL: Paste your SignalBee webhook URL
    • Message: Use the JSON format below

TradingView Alert Message Format

For BUY signals (fixed quantity):

{
  "webhook_secret": "your-webhook-secret-here",
  "action": "buy",
  "ticker": "BTCUSDT",
  "quantity_type": "fixed",
  "quantity": "0.001"
}

For SELL signals (50% of position):

{
  "webhook_secret": "your-webhook-secret-here",
  "action": "sell",
  "ticker": "{{ticker}}",
  "quantity_type": "percentage",
  "quantity": "50"
}

For CLOSE signals (exit entire position):

{
  "webhook_secret": "your-webhook-secret-here",
  "action": "close",
  "ticker": "{{ticker}}",
  "quantity_type": "percentage",
  "quantity": "100"
}

Using TradingView Variables:

  • {{ticker}} - Current chart symbol (e.g., BTCUSDT)
  • {{close}} - Current close price
  • {{timenow}} - Current timestamp
  • {{strategy.order.action}} - Strategy buy/sell action

Complete Example:

{
  "webhook_secret": "your-webhook-secret-here",
  "action": "{{strategy.order.action}}",
  "ticker": "{{ticker}}",
  "quantity_type": "percentage",
  "quantity": "25",
  "price": "{{close}}"
}
  1. Name Your Alert: e.g., "BTC Buy Signal - SignalBee"
  2. Click "Create"

Testing Your Webhook

Before going live, test your webhook to ensure it's configured correctly:

  1. Go to "Webhooks" in SignalBee
  2. Find your webhook
  3. Click "Test"
  4. Enter a test signal:
{
  "webhook_secret": "your-webhook-secret-here",
  "action": "buy",
  "ticker": "BTCUSDT",
  "quantity_type": "fixed",
  "quantity": "0.001"
}
  1. Click "Run Test"
  2. Review Results:
    • Shows validation checks (enabled, whitelisted, balance)
    • Shows simulated order details
    • No real trade is placed during testing

Trading Configuration

Configure your trading rules and safety limits.

Master Trading Toggle

Enable/Disable All Trading:

  1. Go to "Configuration"
  2. Toggle "Trading Enabled"
    • ON (Green): Signals will execute trades
    • OFF (Red): Signals are ignored (no trades placed)

Use Cases:

  • Turn OFF when going on vacation
  • Turn OFF during high volatility
  • Turn OFF to pause trading without deleting webhooks

Maximum Order Size

Set the maximum value (in USD) for any single trade:

  1. Go to "Configuration"
  2. Set "Max Order Size": e.g., $1000
  3. Click "Save"

How it works:

  • If a signal exceeds this limit, it's rejected (not executed)
  • Protects against accidentally large trades
  • Default: $1000 (recommended for beginners)

Example:

  • Max Order Size: $1000
  • Signal: Buy 1 BTC (≈$68,000)
  • Result: Rejected (exceeds $1000 limit)

Trading Pair Whitelist

Only allow trading on specific pairs:

  1. Go to "Configuration"
  2. Click "Manage Whitelist"
  3. Add Pairs:
    • Type ticker symbol (e.g., "BTCUSDT")
    • Click "Add"
  4. Remove Pairs:
    • Click "X" next to pair to remove

How it works:

  • Signals for pairs NOT in whitelist are rejected
  • Safety feature to prevent unauthorized trading pairs
  • Must match Binance format exactly (e.g., "BTCUSDT", not "BTC/USDT")

Common Pairs:

  • BTCUSDT (Bitcoin)
  • ETHUSDT (Ethereum)
  • BNBUSDT (Binance Coin)
  • SOLUSDT (Solana)
  • ADAUSDT (Cardano)

Default Exchange

If you have multiple exchanges (future feature), select which one to use:

  1. Go to "Configuration"
  2. Select "Default Exchange": Currently only Binance
  3. Click "Save"

Viewing History

Track all your trading signals and executed orders.

Signal History

View all received signals:

  1. Go to "Signals" in sidebar

  2. See all signals with status:

    • ✅ Success: Trade executed
    • ⚠️ Rejected: Blocked by safety rules
    • ❌ Failed: Execution error

  3. Filter by Status: Click filter dropdown

  4. Search: Type ticker or action

  5. Click Signal to see full details

Signal Details Include:

  • Timestamp (when signal received)
  • Action (buy, sell, close)
  • Ticker (trading pair)
  • Quantity and type (fixed/percentage)
  • Status and reason (if rejected/failed)
  • Linked order (if executed)

Order History

View all executed trades:

  1. Go to "Orders" in sidebar

  2. See all orders with details:

    • Exchange (Binance)
    • Pair (BTCUSDT)
    • Side (BUY/SELL)
    • Quantity executed
    • Average execution price
    • Status (filled, failed)

  3. Filter by Status: filled, failed, rejected

  4. Click Order to see full details

Order Details Include:

  • Exchange order ID (for Binance verification)
  • Fill details (price, quantity, fees)
  • Execution time
  • Commission charged
  • Link to original signal

Dashboard Overview

Quick stats at a glance:

  1. Go to "Dashboard"

  2. View Summary:

    • Total Signals Received
    • Total Orders Executed
    • Success Rate (%)
    • Total Trading Volume (USD)
    • Active Webhooks
    • Trading Status (Enabled/Disabled)

  3. Recent Activity:

    • Last 10 signals
    • Last 10 orders
    • Quick status indicators

Troubleshooting

Signal Not Executing

Check these items:

  1. Trading Enabled?

    • Go to Configuration
    • Ensure "Trading Enabled" is ON (green)

  2. Pair Whitelisted?

    • Go to Configuration → Whitelist
    • Ensure signal ticker is in the list

  3. Binance Connected?

    • Go to Exchanges
    • Click "Test Connection"
    • Ensure credentials are valid

  4. Sufficient Balance?

    • Check your Binance account
    • Ensure you have enough funds for the trade

  5. Check Signal History:

    • Go to Signals
    • Find the signal
    • Read rejection/failure reason

Common Rejection Reasons:

  • trading_disabled - Enable trading in Configuration
  • pair_not_whitelisted - Add pair to whitelist
  • order_exceeds_max_size - Increase max order size limit
  • insufficient_balance - Deposit more funds to Binance

Webhook Not Receiving Signals

  1. Check Webhook Status:

    • Go to Webhooks
    • Ensure webhook is Enabled (green toggle)

  2. Test Webhook:

    • Click "Test" on your webhook
    • If test fails, check configuration

  3. Check TradingView Alert:

    • Ensure alert is active (green light in TradingView)
    • Check alert message format (valid JSON)
    • Ensure webhook URL is correct

  4. Check Alert History (TradingView):

    • Right-click alert → "Alert History"
    • Look for webhook errors

Incorrect Trade Quantity

Issue: Trade executed with wrong amount

Check signal format:

  • Fixed quantity: Specify exact amount (e.g., "0.001" BTC)
  • Percentage: Specify percentage of balance (e.g., "50" = 50%)

Example - Fixed:

{
  "webhook_secret": "your-webhook-secret-here",
  "action": "buy",
  "ticker": "BTCUSDT",
  "quantity_type": "fixed",
  "quantity": "0.001"
}

Example - Percentage:

{
  "webhook_secret": "your-webhook-secret-here",
  "action": "sell",
  "ticker": "BTCUSDT",
  "quantity_type": "percentage",
  "quantity": "50"
}

Common Mistakes:

  • ❌ "quantity": "50%" (don't include % symbol)
  • ✅ "quantity": "50" (correct)
  • ❌ Mixed up fixed vs percentage type

Lost Webhook Secret

If you lost your webhook secret:

  1. Go to Webhooks
  2. Find your webhook
  3. Click "Regenerate Secret"
  4. Copy NEW secret immediately
  5. Update ALL TradingView alerts with new webhook URL

Important: Old secret stops working immediately when regenerated.

Connection Test Failing

Binance Connection Test Fails:

  1. Check API Key Permissions:

    • Log in to Binance
    • Go to API Management
    • Ensure "Enable Reading" and "Enable Spot & Margin Trading" are checked

  2. Check API Key Expiration:

    • Binance API keys can expire
    • Create a new API key if needed

  3. Check IP Restrictions:

    • If you set IP whitelist, add SignalBee IPs
    • Or set to "Unrestricted"

  4. Verify Keys Are Correct:

    • Re-copy API key and secret
    • Update in SignalBee
    • Test again

Frequently Asked Questions

Can SignalBee withdraw my funds?

No. SignalBee API keys are configured with LIMITED permissions:

  • ✅ Read balances
  • ✅ Place spot trades
  • ❌ Cannot withdraw funds
  • ❌ Cannot access futures
  • ❌ Cannot change account settings

Even if someone got your SignalBee credentials, they could only view balances and place trades - not withdraw.

What happens if I delete a webhook?

  • The webhook URL stops working immediately
  • TradingView alerts using that URL will fail
  • No trades will execute for deleted webhooks
  • You can create a new webhook anytime

Can I have multiple webhooks?

Yes! Create multiple webhooks for different strategies:

  • "Scalping Strategy"
  • "Swing Trading Bot"
  • "BTC Only"

Each webhook has a unique URL and can be enabled/disabled independently.

Do I need to keep TradingView open?

No. TradingView alerts run on their servers, not your browser:

  • Alerts trigger even when browser is closed
  • Signals are sent to SignalBee automatically
  • Trades execute 24/7 without your computer running

How fast are trades executed?

Trades are executed quickly once a signal is received. The process includes signal validation, order placement, and execution on the exchange.

What if I change my password?

SignalBee Login: Changing your SignalBee password does NOT affect:

  • Your webhook URLs (still work)
  • Your Binance connection (stays connected)
  • Your trading settings (unchanged)

Binance API Key: If you delete/regenerate your Binance API key:

  • Update it in SignalBee (Exchanges page)
  • Test connection to verify
  • All webhooks will use new credentials automatically

Can I backtest my strategy?

SignalBee executes live trades only. For backtesting:

  1. Use TradingView's Strategy Tester
  2. Test with historical data
  3. Once satisfied, connect to SignalBee for live execution

What fees does SignalBee charge?

SignalBee Fees: [Pricing varies by plan - see pricing page]

  • Free tier available with limits
  • Pro plans for advanced features

Binance Fees: Binance charges standard trading fees:

  • Maker: 0.1%
  • Taker: 0.1%
  • Use BNB for 25% discount

Example Trade:

  • Buy $1000 of BTC
  • Binance Fee: $1 (0.1%)
  • Total Cost: $1001

Is my data secure?

Yes, SignalBee uses industry-standard security practices to protect your data:

  • ✅ Encrypted Storage: API keys are encrypted before storage
  • ✅ Secure Communication: All data transmitted using HTTPS encryption
  • ✅ Protected Passwords: Passwords are securely hashed, never stored in plaintext

See our Security Page for details.

What if Binance is down?

If Binance API is unavailable:

  • Orders fail gracefully
  • You'll see failure in Orders history
  • TradingView can retry alert (if configured)
  • No data is lost

Recommendation: Use TradingView's "Retrigger alert" feature for automatic retries.

How do I contact support?

Need help?

Include in your message:

  • Description of issue
  • Screenshots (if applicable)
  • Signal ID or Order ID (if relevant)

Next Steps

Now that you're set up:

  1. ✅ Start Small: Test with small amounts first
  2. ✅ Monitor Closely: Check signal/order history regularly
  3. ✅ Adjust Limits: Fine-tune max order size and whitelist
  4. ✅ Review Performance: Analyze your success rate

Happy Trading! 🚀

← Back to DocumentationBack to Top ↑