---
description: 8.12.0
---

# OPENPOSITION

## Описание

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

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

* ❌ Spot (спот)
* ✅ Futures (фьючерсы)
* ✅ Inverse (инверсные)

## Алиасы

* `entry`

## Синтаксис

```
action=openposition;mktype=futures;symbol=SYMBOL;side=SIDE;type=market;qty=QTY[;stop=STOP][;tp=TP][;дополнительные_параметры]
```

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

### mktype

Тип рынка

```
mktype=futures
mktype=inverse
```

### symbol

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

```
symbol=BTCUSDT
```

### side

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

```
side=BUY     # лонг позиция
side=SELL    # шорт позиция
```

### type

Тип ордера (только рыночный)

```
type=MARKET
```

{% hint style="warning" %}
Экшн OPENPOSITION поддерживает только тип ордера MARKET
{% endhint %}

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

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

Один из следующих параметров обязателен:

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

```
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% от входа
```

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

1. **Открытие позиции**: Размещается рыночный ордер для входа в позицию
2. **Ожидание исполнения**: Система ждет подтверждения открытия позиции
3. **Получение позиции**: Запрашивается информация о созданной позиции
4. **Размещение стопа**: При указании параметра `stop` выставляется стоп-лосс
5. **Размещение тейков**: При указании параметра `tp` выставляются тейк-профиты

### Расчет защитных ордеров

**Стоп-лосс:**

* Для лонга: ниже цены входа
* Для шорта: выше цены входа
* Автоматически с флагом `reduceonly=true`

**Тейк-профит:**

* Для лонга: выше цены входа
* Для шорта: ниже цены входа
* Тип ордера: `TP_MARKET`

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

### Базовое открытие позиции

```
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=entry;mktype=futures;symbol=SOLUSDT;side=BUY;type=MARKET;quqty=100;lev=20;levforqty!;stop=5%;tp=[200%,25%][250%,25%][300%,50%]
```

_Лонг с градуированными тейк-профитами_

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

{% hint style="warning" %}
**Только рыночные ордера** Экшн поддерживает только тип ордера MARKET для мгновенного входа в позицию
{% endhint %}

{% hint style="danger" %}
**Режим хеджирования не поддерживается** Экшн не работает в режиме хеджирования позиций
{% endhint %}

{% hint style="info" %}
**Автоматическая пауза** Система автоматически ждет подтверждения открытия позиции перед размещением защитных ордеров
{% endhint %}

{% hint style="success" %}
**Комплексное решение** Один экшн заменяет цепочку команд: открытие позиции + размещение стопов + размещение тейков
{% endhint %}

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

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

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

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

* [NEWORDER](neworder) - базовое создание ордеров
* [SPREADENTRY](spreadentry) - открытие позиции spread'ом
* [CLOSEPOSITION](closeposition) - закрытие позиции
* [CHPORDERS](chporders) - изменение защитных ордеров Экшн OPENPOSITION поддерживает только тип ордера MARKET

#### quqty

Размер позиции, может быть указан параметрами qty, quqty, openpro, depopro

```
quqty=50
```

| параметр | значение                               |
| -------- | -------------------------------------- |
| qty      | количество контрактов                  |
| quqty    | количество контрактов вырженных в USDT |
| openpro  | процент от _свободного_ депозита       |
| depopro  | процент от _всего_ депозита            |

#### leverage

Плечо для открытия позиции

```
lev=10
```

#### levforqty

Параметр указывает что плечо применяется как множитель к размеру позиции

```
levforqty!
```

#### stop

Уровень стоп-лосса

```
stop=5%
```

Значение стоп может быть указано в процентах или в абсолютном значении цены. При указании в процентах, система автоматически определяет направление ордера и вычисляет цену стоп-лосса.

{% hint style="danger" %}
**ВНИМАНИЕ!**\
Параметр **stop=** _контекстозависимый._ Это значит что в зависимости от направления ордера процент цены будет считаться по разному. Нет необходимости указывать знаком минуса направление ордера, система сама определит направление и выставит стоп-лосс в соответствии с этим.
{% endhint %}

{% hint style="info" %}
Стоп-лосс всегда выставляется на 100% от открытой позиции и имеет тип ордера STOP\_MARKET
{% endhint %}

#### tp

Тейкпрофиты для позиции

```
tp=[250%,100%],[25000,0.001]
```

Каждый отдельный ордер указывается внутри квадратных скобок и состоит из пары\
&#xNAN;**\[цена, количество]**

{% hint style="info" %}
Если ордеров несколько то каждый сет указывается отдельно через запятую.
{% endhint %}

Цена может указываться как точным значением, так и процентом. Признаком того что цифра является процентом является знак **%** в конце строки

Те же самые правила предъявляются ко второму параметру сета. Необходимое количество для закрытия позиции может быть указано как точным значением, так и процентом

{% hint style="info" %}
Тип устанавливаемого ордера - TP\_MARKET
{% endhint %}
