Setting Up Webhooks

Creating TradingView Alerts

Step 1: Access TradingView

  • Search for your preferred currency pair/symbol on TradingView
  • Ensure the Cluster Algo indicator is added to your chart
  • Right-click on the chart or use Alt+A to open alerts

Watch: Setting Up Your TradingView Chart

Step 2: Configure Alert Conditions

  • Name your alert (e.g., "ClusterAlgo BTC/USD")
  • In the condition dropdown, select:
    • "Buy signal" for buy alerts
    • "Sell signal" for sell alerts
  • Set your preferred alert expiration

Watch: Configuring Alert Conditions

Step 3: Configure Webhook

1

Webhook Configuration

Use our webhook URL:

https://clusteralgo.com/api/tradingview-webhook/[your-identifier]

Example URL you'll receive:

https://clusteralgo.com/api/tradingview-webhook/7e63bdd9-0465-47be-a678-acd882d09291
  • Enable "Webhook URL" in the notifications tab
  • Paste the webhook URL provided above
  • Ensure the webhook checkbox is enabled

⚠️ TradingView Requirements

  • Webhook functionality requires a paid TradingView subscription
  • Alert creation is available for free users
  • Consider upgrading to TradingView Pro for webhook support

Watch: Setting Up Webhook Notifications

Message Format

Copy and paste the following JSON format into your TradingView alert message:

{
  "time": "{{timenow}}",
  "ticker": "{{ticker}}",
  "action": "buy",
  "price": "{{close}}",
  "open": "{{open}}",
  "close": "{{close}}",
  "high": "{{high}}",
  "low": "{{low}}",
  "volume": "{{volume}}",
  "interval": "{{interval}}",
  "exchange": "{{exchange}}",
  "type": "CLUSTER",
  "strategy": "ClusterAlgo",
  "TP": "[0.5, 0.7, 0.8, 1.0]",
  "SL": "[0.5]"
}

Field Explanations

Signal Information

  • time: Current time of the signal
  • ticker: Trading pair (e.g., BTCUSDT)
  • action: Signal type - can be "buy", "sell", "long", or "short"
  • type: Indicator identifier
  • strategy: Strategy name

Price Data

  • price: Current price at signal
  • open: Candle opening price
  • close: Candle closing price
  • high: Highest price in period
  • low: Lowest price in period

Risk Management

  • TP: Take profit levels array

    Example: "TP": "[0.5, 0.7, 0.8, 1.0]"

    • Multiple values represent different TP targets
    • Values are percentages based on entry price
  • SL: Stop loss levels array

    Example: "SL": "[0.5]"

    • Single value for fixed stop loss
    • Percentage of risk you're willing to take