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
clearstage
Флаг для очистки состояния перед выполнением экшна. При clearstage=true
отменяет все открытые ордера по символу и закрывает существующую позицию (если есть)
clearstage=true
Логика работы
Очистка состояния: Если указан
clearstage=true
, отменяет все ордера и закрывает позицию по символуОткрытие позиции: Размещается рыночный ордер для входа в позицию
Ожидание исполнения: Система ждет подтверждения открытия позиции
Получение позиции: Запрашивается информация о созданной позиции
Размещение стопа: При указании параметра
stop
выставляется стоп-лоссРазмещение тейков: При указании параметра
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 - изменение защитных ордеров
Last updated