Веб-хуки

Веб-хуки позволяют торговым ботам автоматически реагировать на полученные сигналы для начала, изменения, усреднения и закрытия сделок. Они могут использоваться для интеграции с любым сторонним программным обеспечением, включая настройку стратегий на платформах типа TradingView.

Для того чтобы настроить веб-хуки, перейдите в редактирование любого Crazy-бота — на Bybit- или Binance-ликвидности — в Cryptorg.

Открытие сделки

Когда по веб-хуку приходит команда на открытие сделки, в сообщении передаются все необходимые параметры в формате JSON. Это может включать начальный объём сделки, уровни усреднения, параметры закрытия, стоп-лосс и другие настройки. Бот использует эту информацию для немедленного старта сделки на Cryptorg.

Осторожно

При работе с веб-хуками нужно отключить опцию «Открывать сделки в непрерывном режиме», чтобы исключить конкуренцию между ботом и удалённой стороной.

Для отправки команды на открытие сделки из другой программы (например, TradingView) следует выполнить POST-запрос по REST на соответствующий веб-хук. В теле JSON-запроса можно указать все параметры будущей сделки, доступные при редактировании бота. Это включает все четыре секции: открытие, усреднение, закрытие и стоп-лосс. Параметры могут динамически изменяться в процессе редактирования бота.

Параметры

• botId (необязательный) — указывает, для какого бота предназначена конфигурация новой сделки. Если не передавать botId, система автоматически откроет сделки в соответствии с направлением (strategy) и торговыми парами (pairs) от имени Ghost-бота 👻.
• strategy — направление.
• pairs — торговые пары, по которым будет открыта сделка. Можно указать не все пары, используемые ботом. Если торговые пары не указаны вовсе, сделки будут открываться по всем парам, заданным в боте.
• секция OPEN — параметры открытия сделки.
  • orderVolume — обязательный параметр, объём первого ордера в USDT.
  • остальные параметры необязательные.
• секция DCA (усреднение) — параметры усреднения. Может быть отключена через enabled = false.
• секция CLOSE (закрытие) — параметры закрытия сделки.
• секция STOP (стоп-лосс) — параметры установки стоп-лосса.

Совет

Чтобы узнать все доступные параметры для тела JSON-запроса, можно воспользоваться конфигуратором бота, размещённым выше. Установите нужные параметры и просто скопируйте готовый JSON.

Изменение сделки

В процессе торговли может возникнуть необходимость изменить параметры уже открытой сделки. Веб-хук позволяет это сделать, изменяя три ключевые секции:

• Сетка ордеров — отмена текущей сетки и создание новой с заданными параметрами.
• Секция Take Profit — изменяет текущие параметры TP на новые.
• Секция Stop-Loss — обновляет параметры стоп-лосса.

Веб-хук для изменения сделки принимает те же параметры, что и веб-хук для открытия, за исключением секции «Открытие» — предполагается, что сделка уже открыта.

Усреднение сделки

Усреднение позволяет добавить объём к существующей позиции, чтобы приблизить точку входа к текущей рыночной цене.

• botId (необязательный) — идентификатор бота. Если не указан, система автоматически выполнит усреднение в активных сделках, соответствующих заданному направлению (strategy) и торговым парам (pairs).
• strategy — направление.
• pairs — список торговых пар, по которым следует усреднить позиции в активных сделках.
• amount — объём для усреднения в USDT.

Закрытие сделки

Этот веб-хук обеспечивает возможность закрытия активной сделки. Это может быть полезно для фиксации прибыли или минимизации убытков в реальном времени.

• botId (необязательный) — идентификатор бота.
• strategy — направление.
• pairs — список торговых пар.
• closePosition — булевое значение: закрыть позицию (true) или отменить сделку, оставив позицию открытой (false).

Совет

Веб-хуки выступают как гибкий инструмент автоматизации и дистанционного управления торговыми ботами — быстрая реакция на рыночные сигналы без вмешательства человека. Если не хочется создавать бота вообще — см. Ghost-бот 👻.