SignalForge Docs.

✓Requirements

Before you start, make sure you have the following:

1Create your account1 min

Go to signalforge-ai.com and choose the Starter Plan ($4.99/mo). Click the subscribe button and complete the Stripe checkout.

You'll receive an email with:

• Your personal webhook token
• The download link for the Expert Advisor file
• The webhook URL to use in TradingView

2Your webhook token30s

Your webhook token looks something like this:

Copy1a2b3c4d5e6f7890abcdef1234567890

This token is what links your TradingView alerts to your MetaTrader 5 EA. Keep it private — anyone with this token can send signals to your account.

Your full webhook URL combines the SignalForge server with your token:

Copyhttps://api.signalforge-ai.com/wh/YOUR_TOKEN

3Install the Expert Advisor90s

3.1 Download the EA

Download the SignalForgeEA_Starter.ex5 file from the link in your welcome email.

3.2 Open the Experts folder

In MetaTrader 5, go to File → Open Data Folder. Navigate to MQL5 → Experts. This is where MT5 stores Expert Advisors.

3.3 Copy the EA file

Copy SignalForgeEA_Starter.ex5 into the Experts folder.

3.4 Attach to a chart

Back in MetaTrader 5:

1. Open any chart (any symbol — the EA can trade any pair)
2. Open the Navigator panel (Ctrl+N) and find SignalForgeEA_Starter under Expert Advisors
3. Drag it onto the chart — a properties window opens
4. Configure the inputs (see Step 4.4 below) and click OK

4Configure MetaTrader 560s

4.1 Allow algo trading

Go to Tools → Options → Expert Advisors tab. Enable:

• Allow algorithmic trading
• Allow WebRequest for listed URL

4.2 Add the WebRequest URL

In the same dialog, click Add (or double-click the empty field) and paste:

Copyhttps://api.signalforge-ai.com

4.3 Enable AutoTrading

In the MT5 toolbar, click the AutoTrading button so it turns green. If it's red, the EA shows "AUTOTRADING OFF" and won't execute trades.

4.4 Enter your token

When attaching the EA to the chart, a properties window appears. Go to the Inputs tab and paste your webhook token into the WebhookToken field. Click OK.

5Create a TradingView alert90s

5.1 Open the alert dialog

In TradingView, open any chart. Click the Alert button (clock icon) or press Alt+A.

5.2 Set the condition

Choose your indicator or strategy condition. For a quick test, you can use a simple crossing condition (e.g., EMA 9 crossing EMA 21).

5.3 Enable webhook

In the Notifications tab, check "Webhook URL" and paste your full webhook URL:

Copyhttps://api.signalforge-ai.com/wh/YOUR_TOKEN

5.4 Write the alert message

In the Message field, paste the JSON payload. For a simple BUY:

Copy{
  "action": "buy",
  "symbol": "EURUSD",
  "lot": 0.01,
  "sl": 50,
  "tp": 100
}

5.5 Save the alert

Click Create. The alert is now active. When it triggers, TradingView sends the JSON to your webhook URL, the server queues it, and the EA picks it up within 1-2 seconds.

6Test your first signal30s

The fastest way to test is to create a manual alert that fires immediately:

1. In TradingView, open any chart (e.g., EURUSD)
2. Create an alert with condition "Once per bar" and any always-true condition (e.g., "Close greater than 0")
3. Paste the BUY JSON above with a tiny lot size (0.01)
4. Click Create — the alert fires immediately
5. Switch to MetaTrader 5 — within 1–2 seconds you should see a 0.01 lot BUY position open on EURUSD

✉Telegram alerts

SignalForge can send a Telegram message every time the EA acts — trade opened, closed, breakeven, Shield action, news pause and more. This is outbound only: it notifies you about your own trades. Your signals still come from TradingView — Telegram is not a signal source.

It is set up entirely from the dashboard; you don't change anything in the EA. Just keep the EA connected so it has trades to report.

Set up in 4 steps

1. Create a bot with @BotFather and copy its bot token.
2. Get your Chat ID: send your new bot any message, then open @userinfobot — it replies with a number like 8157815762. Shortcut: send your bot /start and click Auto-link in the dashboard to detect it automatically.
3. Connect: paste the bot token and Chat ID into the Connection section and click Send test message — you should receive it in your chat.
4. Pick events: under Per-event notifications, toggle the ones you want and customize each message template.

Broadcast to a public channel

Want to publish your trades to your own channel instead of a private chat? Turn on Channel mode: it hides your account number and adds pip distances, R:R ratio and your channel signature. Set the Chat ID to your channel — channel IDs start with -100 (e.g. -1001234567890).

{ }Webhook syntax reference

All webhook messages use JSON format. Here is the full list of supported fields:

* symbol is not required for closeall.

Close commands

To close positions, use these actions:

Copy// close all positions on EURUSD
{"action": "close", "symbol": "EURUSD"}

// close only BUY (long) positions on EURUSD
{"action": "close", "symbol": "EURUSD", "side": "buy"}

