Що таке Reduce-only?

Reduce-only — це параметр, який гарантує, що ваш ордер може лише зменшити або повністю закрити існуючу позицію.

Він ніколи не збільшить розмір позиції та не відкриє нову позицію у протилежному напрямку.

Навіщо використовувати Reduce-only?

Reduce-only є важливим інструментом управління ризиками при маржинальній та ф’ючерсній торгівлі.

Він особливо корисний, якщо у вас кілька активних ордерів одночасно. Якщо один із них закриє вашу позицію перед виконанням інших, Reduce-only запобігає випадковому відкриттю нової позиції залишковими ордерами.

Також допомагає уникнути збільшення позиції понад її поточний розмір.

Де доступно та як увімкнути?

Reduce-only доступний лише для Розширених ордерів у маржинальній та ф’ючерсній торгівлі.

Вебверсія

1. Перейдіть на сторінку торгівлі та оберіть торгову пару.

2. У формі ордера оберіть Розширений ордер (наприклад, Advanced Limit, Stop-Market, Stop-Limit, Multi-Limit, OCO).
3. Активуйте перемикач Reduce-only.
4. Введіть необхідні параметри ордера (ціна, кількість тощо).
5. Натисніть Buy або Sell, потім підтвердіть ордер.

Детальніше про розміщення ордерів у веб-версії дізнайтеся у статті: https://help.whitebit.com/hc/uk/articles/9798180636189 

Мобільний додаток

1. Відкрийте розділ “Торгівля” у режимі “Біржа “та оберіть пару активів із випадаючого списку у верхньому лівому куті.
2. Або скористайтеся вкладкою “Ринки”, знайдіть пару через пошук та натисніть на неї. Буде відкрито сторінку з графіком.
3. Натисніть “Купити” або “Продати”. Ви перейдете до торгового терміналу.
4. У випадаючому списку типу ордера оберіть Розширений ордер (Advanced Limit, Stop-Market, Stop-Limit, Multi-Limit, OCO).
5. Введіть необхідні деталі ордера (ціна, кількість тощо).
6. Увімкніть параметр Reduce-only.
7. Натисніть “Купити” або “Продати”, потім підтвердіть ордер.

Детальніше про розміщення ордерів у веб-версії дізнайтеся у статті: https://help.whitebit.com/hc/uk/articles/9797858885533 

Зверніть увагу: Reduce-only недоступний для Базових ордерів у веб- або мобільному інтерфейсі.

Однак Reduce-only доступний через API для всіх типів ордерів.

Як це працює?

Параметр застосовує такі системні перевірки:

• Розмір ордера перевищує позицію → автоматично зменшується до поточного розміру під час розміщення, зміни та виконання.
• Позиція повністю закрита → усі залишкові Reduce-only ордери автоматично скасовуються.
• Немає відкритої позиції, або напрямок ордера збігається з позицією → ордер не буде розміщений.

Автоматичний Reduce-only

Reduce-only автоматично застосовується при використанні:

• Закрити по Market
• Закрити всі позиції
  
   

Це гарантує, що закриття позиції ніколи не відкриє нову позицію.

Для ордерів за допомогою “Закрити по Limit” Reduce-only можна увімкнути або вимкнути вручну.

Зверніть увагу: Reduce-only не сумісний з TP/SL ордерами.

Зміна розміру ордера (Clipping)

Якщо розмір ордера перевищує поточну позицію, він буде автоматично скоригований.

Наприклад, у вас є довга позиція (long) 1 BTC на ф’ючерсах (BTC-PERP).

Ви розміщуєте Reduce-only ордер на продаж 1.6 BTC, що перевищує вашу позицію.

Система перевіряє наявність позиції, напрямок ордера та перевищення розміру поточної позиції.

У цьому випадку:

• Ордер на продаж буде зменшено до 1 BTC і виконано за ринковою ціною
• Залишок буде ігноровано
• Позиція буде повністю закрита

Регулювання при зміні ордера існуючого ордера

Якщо ви змінюєте існуючий Reduce-only ордер і збільшуєте його розмір понад вашу позицію, система автоматично відкоригує його.

Наприклад, у вас довга позиція (long) 1 BTC на ринку BTC-PERP.

1. Ви розміщуєте Reduce-only розширений лімітний ордер на продаж 1 BTC по $45,000.
2. Система приймає ордер і додає його до книги ордерів.
3. Ви змінюєте кількість з 1 BTC на 5 BTC.
4. Система визначає, що нова кількість перевищує розмір позиції.
5. Система автоматично коригує кількість з 5 BTC до 1 BTC.
6. Ринок досягає $45,000 — ордер виконується 1 BTC, повністю закриваючи позицію.

Кілька Reduce-only ордерів та автоскасування

Ви можете розміщувати кілька Reduce-only ордерів на різних цінових рівнях. Кожен ордер перевіряється щодо вашого поточного розміру позиції під час розміщення — незалежно від інших відкритих ордерів. Потім він повторно перевіряється під час виконання, щоб завжди відповідати актуальному залишку позиції. Після повного закриття позиції усі залишкові Reduce-only ордери автоматично скасовуються.

Наприклад, у вас довга позиція (long) 1 BTC на BTC-PERP по $45,000.

1. Ви розміщуєте Reduce-only розширений лімітний Ордер А на продаж 0.6 BTC по $44,000.
2. Ви розміщуєте Reduce-only розширений лімітний Ордер Б на продаж 0.7 BTC по $43,500.
3. Ринок падає до $44,000 — Ордер A виконується, позиція стає 0.4 BTC.
4. Ринок падає до $43,500 — Ордер Б автоматично зменшується до 0.4 BTC і виконується.
5. Ваша позиція повністю закрита (0 BTC).
6. Усі залишкові Reduce-only ордери автоматично скасовуються.

Коли Reduce-only ордери можуть бути відхилені?

Немає відкритої позиції

Якщо ви розміщуєте Reduce-only ордер, але не маєте відкритої позиції на цьому ринку, ордер відхиляється, оскільки немає чого зменшувати.

Наприклад, у вас немає відкритої позиції на BTC-PERP.

1. Ви намагаєтесь розмістити Reduce-only розширений лімітний ордер на продаж 0.5 BTC.
2. Система визначає, що позиція відсутня.
3. Ордер відхиляється.

Той самий напрямок, що і позиція

Якщо Reduce-only ордер збігається за напрямком із вашою відкритою позицією, ордер відхиляється. Виконання такого ордера збільшило б позицію, чого Reduce-only не дозволяє.

Наприклад, у вас довга позиція (long) 1 BTC на ринку BTC-PERP.

1. Ви намагаєтесь розмістити Reduce-only розширений лімітний ордер на купівлю 0.5 BTC (той самий напрямок, що і позиція).
2. Система визначає, що сторона ордера збігається зі стороною позиції.
3. Ордер відхиляється. 

API

Параметр “reduceOnly” підтримується у endpoints для управління заставними ордерами (collateral) — його можна включити у запит на створення Reduce-only ордера, а у відповідях він показує, чи встановлений цей прапорець для існуючого ордера.

Помилка у відповіді

Якщо Reduce-only ордер розміщено без позиції або він збільшує позицію, повертається така помилка:

{
"code": 116,
"message": "Validation failed",
"errors": {
"reduceOnly": ["Reduce-only: Position doesn't exist or wrong side"]
 }
}