---
description: 8.12.0
---

# CHPORDERS

## Описание

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

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

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

## Алиасы

Нет

## Синтаксис

```
action=chporders;mktype=futures;symbol=SYMBOL[;stop=STOP][;tp=TP]
```

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

### symbol

Торговый символ, для которого нужно изменить ордера

```
symbol=BTCUSDT
```

### mktype

Тип рынка (только фьючерсы)

```
mktype=futures
```

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

### stop

Новый уровень стоп-лосса

**Процентное значение:**

```
stop=5%
```

_Стоп на 5% от текущей цены позиции_

**Абсолютное значение:**

```
stop=29000
```

_Стоп по цене 29000_

### tp

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

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

```
tp=[32000,100%]
```

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

```
tp=[31000,50%][32000,50%]
```

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

1. **Проверка позиции**: Проверяет наличие открытой позиции по указанному символу
2. **Отмена старых ордеров**: Отменяет существующие стоп-лосс и тейк-профит ордера
3. **Создание новых ордеров**: Выставляет новые защитные ордера согласно параметрам

### Расчет стоп-лосса

**Для лонг позиций:**

* Процентный стоп: `текущая_цена × (1 - stop%/100)`
* Абсолютный стоп: указанная цена

**Для шорт позиций:**

* Процентный стоп: `текущая_цена × (1 + stop%/100)`
* Абсолютный стоп: указанная цена

### Расчет тейк-профита

Количество для тейк-профита может быть указано:

* **В процентах**: `50%` - 50% от размера позиции
* **Абсолютным значением**: `0.5` - точное количество

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

### Изменение только стоп-лосса

```
action=chporders;mktype=futures;symbol=BTCUSDT;stop=3%
```

_Устанавливает стоп на 3% от текущей цены_

### Изменение только тейк-профита

```
action=chporders;mktype=futures;symbol=ETHUSDT;tp=[3200,100%]
```

_Устанавливает тейк на цене 3200 для всей позиции_

### Изменение и стопа, и тейка

```
action=chporders;mktype=futures;symbol=ADAUSDT;stop=0.48;tp=[0.55,50%][0.60,50%]
```

_Устанавливает абсолютный стоп и два тейк-профита_

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

```
action=chporders;mktype=futures;symbol=SOLUSDT;tp=[150,25%][160,25%][170,25%][180,25%]
```

_Четыре тейк-профита по 25% позиции каждый_

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

{% hint style="warning" %}
**Требуется открытая позиция** Экшн работает только при наличии открытой позиции по указанному символу
{% endhint %}

{% hint style="info" %}
**Автоматическое направление** Система автоматически определяет направление стоп-лосса и тейк-профита на основе направления позиции
{% endhint %}

{% hint style="info" %}
**Частичное изменение** Можно изменять только стоп-лосс или только тейк-профит, указав соответствующий параметр
{% endhint %}

{% hint style="danger" %}
**Отмена существующих ордеров** При изменении стопа отменяются ВСЕ существующие стоп-ордера. При изменении тейка отменяются ВСЕ тейк-ордера
{% endhint %}

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

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

* Отмененных ордерах
* Новых созданных ордерах
* Текущем состоянии позиции Новые тейк-профит ордера в формате `[цена,количество]`

```
tp=[35000,0.05][36000,0.05]
```

```
tp=[10%,50%][20%,50%]
```

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

#### Изменение стоп-лосса

```
mktype=futures;symbol=BTCUSDT;action=chporders;stop=29000
```

#### Изменение тейк-профитов

```
mktype=futures;symbol=BTCUSDT;action=chporders;tp=[35000,0.05][40000,0.05]
```

#### Изменение и стопа, и тейков

```
mktype=futures;symbol=BTCUSDT;action=chporders;stop=5%;tp=[10%,50%][20%,50%]
```

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

1. **Проверка позиции** - команда сначала проверяет наличие активной позиции по указанному символу
2. **Отмена старых ордеров** - отменяет все существующие стоп и тейк-профит ордера
3. **Создание новых ордеров** - выставляет новые ордера согласно переданным параметрам

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

{% hint style="info" %}
**Процентные значения**

* Для стопа процент рассчитывается от текущей цены символа
* Для тейк-профита процент рассчитывается от цены входа в позицию
{% endhint %}

{% hint style="info" %}
**Направление ордеров** Система автоматически определяет направление ордеров на основе направления позиции:

* Для LONG позиции: стоп и тейки будут SELL ордерами
* Для SHORT позиции: стоп и тейки будут BUY ордерами
{% endhint %}

{% hint style="warning" %}
Если позиция по указанному символу не найдена, команда вернёт ошибку
{% endhint %}
