Signals

Webhook Setup

How to find your webhook URL, configure your signal token, and connect a signal provider like TradingView to your bot.

Every TradingForge license has a unique webhook URL. Signals sent to this URL are forwarded in real time to your running bot. This article walks through finding your URL, understanding the token, and wiring up a provider.

Finding Your Webhook URL

Your webhook URL is displayed in Settings → Signals. It looks like:

https://signals.tradingforge.net/webhook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

The UUID at the end is your signal token. It is unique to your license and is automatically generated when you activate. Copy the full URL — this is what you paste into your signal provider.

Keep your webhook URL private. Anyone with this URL can send signals to your bot. If you believe it has been compromised, regenerate your token immediately from the Settings → Signals tab using the Regenerate button.

Regenerating Your Token

If you need to rotate your signal token (e.g. after sharing it accidentally):

›Go to Settings → Signals
›Click Regenerate next to the Webhook URL
›A new UUID is issued by the License Server and your old token is immediately invalidated
›Update all your providers with the new URL

After regenerating, the bot automatically reconnects to the relay using the new token. You do not need to restart TradingForge.

Signal Payload Format

All signals must be sent as HTTP POST requests with a JSON body to your webhook URL. The required fields for every signal are:

POST https://signals.tradingforge.net/webhook/YOUR_TOKEN
Content-Type: application/json

{
  "action": "buy",
  "pair":   "BTCUSDT",
  "provider": "my-tradingview-alert"
}

Field	Required	Description
action	Yes	The action to perform. See Supported Actions for all valid values.
pair	Yes (most actions)	The trading pair, e.g. BTCUSDT, ETHUSDT. Required for all pair-specific actions.
provider	No	An identifier for the signal source. Used for filtering in Provider Management.
value	Depends	Numeric value required for set_stop_loss and set_take_profit actions.

TradingView Setup

TradingView alerts can POST to any webhook URL when an alert condition fires. To connect TradingView to your TradingForge bot:

Step 1 — Create an Alert

›Open a chart in TradingView and click Alerts → Create Alert
›Set your condition (indicator cross, price level, etc.)

Step 2 — Configure the Webhook

›In the alert dialog, check Webhook URL
›Paste your TradingForge webhook URL
›In the Message field, enter valid JSON for the action you want:

{
  "action": "buy",
  "pair":   "{{ticker}}",
  "provider": "tradingview"
}

TradingView will substitute {{ticker}} with the chart symbol at alert fire time. Make sure the resulting pair name matches the format your exchange expects (e.g. BTCUSDT not BTC/USDT).

TradingView webhooks require a Pro, Pro+, or Premium account. Free accounts do not support webhook alerts.

Testing Your Webhook

You can test that your bot receives signals using any HTTP client. With curl:

curl -X POST https://signals.tradingforge.net/webhook/YOUR_TOKEN \
  -H "Content-Type: application/json" \
  -d '{"action":"buy","pair":"BTCUSDT","provider":"test"}'

If the bot is running with Signals enabled, you will see the signal appear in the Settings → Signals → Signal Log within a second or two.

You can also check relay connectivity status at:

GET https://signals.tradingforge.net/status/YOUR_TOKEN

This returns a JSON object indicating whether your bot is currently connected to the relay.

Signals Overview

Signal Modes