> For the complete documentation index, see [llms.txt](https://docs.cryptorg.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cryptorg.io/cryptorg-bot_futures/webhooks.md).

# Веб-хуки

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

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

<div align="left"><figure><img src="https://2321820453-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyE0wyxQMcNlDNCJvWKE4%2Fuploads%2FtPoUGhQFa8lM8pR2l08g%2Fimage.png?alt=media&amp;token=6c98c336-2624-4da5-b3b1-3b181a51904a" alt="" width="563"><figcaption></figcaption></figure></div>

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

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

{% hint style="info" %}
**При работе с веб-хуками нужно отключить опцию "Открывать сделки в непрерывном режиме" для исключение конкуренции между ботом и удаленной стороной.**
{% endhint %}

Для отправки команды на открытие сделки из другой программы, например TradingView, следует выполнить POST-запрос по REST на соответствующий веб-хук.

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

<figure><img src="https://2321820453-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyE0wyxQMcNlDNCJvWKE4%2Fuploads%2FjDdJB4IpPQxbE0y20kGp%2Fimage.png?alt=media&amp;token=f1c3f2e9-d718-4897-8bd3-53a7e5e3e85a" alt=""><figcaption></figcaption></figure>

### Параметры

* **botId** (не обязательный параметр) - указывает для какого бота предназначена конфигурация новой сделки. Если не передавать botId, система автоматически откроет сделки в соответствии с направлением (strategy) и торговыми парами (pairs) от имени [**Ghost бота**](#ghost-bot) 👻
* **strategy** - направление
* **pairs** - торговые пары, по которым будет открыта сделка. Можно указать не все пары, используемые ботом. Если торговые пары не указаны ВОВСЕ, сделки будут открываться по всем парам, заданным в боте.
* секкция **OPEN** - перечисляет список параметров доступные для открытия сделки
  * **orderVolume** - обязательный параметр обозначающий объем первого ордера в USDT
  * остальные параметры не обязательные
* секция **DCA** (усреднение) - список параметров доступные для усреднения. Может быть отключена если enabled = false
* секция **CLOSE** (закрытие) - список параметров доступные для закрытия сделки
* секция **STOP** (стоп-лосс) - список параметров доступные для установки стоп-лосса

{% hint style="info" %}
Чтобы узнать все доступные параметры для тела JSON-запроса, вы можете воспользоваться конфигуратором бота, размещённым выше. Установите нужные параметры и просто скопируйте готовый JSON.
{% endhint %}

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

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

* **Сетка ордеров**: Это обновление включает ***отмену текущей сетки*** и ***создание новой с заданными параметрами***.
* **Секция Take Profit (ТП):** Изменяет текущие параметры ТП на новые, позволяя адаптировать стратегию выхода из сделки.
* **Секция стоп-лосс**: Аналогично секции ТП, изменения в стоп-лоссе могут потребовать обновления параметров для правильного управления рисками.

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

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

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

<figure><img src="https://2321820453-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyE0wyxQMcNlDNCJvWKE4%2Fuploads%2FgklzA7QCHewYuCbihCMo%2Fimage.png?alt=media&amp;token=d371652d-0dee-42d9-b3f2-15b36edd774a" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://2321820453-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyE0wyxQMcNlDNCJvWKE4%2Fuploads%2F7WwI0E0IAfgTrRBVkW6a%2Fimage.png?alt=media&amp;token=e7583746-7d26-497d-a547-6bdb6d998670" alt=""><figcaption></figcaption></figure>

* **botId** (не обязательный параметр) - идентификатор бота, для которого предназначена команда. Если botId НЕ указан, система автоматически выполнит закрытие сделок, соответствующих заданному направлению (strategy) и торговым парам (pairs)
* **strategy** - направление
* В поле **pairs** указывается список торговых пар, по которым следует закрыть активные сделки. Вы можете задать как одну, так и несколько торговых пар. Если список пар не указан, закрытие будет выполнено для активных сделок по всем торговым парам, заданным в настройках бота
* В поле **closePosition** передается булевое значение, которое указывает, следует ли закрыть позицию по сделке или просто отменить сделку, оставив позицию открытой.

## 👻 Ghost бот

Мы предлагаем универсальное решение, позволяющее максимально упростить проведение сверхбыстрых сделок с помощью Crazy ботов Cryptorg. Теперь вы можете НЕ указывать идентификаторы ботов (id) в теле JSON запроса для любого вебхука.&#x20;

Если идентификаторы отсутствуют, наша система автоматически ищет совпадения по позициям, учитывая направление стратегии и торговые пары. Она выполняет действия в соответствии с полученными запросами на вебхуки, будь то открытие, изменение, усреднение или закрытие сделки.&#x20;

В интерфейсе Cryptorg вы увидите бота с именем "Ghost" и его активные сделки. Таким образом, вам даже не нужно создавать ботов — достаточно воспользоваться конфигуратором и настроить вебхуки на удаленной стороне, будь то ваше собственное ПО или платформа Trading View.

{% hint style="info" %}
Веб-хуки выступают как гибкий инструмент автоматизации и дистанционного управления торговыми ботами, что обеспечивает быструю реакцию на изменения рынка без необходимости прямого вмешательства человека.
{% endhint %}
