OPENORDERS

8.31.1

Описание

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

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

• ❌ Spot (спот)

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

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

Алиасы

Нет

Синтаксис

action=openorders;mktype=futures;symbol=SYMBOL;side=SIDE;price=PRICE;qty=QTY

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

mktype

Тип рынка

mktype=futures
mktype=inverse

symbol

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

symbol=BTCUSDT

side

Направление ордера

side=BUY     # на покупку
side=SELL    # на продажу

price

Цена лимитного ордера (положительное значение)

price=29000

qty

Количество (положительное значение). На этапе подготовки команды значения quqty/openpro/depopro приводятся к финальному qty, в самом экшне проверяется только готовый qty>0.

Подробнее о формировании количества Способы указания количества описаны в разделе Формирование количества

В подготовке могут использоваться:

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

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

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

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

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

type

Передавать не требуется: экшн принудительно устанавливает type=LIMIT независимо от входных данных.

Любое переданное значение type будет проигнорировано — используется только лимитный ордер.

stop

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

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

stop=5%     # стоп на 5% от цены лимитного ордера

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

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

При указании стопа в процентах расчет идет от цены лимитного ордера.

tp

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

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

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

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

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

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

tp=[102%,100%]      # тейк на +2% от цены лимитного ордера

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

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

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

clearstage

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

clearstage=true

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

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

2. Очистка позиции (опционально): Если clearstage=true, закрывается текущая позиция по символу.

3. Выставление лимитного ордера: Создается лимитный ордер (type=LIMIT) с применением биржевых фильтров.

4. Ожидание статуса: Экшн ждет, что ордер останется в статусе NEW (до ~5 с); если сразу FILLED/REJECTED/EXPIRED/CANCELED — возвращается ошибка.

5. Размещение стопа: При указании stop создается стоп-маркет ордер (reduce only) на полный объем.

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

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

Базовый лимитный ордер

action=openorders;mktype=futures;symbol=BTCUSDT;side=BUY;price=30000;qty=0.01

Лимитный лонг по 30000

Ордер с защитными заявками

action=openorders;mktype=futures;symbol=ETHUSDT;side=BUY;price=2500;qty=0.2;stop=3%;tp=[2550,100%]

Лонг по лимиту 2500 со стопом -3% и тейком 2550

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

action=openorders;mktype=futures;symbol=ADAUSDT;side=SELL;price=0.50;qty=1000;stop=0.52;tp=[0.48,50%][0.46,50%]

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

Ордер с очисткой состояния

action=openorders;mktype=futures;symbol=BTCUSDT;side=BUY;price=29800;qty=0.1;clearstage=true

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

Особенности

Только лимитные ордера Экшн принудительно создает лимитный ордер; другие типы игнорируются.

Ожидание статуса NEW Если ордер сразу уходит из статуса NEW (например, исполняется или отклоняется), экшн вернет ошибку.

Reduce only для защитных заявок Стоп и тейки ставятся как reduce only на весь заявленный объем.

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

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

• Созданном лимитном ордере

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

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

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

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

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

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

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

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