Zlecenia Retail Price Improvement (RPI) na Bitget
[Szacowany czas czytania: 5 minut]
Zlecenie Retail Price Improvement (RPI) to specjalny rodzaj zlecenia dostępny w ramach modelu ujednoliconego konta handlowego. Zostało zaprojektowane w celu zwiększenia płynności poprzez dopasowywanie wyłącznie zleceń niealgorytmicznych (tj. zleceń nie składanych za pośrednictwem OpenAPI). Ten typ zlecenia zapewnia kwalifikującym się zleceniom detalicznym lepsze ceny realizacji, co pozwala uzyskać korzystniejsze ceny i zmniejszyć poślizg cenowy.
Podstawowe mechanizmy zleceń RPI
1. Logika dopasowywania: zlecenia RPI są dopasowywane wyłącznie do zleceń niealgorytmicznych. Nie realizują zleceń złożonych za pośrednictwem OpenAPI.
2. Rodzaj zlecenia: Wszystkie zlecenia RPI są zleceniami pasywnymi i należą do kategorii zleceń makera. Realizują wyłącznie zlecenia takera, zwiększając w ten sposób płynność księgi zleceń.
3. Priorytet realizacji: Przy tym samym poziomie ceny zlecenia RPI mają niższy priorytet realizacji w porównaniu ze zleceniami niebędącymi zleceniami RPI, niezależnie od czasu ich złożenia. Zlecenia RPI po określonym poziomie ceny zostaną zrealizowane dopiero po całkowitej realizacji wszystkich zleceń niebędących zleceniem RPI po tej samej cenie.
Jak złożyć zlecenie RPI?
1. Zlecenia RPI można składać za pośrednictwem REST API lub WebSocket API. Zlecenie musi być ustawione jako limit z timeInForce = rpi.
2. Tylko wyznaczeni partnerzy będący animatorami rynku mogą składać zlecenia RPI. Jeśli nieuprawniony animator rynku spróbuje złożyć zlecenie, otrzyma następujący komunikat o błędzie: „Twoje konto nie jest uprawnione do składania zleceń RPI dla tego instrumentu”.
Zasady handlu ze zleceniami RPI
1. Zlecenia RPI są obsługiwane zarówno w trybie isolated margin, jak i cross margin w ramach ujednoliconego konta handlowego. Są one dostępne do obrotu na rynkach kontraktów futures, spot i margin.
2. Zlecenia RPI nie są obsługiwane podczas handlu pre-market. Można je składać wyłącznie po zakończeniu aukcji opcji kupna; w przeciwnym razie zlecenie zostanie odrzucone.
3. Logika walidacji zleceń RPI jest taka sama jak w przypadku zwykłych zleceń z limitem. Wymagania dotyczące depozytu zabezpieczającego, minimalnej i maksymalnej wielkości zlecenia oraz limitów otwartych pozycji (OI) są identyczne jak w przypadku standardowych zleceń z limitem ceny.
4. Limity cenowe dla zleceń RPI
a. W przypadku kontraktów futures:
• Zlecenie kupna: cena referencyjna × 110% ≥ cena zlecenia RPI ≥ cena referencyjna × 50%
• Zlecenie sprzedaży: cena referencyjna × 150% ≥ cena zlecenia RPI ≥ cena referencyjna × 90%
b. W przypadku transakcji spot i transakcji z depozytem zabezpieczającym:
• Zlecenie kupna: ostatnia cena transakcyjna × 110% ≥ cena zlecenia RPI ≥ ostatnia cena transakcyjna × 70%
• Zlecenie sprzedaży: ostatnia cena transakcyjna × 130% ≥ cena zlecenia RPI ≥ ostatnia cena transakcyjna × 90%
Uwaga: Podane powyżej progi (50%, 90%, 110%, 150%) mają charakter wyłącznie informacyjny. Parametry te można konfigurować dla poszczególnych par handlowych, a platforma zastrzega sobie prawo do ich dostosowywania w zależności od warunków rynkowych.
5. Zlecenia RPI obsługują umieszczanie partii, modyfikację zleceń (w tym cenę i ilość) oraz anulowanie.
6. Zlecenia RPI nie mogą być stosowane w połączeniu ze strategiami zleceń (takimi jak zlecenia stop-loss, take-profit lub stop-loss-limit).
7. Zlecenia RPI nie mogą być realizowane w stosunku do zleceń niebędących zleceniami RPI po przeciwnej stronie. Gdy strona przeciwna składa się wyłącznie ze zleceń RPI, transakcje mogą być nadal realizowane, ale zlecenia RPI nie będą dopasowywane z innymi zleceniami RPI.
8. Wahania rynkowe mogą spowodować, że zlecenia kupna RPI będą miały wyższą cenę niż najlepsza oferta kupna niebędąca RPI lub że zlecenia sprzedaży RPI będą miały niższą cenę niż najlepsza oferta sprzedaży niebędąca RPI. Takie zlecenia RPI są uznawane za nieważne i nie będą realizowane, choć pozostaną w księdze zleceń. Zostaną one ponownie aktywowane, gdy pojawią się kolejne konkurencyjne cenowo zlecenia nieobjęte wskaźnikiem RPI.
Wyświetlanie zleceń RPI
1. Księga zleceń API: zlecenia RPI są wyświetlane w księdze zleceń API.
2. Księga zleceń na stronie handlu: zlecenia RPI są wyświetlane w interfejsie handlowym bez żadnych specjalnych oznaczeń.
Aby zapewnić porządek w księdze, krzyżowe zlecenia RPI (gdzie cena kupna jest wyższa od ceny sprzedaży) są ukryte. Więcej szczegółowych informacji na temat krzyżowych zleceń RPI można znaleźć w poniższych przykładach:
Przykład 1
Księga zleceń przedstawia się następująco:
|
|
Cena |
Ilość |
|
Ask 2 |
1002 |
200 |
|
Ask 1 |
1000 (RPI) |
100 |
|
Bid 1 |
999 (RPI) |
90 |
|
Bid 2 |
998 |
120 |
• Przyjęto nowe zlecenie kupna RPI po cenie 1000.
• Przyjęto nowe zlecenie kupna RPI po cenie 1001.
• Nowe zlecenie kupna RPI po cenie 1002 zostaje odrzucone, ponieważ na poziomie ceny Ask 2 znajduje się zlecenie niebędące zleceniem RPI.
Księga zleceń na stronie handlu:
Kiedy pojawia się krzyż:
• Zlecenia krzyżowe RPI są ukryte w księdze zleceń na stronie handlu. Jednak nadal są one aktywne w silniku dopasowywania i gotowe do realizacji zgodnie z zasadami.
• Zlecenia niekrzyżowe RPI są widoczne bez specjalnego oznaczenia.
Przykład 2
Księga zleceń wygląda następująco. Zlecenia krzyżowe RPI są ukryte i nie są realizowane względem siebie.
|
|
Cena |
Ilość |
Widoczne? |
|
Ask 4 |
1004 |
200 |
Tak |
|
Ask 3 |
1003 (RPI) |
150 |
Tak |
|
Ask 2 |
1001 (RPI) |
100 |
Nie |
|
Ask 1 |
999 (RPI) |
50 |
Nie |
|
Bid 1 |
1002 (RPI) |
100 |
Nie |
|
Bid 2 |
1000 (RPI) |
200 |
Nie |
|
Bid 3 |
999 |
200 |
Tak |
|
Bid 4 |
996 (RPI) |
300 |
Tak |
W danych/strumieniu księgi zleceń w API wszystkie zlecenia RPI są wykluczone.
OpenAPI i głębokość danych
1. Głębokość RPI
1.1 REST
• GET /api/v3/market/rpi-orderbook
• Limit szybkości: 10 żądań/s
|
Nazwa parametru |
Typ parametru |
Żądanie–odpowiedź |
Wymagane? |
Opis |
|
kategoria
|
Ciąg znaków
|
Parametr żądania
|
Tak
|
Linia produktów spot Spot usdt-futures Futures USDT-M coin-futures Futures Coin-M usdc-futures Futures USDC-M |
|
symbol |
Ciąg znaków |
Parametr żądania |
Tak |
Nazwa pary handlowej |
|
limit |
Ciąg znaków |
Parametr żądania |
Nie
|
Poziom głębokości spot maks.: 200, domyślnie: 5 usdt-futures, coin-futures, usdc-futures maks.: 200, domyślnie: 5 |
|
a |
Tablica
|
Parametr odpowiedzi |
/ |
Głębokość sprzedaży • Posortowane według ceny w porządku rosnącym |
|
> Indeks 0 |
Ciąg znaków |
Parametr odpowiedzi |
/ |
Cena sprzedaży |
|
> Indeks 1 |
Ciąg znaków |
Parametr odpowiedzi |
/ |
Ilość sprzedana bez RPI |
|
> Indeks 2 |
Ciąg znaków |
Parametr odpowiedzi |
/ |
Ilość sprzedana z RPI |
|
b |
Tablica |
Parametr odpowiedzi |
/ |
Głębokość zakupu • Posortowane według ceny w kolejności malejącej |
|
> Indeks 0 |
Ciąg znaków |
Parametr odpowiedzi |
/ |
Cena zakupu |
|
> Indeks 1 |
Ciąg znaków |
Parametr odpowiedzi |
/ |
Ilość zakupu bez RPI |
|
> Indeks 2 |
Ciąg znaków |
Parametr odpowiedzi |
/ |
Ilość zakupu RPI |
|
ts |
Ciąg znaków |
Parametr odpowiedzi |
/ |
Sygnatura czasowa systemu dla generowania danych • Sygnatura czasowa Unix w milisekundach |
1.2 WebSocket
1.2.1 Parametry żądania
|
Nazwa parametru |
Typ |
Wymagane? |
Opis |
|
op |
Ciąg znaków |
Tak |
Działanie subscribe Subskrybuj unsubscribe Zakończ subskrypcję |
|
args |
Lista <Object> |
Tak |
Lista kanałów, które można subskrybować |
|
> instType |
Ciąg znaków
|
Tak |
Rodzaj produktu spot Spot usdt-futures Futures USDT-M coin-futures Futures Coin-M usdc-futures Futures USDC-M |
|
> topic |
Ciąg znaków
|
Tak
|
Nazwa kanału rpi-books Kanały wszystkich poziomów rpi-books1 Kanały poziomu 1 rpi-books5 Kanały poziomu 5 rpi-books50 Kanały poziomu 50 |
|
> symbol |
Ciąg znaków
|
Tak |
Nazwa pary handlowej Na przykład: BTCUSDT |
1.2.2 Parametry zwrotne
|
Parametr |
Typ |
Opis |
|
event |
Ciąg znaków |
Wydarzenie subscribe Subskrybuj unsubscribe Zakończ subskrypcję error Błąd parametru |
|
arg |
Obiekt |
Subskrybowane kanały |
|
> instType |
Ciąg znaków |
Rodzaj produktu spot Spot usdt-futures Futures USDT-M coin-futures Futures Coin-M usdc-futures Futures USDC-M |
|
> topic |
Ciąg znaków |
Nazwa kanału rpi-books Kanały wszystkich poziomów rpi-books1 Kanały poziomu 1 rpi-books5 Kanały poziomu 5 rpi-books50 Kanały poziomu 50 |
|
code |
Ciąg znaków |
Kod błędu |
|
msg |
Ciąg znaków |
Komunikat o błędzie |
1.2.3 Parametry push
|
Parametr |
Typ |
Opis |
|
arg |
Obiekt |
Subskrybowane kanały |
|
> instType |
Ciąg znaków
|
Rodzaj produktu spot Spot usdt-futures Futures USDT-M coin-futures Futures Coin-M usdc-futures Futures USDC-M |
|
> symbol |
Ciąg znaków |
Nazwa pary handlowej |
|
> topic |
Ciąg znaków |
Nazwa kanału |
|
action |
Ciąg znaków |
Działanie przesyłania danych snapshot Pełne update Przyrost |
|
data |
Lista <Object> |
Dane dotyczące subskrypcji |
|
> a |
Ciąg znaków |
Głębokość sprzedaży |
|
>> a[0] |
Ciąg znaków |
Cena sprzedaży |
|
>> a[1] |
Ciąg znaków |
Ilość sprzedana bez RPI |
|
>> a[2] |
Ciąg znaków |
Ilość sprzedana z RPI |
|
> b |
Ciąg znaków |
Głębokość zakupu |
|
>> b[0] |
Ciąg znaków |
Cena zakupu |
|
>> b[1] |
Ciąg znaków |
Ilość zakupu bez RPI |
|
>> b[2] |
Ciąg znaków |
Ilość zakupu RPI |
|
> ts |
Ciąg znaków |
Dopasowanie znacznika czasu |
|
> seq |
Ciąg znaków |
Numer sekwencyjny |
|
> previousSeq |
Ciąg znaków |
Numer sekwencji z poprzedniego przesłania push |
2. Informacje handlowe
Do punktów końcowych i kanałów handlowych platformy dodano identyfikator typu RPI.
• Ostatnie transakcje: /api/v3/market/fills
• Szczegóły transakcji: /api/v3/trade/fills
• Kanał handlu publicznego: topic=publicTrade
• Kanał handlu prywatnego: topic=fill
|
Nazwa parametru |
Typ parametru |
Żądanie–odpowiedź |
Wymagane? |
Opis |
|
isRPI
|
Ciąg znaków
|
Parametr odpowiedzi |
/
|
Handel typu RPI? yes Tak no Nie |
3. Składanie zleceń i zleceń zbiorczych
Typ rpi został dodany do strategii realizacji zleceń dla punktów końcowych składania zleceń pojedynczych i zbiorczych.
• Złóż zlecenie: POST /api/v3/trade/place-order
• Złóż zlecenie zbiorcze: POST /api/v3/trade/place-batch
• Kanał składania zleceń: topic=place-order
• Kanał składania zleceń zbiorczych: topic=batch-place
|
Nazwa parametru |
Typ parametru |
Żądanie–odpowiedź |
Wymagane? |
Opis |
|
timeInForce
|
Ciąg znaków
|
Parametr żądania
|
Tak
|
Strategia realizacji zleceń ioc (immediate or cancel) fok (fill or kill) gtc (good till canceled) post_only Post only rpi Zlecenia Retail Price Improvement Wymagane, jeśli typ zlecenia to zlecenie z limitem (limit), domyślnie gtc, jeśli pole pozostanie puste. |
4. Informacje o zleceniach, otwarte zlecenia i historia zleceń
• Informacje o zleceniu: GET /api/v3/trade/order-info
• Otwarte zlecenia: GET /api/v3/trade/unfilled-orders
• Historia zleceń: GET /api/v3/trade/history-orders
• Kanał zlecenia: topic=order
|
Nazwa parametru |
Typ parametru |
Żądanie–odpowiedź |
Wymagane? |
Opis |
|
timeInForce
|
Ciąg znaków
|
Parametr odpowiedzi
|
Tak
|
Strategia realizacji zleceń ioc (immediate or cancel) fok (fill or kill) gtc (good till canceled) post_only Post only rpi Zlecenia Retail Price Improvement |
Często zadawane pytania
1. Czym jest zlecenie Retail Price Improvement (RPI)?
Zlecenie RPI jest specjalnym rodzajem zlecenia w ramach modelu ujednoliconego konta handlowego. Dopasowuje się tylko do zleceń niealgorytmicznych (tj. zleceń niebędących OpenAPI) w celu zwiększenia płynności. Zapewnia kwalifikującym się zleceniom detalicznym lepsze ceny realizacji, co pozwala na poprawę ceny i zmniejszenie poślizgu.
2. Czy zlecenia RPI są zleceniami typu maker czy taker?
Rodzaj zlecenia: Wszystkie zlecenia RPI są zleceniami pasywnymi i należą do kategorii zleceń makera. Realizują wyłącznie zlecenia takera, zwiększając w ten sposób płynność księgi zleceń.
3. Jaki jest priorytet realizacji zleceń RPI przy tym samym poziomie ceny?
Priorytet realizacji: Przy tym samym poziomie ceny zlecenia RPI mają niższy priorytet realizacji w porównaniu ze zleceniami niebędącymi zleceniami RPI, niezależnie od czasu ich złożenia. Zlecenia RPI po określonym poziomie ceny zostaną zrealizowane dopiero po całkowitej realizacji wszystkich zleceń niebędących zleceniem RPI po tej samej cenie.
4. Które linie produktów i tryby depozytu zabezpieczającego obsługują zlecenia RPI?
Zlecenia RPI są obsługiwane zarówno w trybie isolated margin, jak i cross margin w ramach ujednoliconego konta handlowego. Są one dostępne do obrotu na rynkach kontraktów futures, spot i margin. Zlecenia RPI nie są obsługiwane podczas handlu pre-market. Można je składać wyłącznie po zakończeniu aukcji opcji kupna; w przeciwnym razie zlecenie zostanie odrzucone.
5. Czy logika walidacji zleceń RPI jest taka sama jak w przypadku zwykłych zleceń z limitem ceny?
Logika walidacji zleceń RPI jest taka sama jak w przypadku zwykłych zleceń z limitem. Wymagania dotyczące depozytu zabezpieczającego, minimalnej i maksymalnej wielkości zlecenia oraz limitów otwartych pozycji (OI) są identyczne jak w przypadku standardowych zleceń z limitem ceny.