Vector Trading Webhooks Integration Guide

Welcome to Vector Trading's webhook integration! This comprehensive guide will help you connect your TradingView strategies with our trading platform using webhooks.

The Vector Trading webhook API supports various types of signals, including position opening, position management, and strategy management. We also provide best practices to ensure the security and optimization of your trading strategies.

The API is flexible and not limited to TradingView only. You can use it with any other platforms that support sending HTTP POST requests in a JSON format.

TradingView webhooks allow you to send automated trading signals from your Pine Script strategies directly to Vector Trading platform. When your strategy conditions are met, TradingView will send a JSON payload to our webhook endpoint, which will then execute the corresponding trading action on your connected exchange.

1. Go to the Vector Trading terminal in the "Trading" section of the main menu
2. Connect the required exchange account (for example, BingX, Bybit, etc.)
3. Click "+ Create Bot"
4. Choose a name for your algorithm
5. Configure the bot parameters:
   • Trading limits: Set limits for position size and total capital
   • Entries: Set entries for the bot, and offsets if you do not want the bot to use entries from TradingView signals
   • Take-profits: Set take-profit levels for automatic profit locking if you do not want the bot to use take-profits from TradingView signals
   • Stop-loss: Set a stop-loss level to protect capital if you do not want the bot to use stop-loss from TradingView signals

After creating your bot, you'll receive a unique webhook URL that looks like:

https://www.vector-trading.app/webhooks/signals/v1/YOUR_BOT_API_KEY

The simplest order type that executes immediately at current market price. For market orders, do not specify price or triggerPrice fields.

{
  "version": 1.0,
  "action": "open",
  "marketPrice": {{close}},
  "order": {
      "side": "buy"
  },
  "timestamp": "{{timenow}}",
  "hashtag": "LONG_BTCUSDT_20250214010200_15M"
}

Limit orders execute only at specified price or better. Specify the price field to create a limit order.

{
  "version": 1.0,
  "action": "open",
  "marketPrice": {{close}},
  "order": {
      "side": "buy",
      "price": {{close * 0.998}}
  },
  "timestamp": "{{timenow}}",
  "hashtag": "LONG_BTCUSDT_20250214010200_15M"
}

Trigger orders activate when trigger price is reached. Specify the triggerPrice field. Optionally add price field for limit trigger order.

{
  "version": 1.0,
  "action": "open",
  "marketPrice": {{close}},
  "order": {
      "side": "buy",
      "triggerPrice": {{close * 1.01}}
  },
  "timestamp": "{{timenow}}",
  "hashtag": "LONG_BTCUSDT_20250214010200_15M"
}

If you want to guarantee closing all existing positions and orders before opening a new position (reliable reversal), use the force: true flag. This is especially useful for strategies that require complete exit from current position before entering the opposite one.

Example: Force Close and Open New Position

{
    "version": 1.0,
    "action": "open",
    "force": true,
    "marketPrice": {{close}},
    "order": {
        "side": "buy"
    },
    "timestamp": "{{timenow}}",
    "hashtag": "LONG_BTCUSDT_20250214010200_15M"
}

Force flag behavior:

• force: true - first close ALL positions and cancel ALL orders for the trading pair, then create a new order
• force: false or absent - check available bot limit, ignore signal if there are positions from other bots, create order for available remainder

Use action: "update" to modify existing trading state without opening a new position.

• If position is already open, update works as trailing stop and updates active stop-loss order.
• If position is not open but entry order exists, update changes pending entry price / triggerPrice and stop-loss value.

{
    "version": 1.0,
    "action": "update",
    "marketPrice": {{close}},
    "order": {
        "side": "sell",
        "stop": {{close * 0.985}}
    },
    "timestamp": "{{timenow}}",
    "hashtag": "LONG_BTCUSDT_20250214010200_15M"
}

{
    "version": 1.0,
    "action": "update",
    "marketPrice": {{close}},
    "order": {
        "side": "buy",
        "price": {{close * 0.997}},
        "triggerPrice": {{close * 1.003}},
        "stop": {{close * 0.96}}
    },
    "timestamp": "{{timenow}}",
    "hashtag": "LONG_BTCUSDT_20250214010200_15M"
}

{
    "version": 1.0,
    "action": "cancel",
    "marketPrice": {{close}},
    "timestamp": "{{timenow}}",
    "hashtag": "LONG_BTCUSDT_20250214010200_15M"
}

{
    "version": 1.0,
    "action": "close",
    "marketPrice": {{close}},
    "timestamp": "{{timenow}}",
    "hashtag": "LONG_BTCUSDT_20250214010200_15M"
}

{
    "version": 1.0,
    "action": "start",
    "marketPrice": {{close}},
    "timestamp": "{{timenow}}",
    "hashtag": "LONG_BTCUSDT_20250214010200_15M"
}

{
    "version": 1.0,
    "action": "pause",
    "marketPrice": {{close}},
    "timestamp": "{{timenow}}",
    "hashtag": "LONG_BTCUSDT_20250214010200_15M"
}

"takeProfits": [
    {"price": 50000.00, "percent": 30},
    {"price": 55000.00, "percent": 40},
    {"price": 60000.00, "percent": 30}
]

1. Open your TradingView chart
2. Apply your Pine Script strategy
3. Click the "Alert" button (clock icon)
4. Configure alert conditions:
   • Condition: Select your strategy
   • Options: Choose "Once Per Bar Close" for most strategies
   • Expiration: Set appropriate expiration time

1. In the alert dialog, go to the "Notifications" tab
2. Check "Webhook URL"
3. Paste your Vector Trading webhook URL
4. In the "Message" field, paste your JSON payload

You can use TradingView's built-in variables in your JSON:

• {{close}} - Current close price
• {{open}} - Current open price
• {{high}} - Current high price
• {{low}} - Current low price
• {{volume}} - Current volume
• {{timenow}} - Current timestamp
• {{strategy.order.action}} - Strategy action (buy/sell)
• {{strategy.position_size}} - Current position size

Dynamic Price Calculation Example:

{
    "version": 1.0,
    "action": "open",
    "marketPrice": {{close}},
    "order": {
        "side": "buy",
        "orderType": "limit",
        "price": {{close * 0.998}},
        "stop": {{close * 0.96}},
        "takeProfits": [
            {"price": {{close * 1.04}}, "percent": 50},
            {"price": {{close * 1.08}}, "percent": 50}
        ]
    },
    "timestamp": "{{timenow}}",
    "hashtag": "LONG_BTCUSDT_20250214010200_15M"
}

• Never publish your webhook URL publicly
• Use unique hashtags for each strategy to avoid conflicts
• Monitor your alerts regularly to ensure they're working correctly
• Test thoroughly on demo accounts before live trading

• Start with small position sizes when testing webhook integration
• Use appropriate timeframes for your strategy
• Set reasonable stop-losses to protect capital
• Monitor performance and adjust parameters as needed

• Check webhook logs in the Vector Trading dashboard
• Validate JSON syntax using online JSON validators
• Ensure all required fields are present in your payload
• Contact support for persistent issues

TradingView webhook integration with Vector Trading opens powerful possibilities for trading automation. Follow this guide and best practices for successful implementation of your trading strategies.