Co to jest Reduce-only?
Reduce-only to parametr, który gwarantuje, że twoje zlecenie może tylko zmniejszyć lub całkowicie zamknąć istniejącą pozycję.
Nigdy nie zwiększy rozmiaru twojej pozycji ani nie otworzy nowej w przeciwnym kierunku.
Dlaczego warto używać Reduce-only?
Reduce-only to ważne narzędzie zarządzania ryzykiem dla handlu na marży i kontraktami terminowymi (futures).
Jest szczególnie przydatne, gdy masz wiele aktywnych zleceń jednocześnie. Jeśli jedno z nich zamknie twoją pozycję przed wykonaniem pozostałych, Reduce-only zapobiega przypadkowemu otwarciu nowej pozycji przez pozostałe zlecenia.
Pomaga również zapobiec zwiększeniu pozycji ponad jej aktualny rozmiar przez jakiekolwiek zlecenie.
Gdzie jest dostępne i jak je włączyć?
Reduce-only jest dostępne tylko w handlu na marży i kontraktami terminowymi przy składaniu zaawansowanych zleceń.
Wersja internetowa
- Przejdź do strony handlu i wybierz parę handlową.
- W formularzu zlecenia wybierz typ zaawansowanego zlecenia (np. Advanced Limit, Stop-Market, Stop-Limit, Multi-Limit, OCO).
- Zaznacz pole wyboru Reduce-only.
- Wprowadź wymagane szczegóły zlecenia (cenę, ilość itp.).
- Kliknij „Kup” lub „Sprzedaj”, a następnie potwierdź zlecenie.
Więcej informacji o składaniu zleceń w wersji internetowej znajdziesz w artykule: https://help.whitebit.com/hc/pl/articles/9798180636189
Aplikacja mobilna
- Przejdź do sekcji „Trade” w trybie „Exchange” i wybierz parę aktywów z rozwijanej listy w lewym górnym rogu ekranu.
- Możesz też skorzystać z zakładki „Markets”. Użyj wyszukiwarki, wybierz dostępną parę i kliknij ją. Zostaniesz przekierowany na stronę z wykresem. Stamtąd kliknij Kup lub Sprzedaj.
- Po kliknięciu przycisku „Kup” lub „Sprzedaj” zostaniesz przekierowany do terminala handlowego.
- W rozwijanym menu typu zlecenia wybierz typ zaawansowanego zlecenia (np. Advanced limit, Stop-Market, Stop-Limit, Multi-Limit, OCO).
- Wprowadź wymagane szczegóły zlecenia (cenę, ilość itp.).
- Włącz parametr Reduce-only.
- Kliknij „Kup” lub „Sprzedaj”, a następnie w oknie potwierdzenia kliknij „Potwierdź”.
Więcej informacji o składaniu zleceń w aplikacji mobilnej znajdziesz w artykule: https://help.whitebit.com/hc/pl/articles/9797858885533
Proszę zauważyć, że Reduce-only nie jest dostępne dla Podstawowych Zleceń w interfejsie webowym ani mobilnym.
Jednak Reduce-only jest dostępne przez API dla wszystkich typów zleceń.
Jak to działa?
Parametr stosuje następujące walidacje systemowe:
- Rozmiar zlecenia przekracza twoją pozycję → zostaje automatycznie zmniejszony, aby się z nią zgadzał podczas składania, modyfikacji i realizacji.
- Pozycja jest całkowicie zamknięta → wszystkie pozostałe zlecenia reduce-only są automatycznie anulowane.
- Brak otwartej pozycji lub kierunek zlecenia jest zgodny z kierunkiem pozycji → zlecenie nie zostanie złożone.
Automatyczne Reduce-only
Reduce-only jest automatycznie stosowane, gdy używasz:
- Zamknięcia przez rynek (Market)
- Zamknij wszystkie pozycje
Zapewnia to, że zamknięcie twojej pozycji nigdy nie spowoduje otwarcia nowej.
Dla zleceń Limit Close możesz ręcznie włączyć lub wyłączyć Reduce-only.
Uwaga: Reduce-only nie jest kompatybilne ze zleceniami TP/SL.
Dopasowanie rozmiaru zlecenia (Clipping)
Jeśli rozmiar twojego zlecenia przekracza twoją aktualną pozycję, zostanie ono automatycznie dostosowane.
Na przykład masz długą pozycję 1 BTC w handlu futures (BTC-PERP).
Składasz Reduce-only zlecenie sprzedaży na 1,6 BTC, co jest większe niż twoja pozycja.
System wtedy weryfikuje zlecenie, sprawdzając, czy pozycja istnieje, czy rozmiar zlecenia jest w przeciwnym kierunku oraz czy przekracza aktualny rozmiar pozycji.
W tym przypadku:
- Zlecenie sprzedaży zostanie zmniejszone do 1 BTC i wykonane po cenie rynkowej
- Pozostała ilość zostanie zignorowana
- Pozycja zostanie całkowicie zamknięta
Dopasowanie przy modyfikacji zlecenia
Jeśli zmodyfikujesz istniejące zlecenie Reduce-only i zwiększysz jego rozmiar ponad twoją pozycję, system ponownie automatycznie je dostosuje.
Na przykład masz długą pozycję 1 BTC na BTC-PERP.
- Składasz Reduce-only zlecenie sprzedaży limit na 1 BTC po 45 000 USD.
- System akceptuje zlecenie i dodaje je do księgi zleceń.
- Modyfikujesz ilość z 1 BTC do 5 BTC.
- System wykrywa, że nowa ilość przekracza rozmiar Twojej pozycji.
- System automatycznie dostosowuje ilość z 5 BTC z powrotem do 1 BTC.
- Rynek osiąga 45 000 USD — zlecenie wykonuje 1 BTC, całkowicie zamykając Twoją pozycję.
Wiele zleceń Reduce-only i automatyczne anulowanie
Możesz złożyć kilka zleceń reduce-only na różnych poziomach cenowych. Każde zlecenie jest weryfikowane względem aktualnego rozmiaru twojej pozycji w momencie składania — niezależnie od innych otwartych zleceń. Następnie jest ponownie weryfikowane w momencie wykonania, co zapewnia, że zlecenie zawsze odzwierciedla rzeczywisty pozostały rozmiar pozycji. Po całkowitym zamknięciu pozycji wszystkie pozostałe zlecenia reduce-only są automatycznie anulowane.
Na przykład masz długą pozycję 1 BTC na BTC-PERP po 45 000 USD.
- Składasz Reduce-Only zlecenie sprzedaży limit Zlecenie A na 0,6 BTC po 44 000 USD.
- Składasz Reduce-Only zlecenie sprzedaży limit Zlecenie B na 0,7 BTC po 43 500 USD.
- Rynek spada do 44 000 USD — Zlecenie A wykonuje się, pozostawiając pozycję na 0,4 BTC.
- Rynek kontynuuje spadek do 43 500 USD — Zlecenie B jest automatycznie dostosowane do 0,4 BTC i wykonane.
- Twoja pozycja jest całkowicie zamknięta (pozostało 0 BTC).
- Wszystkie pozostałe Reduce-only zlecenia są automatycznie anulowane.
Kiedy zlecenia Reduce-only mogą zostać odrzucone?
Brak otwartej pozycji
Jeśli złożysz Reduce-Only zlecenie, ale nie masz otwartej pozycji na danym rynku, zlecenie zostanie odrzucone, ponieważ nie ma czego zmniejszać.
Na przykład nie masz otwartej pozycji na BTC-PERP.
- Próbujesz złożyć Reduce-only zlecenie sprzedaży limit na 0,5 BTC.
- System wykrywa, że pozycja nie istnieje.
- Zlecenie zostaje odrzucone.
Ten sam kierunek co pozycja
Jeśli zlecenie Reduce-only jest w tym samym kierunku co Twoja otwarta pozycja, zlecenie zostanie odrzucone. Jego wykonanie zwiększyłoby pozycję, co Reduce-only ma zapobiegać.
Na przykład masz długą pozycję 1 BTC na BTC-PERP.
- Próbujesz złożyć Reduce-only zlecenie kupna limit na 0,5 BTC (w tym samym kierunku co Twoja pozycja).
- System wykrywa, że strona zlecenia jest zgodna ze stroną pozycji.
- Zlecenie zostaje odrzucone.
API
Parametr „reduceOnly” jest obsługiwany we wszystkich endpointach zarządzania zleceniami zabezpieczającymi (collateral) — może być uwzględniany w żądaniach składania zleceń reduce-only i pojawia się w odpowiedziach, aby wskazać, czy istniejące zlecenie ma włączoną tę flagę.
| Link | Endpoint | Żądanie | Odpowiedź |
| Collateral limit order | /api/v4/order/collateral/limit | reduceOnly: true | reduceOnly: true |
| Collateral bulk limit order | /api/v4/order/collateral/bulk | reduceOnly: true | reduceOnly: true |
| Collateral market order | /api/v4/order/collateral/market | reduceOnly: true | reduceOnly: true |
| Collateral stop-limit order | /api/v4/order/collateral/stop-limit | reduceOnly: true | reduceOnly: true |
| Collateral trigger market order | /api/v4/order/collateral/trigger-market | reduceOnly: true | reduceOnly: true |
| Create collateral OCO order | /api/v4/order/collateral/oco | reduceOnly: true | reduceOnly: true |
| Query active orders | /api/v4/orders | - | reduceOnly: true |
| Query executed orders | /api/v4/trade-account/order/history | - | reduceOnly: true |
| Query unexecuted (conditional) orders | /api/v4/orders/conditional | - | reduceOnly: true |
Odpowiedź błędu
Jeśli zlecenie reduce-only zostanie złożone, gdy nie istnieje pozycja lub zlecenie zwiększyłoby pozycję, zwracany jest następujący błąd:
{
"code": 116,
"message": "Validation failed",
"errors": {
"reduceOnly": ["Reduce-only: Position doesn't exist or wrong side"]
}
}