Back to Docs

Webhooks API

TradingView webhook ingestion for automated trading signals.

Endpoint

POST/api/webhooks/tradingviewAuth
Receive TradingView signal

Overview

The TradingView webhook endpoint receives trading signals from TradingView alerts and routes them to the appropriate in-house bot for execution on the Base network via the Mobula Swap API.

Security

Webhook requests must include the WEBHOOK_SECRET in the payload. Requests without a valid secret are rejected.

Payload Format

Configure your TradingView alert to send a JSON payload with the following fields:

TradingView Alert Message
{
  "secret": "YOUR_WEBHOOK_SECRET",
  "botId": "bot_abc123",
  "action": "buy",
  "pair": "ETH/USDT",
  "price": 3400.50,
  "amount": 0.5,
  "strategy": "momentum",
  "timeframe": "1h"
}

Required Fields:

secret — Webhook authentication secret

botId — Target bot ID for this signal

action — Trading action: buy, sell, close

pair — Trading pair (e.g., ETH/USDT)

Optional Fields:

price — Signal price (for reference)

amount — Trade amount

strategy — Strategy identifier

timeframe — TradingView timeframe

Response

Success (200)
{
  "success": true,
  "signalId": "sig_abc123",
  "tradeId": "trade_xyz789",
  "status": "processing"
}
Error (401 — Invalid secret)
{
  "error": "Invalid webhook secret"
}