---
description: 8.12.0
---

# SPREADENTRY

## Описание

Экшн для входа в позицию с использованием стратегии 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
```

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

{% hint style="info" %}
**Подробнее о формировании количества** Детальную информацию о всех способах указания количества см. в разделе [Формирование количества](../formirovanie-kolichestva)
{% endhint %}

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

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

```
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
```

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

## Особенности

{% hint style="warning" %}
**Внимание к минимальным объемам** Система автоматически корректирует количество ордеров, если рассчитанный объем меньше минимального объема биржи
{% endhint %}

{% hint style="info" %}
**Оптимизация исполнения** Лимитные ордера размещаются параллельно для ускорения исполнения
{% endhint %}

{% hint style="danger" %}
**Отмена существующих ордеров** При указании параметров `tp` или `stop` ВСЕ ордера на указанном символе будут отменены
{% endhint %}

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

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

* Созданной позиции
* Размещенных ордерах
* Установленных стоп-лоссах и тейк-профитах
* Выполненном наборе команд

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

* **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`

```
```
