Руководство по интеграции веб-хуков Vector Trading

Добро пожаловать в интеграцию веб-хуков с Vector Trading! Это подробное руководство поможет вам подключить ваши стратегии TradingView к нашей торговой платформе с помощью веб-хуков.

API веб-хуков Vector Trading поддерживает различные типы сигналов, включая открытие позиций, управление позициями и управление стратегиями. Мы также предоставляем лучшие практики для обеспечения безопасности и оптимизации ваших торговых стратегий.

API достаточно гибок и не ограничен лишь TradingView. Вы можете использовать его с любыми другими платформами, которые поддерживают отправку HTTP POST запросов в формате JSON.

Веб-хуки TradingView позволяют отправлять автоматические торговые сигналы из ваших Pine Script стратегий напрямую на платформу Vector Trading. Когда условия вашей стратегии выполняются, TradingView отправляет JSON-пакет на наш веб-хук, который затем выполняет соответствующее торговое действие на подключенной бирже.

1. Перейдите в терминал Vector Trading в секции "Торговля" основного меню
2. Подключите учётную запись нужной биржи (например, BingX, Bybit и т.д.)
3. Нажмите "+ Создать бота"
4. Выберите название для вашего алгоритма
5. Настройте параметры бота:
   • Лимиты по торговле: Укажите лимиты по размеру позиций и общему капиталу
   • Входы: Установите входы для бота, и отступы, если не хотите, чтобы бот использовал входы из сигналов TradingView
   • Тейк-профиты: Настройте уровни тейк-профита для автоматической фиксации прибыли, если не хотите, чтобы бот использовал тейк-профиты из сигналов TradingView
   • Стоп-лосс: Установите уровень стоп-лосса для защиты капитала, если не хотите, чтобы бот использовал стоп-лосс из сигналов TradingView

После создания бота вы получите уникальный URL веб-хука, который выглядит так:

https://www.vector-trading.app/webhooks/signals/v1/ВАШ_API_КЛЮЧ

Самый простой тип ордера, который исполняется немедленно по текущей рыночной цене. Для создания рыночного ордера не указывайте поля price или triggerPrice.

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

Лимитный ордер исполняется только по указанной цене или лучше. Укажите поле price для создания лимитного ордера.

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

Триггерный ордер активируется при достижении триггерной цены. Укажите поле triggerPrice. Опционально можете добавить поле price для создания лимитного триггерного ордера.

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

Если вы хотите гарантированно закрыть все существующие позиции и ордера перед открытием новой позиции (надёжный разворот), используйте флаг force: true. Это особенно полезно для стратегий, которые требуют полного выхода из текущей позиции перед входом в противоположную.

Пример: Принудительное закрытие и открытие новой позиции

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

Поведение флага force:

• force: true - сначала закрыть ВСЕ позиции и отменить ВСЕ ордера по торговой паре, затем создать новый ордер
• force: false или отсутствует - проверить доступный лимит бота, игнорировать сигнал если есть позиции других ботов, создать ордер на доступный остаток

Используйте action: "update", чтобы изменить текущее торговое состояние без открытия новой позиции.

• Если позиция уже открыта, update работает как trailing stop и обновляет активный stop-loss ордер.
• Если позиция ещё не открыта, но entry-ордер уже есть, update изменяет price / triggerPrice этого ордера и значение stop-loss.

{    "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"}

• order.stop необязателен. Если он передан, это должна быть конечная положительная цена.
• order.takeProfits необязателен. Если он передан, это должен быть массив.
• Один сигнал может содержать не более 10 целей тейк-профита.
• Каждый тейк-профит должен содержать конечные положительные значения price и percent.
• Каждый переданный percent тейк-профита должен быть больше 0, а сумма не должна превышать 100.
• Отсутствующий takeProfits допустим, но один невалидный тейк-профит отклоняет весь payload.
• Цены TP/SL проверяются относительно base price сигнала: order.price, затем order.triggerPrice, затем marketPrice.
• Для buy тейк-профиты должны быть выше base price, а стоп-лосс ниже него.
• Для sell тейк-профиты должны быть ниже base price, а стоп-лосс выше него.

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

1. Откройте ваш график TradingView
2. Примените вашу Pine Script стратегию
3. Нажмите кнопку "Алерт" (иконка часов)
4. Настройте условия алерта:
   • Условие: Выберите вашу стратегию
   • Опции: Выберите "Once Per Bar Close" для большинства стратегий
   • Срок действия: Установите подходящее время истечения

1. В диалоге алерта перейдите на вкладку "Уведомления"
2. Отметьте "Webhook URL"
3. Вставьте ваш URL веб-хука Vector Trading
4. В поле "Сообщение" вставьте ваш JSON payload

Вы можете использовать встроенные переменные TradingView в вашем JSON:

• {{close}} - Текущая цена закрытия
• {{open}} - Текущая цена открытия
• {{high}} - Текущий максимум
• {{low}} - Текущий минимум
• {{volume}} - Текущий объём
• {{timenow}} - Текущая временная метка
• {{strategy.order.action}} - Действие стратегии (buy/sell)
• {{strategy.position_size}} - Текущий размер позиции

Пример динамического расчёта цены:

{    "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"}

• Никогда не публикуйте ваш URL веб-хука публично
• Используйте уникальные хэштеги для каждой стратегии во избежание конфликтов
• Регулярно мониторьте ваши алерты, чтобы убедиться в их корректной работе
• Тщательно тестируйте на демо-счетах перед живой торговлей

• Начинайте с малых размеров позиций при тестировании интеграции веб-хуков
• Используйте подходящие таймфреймы для вашей стратегии
• Устанавливайте разумные стоп-лоссы для защиты капитала
• Мониторьте производительность и корректируйте параметры по мере необходимости

• Проверяйте логи веб-хуков в панели управления Vector Trading
• Валидируйте JSON синтаксис с помощью онлайн валидаторов JSON
• Убедитесь, что все обязательные поля присутствуют в вашем payload
• Обращайтесь в поддержку при постоянных проблемах

Интеграция веб-хуков TradingView с Vector Trading открывает мощные возможности для автоматизации торговли. Следуйте этому руководству и лучшим практикам для успешной реализации ваших торговых стратегий.