// close only SELL (short) positions on EURUSD
{"action": "close", "symbol": "EURUSD", "side": "sell"}

// close ALL open positions on the account
{"action": "closeall"}

Full example with SL/TP

Copy{
  "action": "buy",
  "symbol": "EURUSD",
  "lot": 0.05,
  "sl": 50,
  "tp": 100,
  "comment": "EMA cross H1",
  "magic": 2026001
}

Migrating from another bridge? Your alerts just work

You do not need to rewrite your TradingView alerts to switch to SignalForge. The webhook reads the most common formats out of the box and maps them to the fields above — paste your existing alert and it runs:

Field aliases are mapped automatically: ticker → symbol, order_action / signal / side → action, stop_loss / sl_pips / sl_price → sl, take_profit / tp_pips / tp_price → tp, and exit / flat → close.

Minimalist alerts: just “buy” or “sell”

Set a Default symbol in your dashboard (Setup) and an alert containing only buy or sell — with no symbol at all — opens a trade on that symbol. Or use the {{ticker}} placeholder so TradingView fills the chart symbol for you:

Copybuy {{ticker}}

▭EA panel guide

When the EA is running, a dark panel appears on the top-left corner of the chart. Here is what each section shows:

Header

Displays SIGNALFORGE and the plan name (STARTER). A minimize/maximize button ([-] / [+]) lets you collapse the panel.

Balance & equity

Shows your current account balance and equity in real time.

Open position

When a trade is active, shows: direction (BUY/SELL), lot size, entry price, SL, TP, and current P/L in real time.

Today's performance

Tracks daily stats that reset at midnight: total trades, wins, losses, win rate (%), and daily P/L. These stats survive EA restarts — they are saved to a local file.

Footer

Shows: connection status, your token (masked), uptime, and signal count.

⚙EA input settings

Press F7 on the chart (or right-click EA → Properties) to open the inputs panel. Key settings for Starter:

{ }Pine Script setup

If you use Pine Script strategies (not just indicators), here is how to set up the webhook correctly.

Pine v4

Copy//@version=4
strategy("My SF Strategy", overlay=true)

longCondition = crossover(sma(close,9), sma(close,21))
shortCondition = crossunder(sma(close,9), sma(close,21))

if (longCondition)
    strategy.entry("Long", strategy.long,
      alert_message='{"action":"buy","symbol":"EURUSD","lot":0.01,"sl":50,"tp":100}')

if (shortCondition)
    strategy.entry("Short", strategy.short,
      alert_message='{"action":"sell","symbol":"EURUSD","lot":0.01,"sl":50,"tp":100}')

Pine v6

Copy//@version=6
strategy("My SF Strategy", overlay=true)

longCondition = ta.crossover(ta.sma(close,9), ta.sma(close,21))
shortCondition = ta.crossunder(ta.sma(close,9), ta.sma(close,21))

if longCondition
    strategy.entry("Long", strategy.long,
      alert_message='{"action":"buy","symbol":"EURUSD","lot":0.01,"sl":50,"tp":100}')

if shortCondition
    strategy.entry("Short", strategy.short,
      alert_message='{"action":"sell","symbol":"EURUSD","lot":0.01,"sl":50,"tp":100}')

Dynamic symbol

To make the symbol dynamic (works on any chart):

Copy// using string concatenation
msg = '{"action":"buy","symbol":"' + syminfo.ticker + '","lot":0.01}'

strategy.entry("Long", strategy.long, alert_message=msg)

!Troubleshooting

EA shows "AUTOTRADING OFF"

Click the AutoTrading button in the MT5 toolbar to enable it (must be green). The EA won't execute trades while AutoTrading is disabled, but it stays attached to the chart.

No trades appear after alert fires

1. Check the WebRequest URL — Tools → Options → Expert Advisors. Make sure https://api.signalforge-ai.com is in the allowed URLs list.
2. Check the token — Open the EA inputs (F7) and verify the WebhookToken matches the one from your welcome email.
3. Check the Experts tab in MT5 — error messages appear here. Look for keywords like "WebRequest" or "401".
4. Check the JSON — copy your alert message and validate it at jsonlint.com.

Error 4752 or 4756 in Experts tab

These are WebRequest permission errors. The URL is not whitelisted. Go to Tools → Options → Expert Advisors and add the server URL.

Trade opens but with wrong lot size

Check if your webhook JSON includes the lot field. If not, the EA uses the DefaultLots input value. Also check your broker's minimum/maximum lot size.

Symbol "not found" error

The symbol name in your webhook must match your broker exactly. Common mismatches: XAUUSD vs GOLD, US30 vs US30.cash vs DJ30. Check your Market Watch for the exact name.

Connection drops after a while

Check your internet connection and make sure MT5 is not going to sleep. If running on a VPS, ensure the VPS stays active. The EA auto-reconnects if the server is temporarily unavailable.

?Frequently asked questions

$Plan comparison

Need more than the Starter? Here's what each plan adds: