TURNOVER

8.18.0

Описание

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

Поддерживаемые рынки

• ❌ Spot (спот)

• ✅ Futures (фьючерсы)

• ✅ Inverse (инверсные)

Алиасы

Нет

Синтаксис

action=turnover;mktype=futures;symbol=SYMBOL;side=SIDE;type=TYPE;qty=QTY[;дополнительные_параметры]

Обязательные параметры

mktype

Тип рынка

mktype=futures
mktype=inverse

symbol

Торговый символ

symbol=BTCUSDT

side

Направление новой позиции

side=BUY     # переворот в лонг
side=SELL    # переворот в шорт

type

Тип ордера для входа

type=MARKET    # рыночный ордер (рекомендуется)
type=LIMIT     # лимитный ордер

qty

Размер новой позиции

Абсолютное количество:

qty=100

Процентное количество:

openpro=50     # 50% для новой позиции
quqty=100      # использовать весь баланс USDT

Дополнительные параметры

leverage / lev

Плечо для новой позиции

lev=10
leverage=20

levforqty

Использовать плечо для расчета количества

levforqty=true
levforqty!

ignoreside

Игнорировать наличие однонаправленной позиции

ignoreside=true

stop

Стоп-лосс для новой позиции

Процентный стоп:

stop=5%        # 5% от цены входа

Абсолютная цена:

stop=29000

tp

Тейк-профит для новой позиции

tp=[32000,100%]                # единичный тейк
tp=[31000,50%][32000,50%]      # множественные тейки

price

Цена для лимитного ордера (если type=LIMIT)

price=30000

Логика работы

Алгоритм выполнения:

1. Проверка позиции: Определяет текущее состояние позиции по символу

2. Анализ направления: Сравнивает текущее и желаемое направление

3. Выполнение операций:

   • Если позиций нет → создает новую позицию

   • Если позиция противоположная → закрывает и открывает новую

   • Если позиция однонаправленная → ошибка (или игнорирует с ignoreside)

Сценарии работы:

Нет позиции:

Текущая позиция: отсутствует
Команда: side=BUY, qty=100
Результат: открывается лонг на 100 контрактов

Переворот шорта в лонг:

Текущая позиция: SHORT 50 контрактов
Команда: side=BUY, qty=100
Результат: закрывается шорт + открывается лонг на 100

Попытка перевернуть в ту же сторону:

Текущая позиция: LONG 30 контрактов
Команда: side=BUY, qty=100
Результат: ОШИБКА (если не указан ignoreside)

Примеры использования

Базовый переворот

action=turnover;mktype=futures;symbol=BTCUSDT;side=SELL;type=MARKET;qty=100;lev=10

Переворачивает любую позицию в шорт на 100 контрактов

Переворот с защитными ордерами

action=turnover;mktype=futures;symbol=ETHUSDT;side=BUY;type=MARKET;openpro=50;lev=5;levforqty!;stop=3%;tp=[3200,100%]

Переворот в лонг с защитными ордерами

Переворот с игнорированием направления

action=turnover;mktype=futures;symbol=ADAUSDT;side=BUY;type=MARKET;qty=1000;ignoreside=true;stop=2%

Принудительный переворот в лонг, даже если уже есть лонг позиция

Лимитный переворот

action=turnover;mktype=futures;symbol=SOLUSDT;side=SELL;type=LIMIT;price=150;qty=500;lev=15

Переворот в шорт по лимитной цене 150

Особенности

Проверка направления По умолчанию команда вернет ошибку при попытке перевернуть позицию в то же направление

Автоматический расчет Система автоматически рассчитывает количество для закрытия текущей позиции

Атомарная операция Переворот выполняется как единая операция, минимизируя время без позиции

Автоматическое направление стопа Система автоматически определяет правильное направление стоп-лосса для новой позиции

Результат выполнения

Возвращает информацию о:

• Закрытой позиции (если была)

• Новой открытой позиции

• Установленных защитных ордерах

• Общем результате операции

Связанные экшены

• OPENPOSITION - открытие позиции

• CLOSEPOSITION - закрытие позиции

• NEWORDER - создание ордеров ignoreside!

Игнорирование наличия однонаправленной позиции.\
Если параметр указан, то команда будет выполнена в любом случае

{% hint style="warning" %}
Используйте параметр с осторожностью, так как он может привести к нежелательным последствиям
{% endhint %}