OPENPOSITION

8.15.4

Описание

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

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

• ❌ Spot (спот)

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

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

Алиасы

• entry

Синтаксис

action=openposition;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

Экшн 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% от входа

Тейк-профит-лимит (с третьим параметром):

tp=[32000,50%,32100]  # триггер 32000, количество 50%, лимитная цена 32100

Тип устанавливаемого ордера - TP_MARKET или TP_LIMIT (если указан третий параметр для лимитной цены)

clearstage

Флаг для очистки состояния перед выполнением экшна. При clearstage=true отменяет все открытые ордера по символу и закрывает существующую позицию (если есть)

clearstage=true

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

1. Очистка состояния: Если указан clearstage=true, отменяет все ордера и закрывает позицию по символу

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

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

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

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

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

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

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

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=openposition;mktype=futures;symbol=BTCUSDT;side=BUY;type=MARKET;qty=0.1;clearstage=true

Отменяет все ордера и закрывает позицию по BTCUSDT, затем открывает новую позицию

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

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 для мгновенного входа в позицию

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

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

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

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

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

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

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

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

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

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

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

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

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

• CHPORDERS - изменение защитных ордеров