SPREADENTRY

8.18.0

Описание

Экшн для входа в позицию с использованием стратегии spread entry (распределенного входа). Комбинирует рыночный ордер для мгновенного создания позиции с серией лимитных ордеров для дополнительного набора объема при движении цены в выгодном направлении.

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

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

• ❌ Spot (спот)

Алиасы

Нет

Синтаксис

action=spreadentry;mktype=futures;symbol=SYMBOL;side=SIDE;qty=QTY;price=PRICE;spreadperc=PERC;spreadcount=COUNT

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

symbol

Торговый символ для входа в позицию

symbol=BTCUSDT

side

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

• BUY - лонг позиция

• SELL - шорт позиция

side=BUY

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

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

Общий объем позиции, который будет распределен между всеми ордерами:

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

qty=100           # точное общее количество для распределения

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

openpro=25        # 25% от свободного баланса для распределения
depopro=50        # 50% от общего депозита для распределения

price

Базовая цена для расчета диапазона размещения лимитных ордеров

price=50000

spreadperc

Максимальный процент отклонения от базовой цены для размещения лимитных ордеров

spreadperc=2.5

Означает отклонение на 2.5% от базовой цены

spreadcount

Желаемое количество ордеров в spread'е (включая рыночный ордер)

spreadcount=5

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

tp

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

tp=[51000,50%][52000,50%]

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

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

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

stop

Настройки стоп-лосса (процент или абсолютная цена)

stop=2%
stop=48000

clearstage

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

clearstage=true

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

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

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

3. Лимитные ордера: Остальные ордера размещаются как LIMIT в ценовом диапазоне

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

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

Расчет диапазона цен

Для лонга (BUY):

• Минимальная цена: price × (1 - spreadperc/100)

• Максимальная цена: price

Для шорта (SELL):

• Минимальная цена: price

• Максимальная цена: price × (1 + spreadperc/100)

Автоматическая коррекция

Если рассчитанный объем для одного ордера меньше минимальных требований биржи, система автоматически:

• Уменьшает количество ордеров

• Увеличивает объем каждого ордера до приемлемого уровня

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

Базовый лонг spread entry

action=spreadentry;mktype=futures;symbol=BTCUSDT;side=BUY;qty=100;price=50000;spreadperc=2;spreadcount=4

Создает лонг позицию с 1 рыночным ордером и 3 лимитными ордерами в диапазоне 49000-50000

Spread entry с тейк-профитом и стопом

action=spreadentry;mktype=futures;symbol=ETHUSDT;side=BUY;qty=50;price=3000;spreadperc=1.5;spreadcount=3;tp=[3150,100%];stop=2%

Создает позицию с защитными ордерами

Шорт spread entry

action=spreadentry;mktype=futures;symbol=ADAUSDT;side=SELL;qty=1000;price=0.5;spreadperc=3;spreadcount=5;stop=0.52

Создает шорт позицию с абсолютным стоп-лоссом

Spread entry с очисткой состояния

action=spreadentry;mktype=futures;symbol=BTCUSDT;side=BUY;qty=100;price=50000;spreadperc=2;spreadcount=4;clearstage=true

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

Особенности

Внимание к минимальным объемам Система автоматически корректирует количество ордеров, если рассчитанный объем меньше минимального объема биржи

Оптимизация исполнения Лимитные ордера размещаются параллельно для ускорения исполнения

Отмена существующих ордеров При указании параметров tp, stop или clearstage=true ВСЕ ордера на указанном символе будут отменены

Закрытие позиции при clearstage Флаг clearstage=true закрывает существующую позицию по символу перед созданием новой. Убедитесь, что это необходимо, чтобы избежать нежелательных сделок.

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

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

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

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

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

• Установленных стоп-лоссах и тейк-профитах

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

Система автоматически корректирует количество ордеров с учетом:

• minNotional - минимальная стоимость ордера на бирже

• minQty - минимальное количество

Если qty / spreadcount меньше минимального требования, количество ордеров автоматически уменьшается.

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

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

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

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

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

Примечания

• Действие работает только с фьючерсами (mktype=futures)

• Ордера размещаются как LIMIT с TIF=GTC

• Цены автоматически округляются согласно тикам биржи

• При частичном заполнении остальные ордера остаются активными

• Поддерживается полная совместимость с параметрами openposition