SPREADENTRY

8.12.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%]

stop

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

stop=2%
stop=48000

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

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

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

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

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

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

Для лонга (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

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

Особенности

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Поддерживаются все параметры из openposition:

  • lev - кредитное плечо

  • levforqty - применять плечо к количеству

  • stop - стоп-лосс (% или абсолютное значение)

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

Особенности стоп-лосса

  • Стоп размещается на максимальное количество биржи для избежания отслеживания

  • Цена стопа рассчитывается от самой крайней лимитки:

    • Для лонга: стоп ниже самой низкой лимитки

    • Для шорта: стоп выше самой высокой лимитки

Примеры

Базовый spread entry

Базовый spread entry


mktype=futures;action=spreadentry;symbol=BTCUSDT;side=BUY;qty=0.01;price=100000;spreadperc=0.9;spreadcount=10

Создаст 10 лимитных ордеров:

  • От 100,000 до 99,100 USDT

  • По 0.001 BTC каждый

С кредитным плечом и стопом


mktype=futures;action=spreadentry;symbol=BTCUSDT;side=BUY;qty=0.01;price=100000;spreadperc=0.9;spreadcount=10;lev=10;stop=2%

С тейк-профитом


mktype=futures;action=spreadentry;symbol=BTCUSDT;side=BUY;qty=0.01;price=100000;spreadperc=0.9;spreadcount=10;tp=[5%,50%][10%,50%]

Создаст 10 лимитных ордеров:

  • От 100,000 до 99,100 USDT

  • По 0.001 BTC каждый

С кредитным плечом и стопом


action=spreadentry;mktype=futures;symbol=BTCUSDT;side=BUY;qty=0.01;price=100000;spreadperc=0.9;spreadcount=10;lev=10;stop=2%

С тейк-профитом


action=spreadentry;mktype=futures;symbol=BTCUSDT;side=BUY;qty=0.01;price=100000;spreadperc=0.9;spreadcount=10;tp=[5%,50%][10%,50%]

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

Возвращает объект ActionEntryPositionResult:

  • position - информация о позиции после заполнения

  • stop - результат размещения стоп-ордера (если указан)

  • takeprofit - массив результатов размещения тейк-профитов (если указаны)

  • commandset - список всех выполненных команд

Примечания

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

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

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

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

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

PreviousOPENPOSITIONNextCLOSEPOSITION

Last updated