Веб-хуки

Расположение в кабинете: Настройки бота → блок «Веб-хуки»
Ссылка: Перейти ↗

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

Заметка

Здесь описаны веб-хуки обычного бота — они привязаны к конкретному боту и требуют его botId. Если бота создавать не хочется вовсе, а сделку должен открывать сам запрос — это Ghost-бот 👻 с отдельным форматом веб-хуков.

Где настраиваются

Блок Веб-хуки находится внизу формы бота и становится активным после сохранения бота. Под каждое действие — своя вкладка: Открытие / Изменение / Усреднение / Закрытие, у каждой свой URL и готовое тело запроса.

Тело запроса собирается визуальным конструктором: задаёте параметры формой — готовый JSON обновляется на лету, останется скопировать. Такой же конструктор есть у Ghost-вебхуков.

Базовый вид URL:

POST https://api3.cryptorg.net/crazy/hook/{accountId}:{token}
Content-Type: application/json

Осторожно

URL вместе с токеном = полный доступ к торговле на счёте. Не публикуйте его; при компрометации — перегенерируйте токен в форме бота.

Во всех запросах поле botId обязательно — оно адресует команду конкретному боту. strategy и pairs задают направление и пары сделки.

Открытие

POST-запрос с полным телом: секции open (первый ордер), dca (усреднение), close (Take Profit) и stop (Stop-Loss).

Обычный бот — поле botId обязательно, без action.

{
  "botId": 180526,
  "strategy": "short",
  "pairs": ["SIRENUSDT"],
  "open": {
    "orderVolume": "15",
    "leverage": 10,
    "marginType": "cross",
    "orderType": "Market",
    "cycles": 33
  },
  "dca": {
    "enabled": true,
    "max": 10,
    "active": 3,
    "volume": "15",
    "percent": "0.3",
    "multiplierVolume": "1",
    "multiplierPrice": "1"
  },
  "close": {
    "enabled": true,
    "event": "percentage",
    "value": "0.3"
  },
  "stop": {
    "enabled": true,
    "event": "percentage",
    "value": "5",
    "delay": 3
  }
}

Типы Take Profit и Stop-Loss

В примерах event = percentage, но тип фиксации может быть другим — он соответствует шагам создания бота (ШАГ 4 «Закрытие» и ШАГ 5 «Стоп-Лосс»). От типа зависит смысл value:

• Take Profit (close.event): percentage — процент от цены входа · pnl — прибыль в USDT · delay — закрытие по времени (таймер в секундах).
• Stop-Loss (stop.event): percentage — процент отклонения от входа · pnl — фиксация в USDT (можно отрицательное — ограничение убытка). Поле delay в секции stop — задержка срабатывания в секундах.

Изменение

То же тело, что при открытии, но без секции open — сделка уже открыта. Обновляет сетку усреднения (dca), Take Profit (close) и Stop-Loss (stop) активной сделки.

Обычный бот — поле botId обязательно, без action.

{
  "botId": 180526,
  "strategy": "short",
  "pairs": ["SIRENUSDT"],
  "dca": {
    "enabled": true,
    "max": 10,
    "active": 3,
    "volume": "15",
    "percent": "0.3",
    "multiplierVolume": "1",
    "multiplierPrice": "1"
  },
  "close": {
    "enabled": true,
    "event": "percentage",
    "value": "0.3"
  },
  "stop": {
    "enabled": true,
    "event": "percentage",
    "value": "5",
    "delay": 3
  }
}

Усреднение

Принудительное усреднение выполняется POST-запросом на отдельный URL с суффиксом /topup-deal. В теле — botId, направление, пары и amount (объём усреднения в USDT):

POST https://api3.cryptorg.net/crazy/hook/{accountId}:{token}/topup-deal

Обычный бот — поле botId обязательно, без action.

{
  "botId": 180526,
  "strategy": "short",
  "pairs": ["SIRENUSDT"],
  "amount": "15"
}

Закрытие

closePosition: true — закрыть позицию; false — отменить сделку, оставив позицию открытой.

Обычный бот — поле botId обязательно, без action.

{
  "botId": 180526,
  "strategy": "short",
  "pairs": ["SIRENUSDT"],
  "closePosition": true
}

Справочник параметров

• botId — ID бота, обязателен. Адресует команду конкретному боту.

• strategy — направление: long или short.

• pairs — список торговых пар (["SIRENUSDT"]).

• секция open — параметры открытия:

  • orderVolume — объём первого ордера в USDT (обязательный);
  • leverage — кредитное плечо;
  • marginType — тип маржи: cross или isolated;
  • orderType — тип ордера: Market или Limit;
  • cycles — количество циклов.

• секция dca (усреднение) — отключается через enabled: false:

  • max — максимум страховочных ордеров, active — активных сразу;
  • volume — объём страховочного ордера, percent — шаг сетки в %;
  • multiplierVolume / multiplierPrice — мартингейл по объёму / по шагу.

• секция close (Take Profit) — enabled, event и value. Тип фиксации (event) может меняться, и от него зависит смысл value:

  event	Что означает value
  percentage	процент прибыли (%)
  pnl	прибыль в USDT
  delay	время (в секундах)

• секция stop (Stop-Loss) — enabled, event (percentage или pnl), value и delay — задержка срабатывания в секундах.

• amount — только при усреднении: объём усреднения в USDT.

• closePosition — только при закрытии: true — закрыть позицию, false — отменить сделку, не трогая позицию.

Осторожно

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

Интеграция с TradingView

1. В форме бота откройте нужную вкладку веб-хука → скопируйте URL и тело запроса.
2. В TradingView: Create Alert → Notifications → включите Webhook URL → вставьте URL.
3. Тело JSON вставьте в поле Message.
4. Проверьте срабатывание — сделка появится в списке сделок бота.