OPENPOSITION

8.12.0

Описание

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

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

  • ❌ Spot (спот)

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

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

Алиасы

  • entry

Синтаксис

action=openposition;mktype=futures;symbol=SYMBOL;side=SIDE;type=market;qty=QTY[;stop=STOP][;tp=TP][;дополнительные_параметры]

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

mktype

Тип рынка

mktype=futures
mktype=inverse

symbol

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

symbol=BTCUSDT

side

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

side=BUY     # лонг позиция
side=SELL    # шорт позиция

type

Тип ордера (только рыночный)

type=MARKET

Экшн OPENPOSITION поддерживает только тип ордера MARKET

Параметры количества

Подробнее о формировании количества Детальную информацию о всех способах указания количества см. в разделе Формирование количества

Один из следующих параметров обязателен:

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

qty=0.1           # точное количество в базовой валюте
quqty=100         # точное количество в квотовой валюте

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

openpro=25        # 25% от свободного баланса для открытия
closepro=100      # 100% от позиции для закрытия (при переворачивании)
depopro=50        # 50% от общего депозита (свободный + заблокированный)

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

leverage / lev

Плечо для позиции

leverage=10
lev=10

levforqty

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

levforqty=true
levforqty!          # сокращенная запись

stop

Настройки стоп-лосса

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

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

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

stop=29000  # стоп по цене 29000

tp

Настройки тейк-профита в формате [цена,количество]

Единичный тейк-профит:

tp=[32000,100%]     # весь объем по цене 32000

Множественные тейк-профиты:

tp=[31000,50%][32000,50%]   # два тейка по 50%

Процентная цена:

tp=[250%,100%]      # тейк на 250% от входа

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

  1. Открытие позиции: Размещается рыночный ордер для входа в позицию

  2. Ожидание исполнения: Система ждет подтверждения открытия позиции

  3. Получение позиции: Запрашивается информация о созданной позиции

  4. Размещение стопа: При указании параметра stop выставляется стоп-лосс

  5. Размещение тейков: При указании параметра tp выставляются тейк-профиты

Расчет защитных ордеров

Стоп-лосс:

  • Для лонга: ниже цены входа

  • Для шорта: выше цены входа

  • Автоматически с флагом reduceonly=true

Тейк-профит:

  • Для лонга: выше цены входа

  • Для шорта: ниже цены входа

  • Тип ордера: TP_MARKET

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

Базовое открытие позиции

action=openposition;mktype=futures;symbol=BTCUSDT;side=BUY;type=MARKET;quqty=50;lev=10;levforqty!

Лонг на 50% баланса с плечом 10x

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

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

Лонг с стопом на 3% и тейком на 3200

Множественные тейк-профиты

action=openposition;mktype=futures;symbol=ADAUSDT;side=SELL;type=MARKET;qty=1000;stop=0.52;tp=[0.48,50%][0.46,50%]

Шорт с абсолютным стопом и двумя тейками

Использование алиаса

action=entry;mktype=futures;symbol=SOLUSDT;side=BUY;type=MARKET;quqty=100;lev=20;levforqty!;stop=5%;tp=[200%,25%][250%,25%][300%,50%]

Лонг с градуированными тейк-профитами

Особенности

Только рыночные ордера Экшн поддерживает только тип ордера MARKET для мгновенного входа в позицию

Режим хеджирования не поддерживается Экшн не работает в режиме хеджирования позиций

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

Комплексное решение Один экшн заменяет цепочку команд: открытие позиции + размещение стопов + размещение тейков

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

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

  • Созданной позиции

  • Размещенных защитных ордерах

  • Параметрах входа

  • Выполненном наборе команд

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

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

  • SPREADENTRY - открытие позиции spread'ом

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

  • CHPORDERS - изменение защитных ордеров Экшн OPENPOSITION поддерживает только тип ордера MARKET

quqty

Размер позиции, может быть указан параметрами qty, quqty, openpro, depopro

quqty=50
параметр
значение

qty

количество контрактов

quqty

количество контрактов вырженных в USDT

openpro

процент от свободного депозита

depopro

процент от всего депозита

leverage

Плечо для открытия позиции

lev=10

levforqty

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

levforqty!

stop

Уровень стоп-лосса

stop=5%

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

ВНИМАНИЕ! Параметр stop= контекстозависимый. Это значит что в зависимости от направления ордера процент цены будет считаться по разному. Нет необходимости указывать знаком минуса направление ордера, система сама определит направление и выставит стоп-лосс в соответствии с этим.

Стоп-лосс всегда выставляется на 100% от открытой позиции и имеет тип ордера STOP_MARKET

tp

Тейкпрофиты для позиции

tp=[250%,100%],[25000,0.001]

Каждый отдельный ордер указывается внутри квадратных скобок и состоит из пары [цена, количество]

Если ордеров несколько то каждый сет указывается отдельно через запятую.

Цена может указываться как точным значением, так и процентом. Признаком того что цифра является процентом является знак % в конце строки

Те же самые правила предъявляются ко второму параметру сета. Необходимое количество для закрытия позиции может быть указано как точным значением, так и процентом

Тип устанавливаемого ордера - TP_MARKET

PreviousCANCELORPHANSNextSPREADENTRY

Last updated