RPI Emri Tanıtımı
Perakende Fiyat İyileştirme (RPI) emri, yalnızca onaylı piyasa yapıcılar için tasarlanmış özel bir emir türüdür. Yalnızca Uygulama veya Web arayüzü üzerinden verilen algoritmik olmayan emirlerle eşleşerek perakende yatırımcılara daha hedefli piyasa likiditesi ve daha iyi gerçekleşme fiyatları sunar. Aynı zamanda piyasa yapıcıların likidite sağlama emirlerini algoritmik emirlerle eşleşmekten koruyarak genel piyasa adaletini ve bütünlüğünü korur.
I. RPI Emri Nedir?
RPI emri, yalnızca beyaz listedeki piyasa yapıcıları tarafından OpenAPI aracılığıyla gönderilebilen özel bir limit emirdir. Dört temel özelliğe sahiptir:
• Hedefli Eşleştirme: Yalnızca Uygulama ve Web arayüzleri üzerinden iletilen algoritmik olmayan emirlerle eşleştirilir. API emirleriyle (diğer RPI emirleri dahil) veya grid bot emirleriyle eşleştirilmez.
• En düşük öncelik: Aynı fiyat seviyesinde, RPI emirleri yalnızca tüm RPI dışı emirler gerçekleştirildikten sonra eşleşmeye katılır.
• Yalnızca Yapıcı: Bunlar, emir defterine her zaman likidite sağlayan, asla likidite almayan pasif limit emirlerdir.
• Görünürlük Farkı: Uygulama ve Web arayüzlerinde normal şekilde görüntülenir; genel API emir defterinde görünmez.
II. RPI Emirlerini Kimler Gönderebilir?
RPI emirleri yalnızca onaylı, beyaz listedeki piyasa yapıcıları tarafından OpenAPI aracılığıyla gönderilebilir ve yalnızca beyaz listedeki işlem çiftleriyle kesinlikle sınırlıdır.
• Beyaz listede yer almayan piyasa yapıcılar tarafından yapılan gönderimlerde şu mesaj tetiklenecektir: "RPI emirleri yalnızca onaylı piyasa yapıcılara sunulmaktadır."
• Beyaz listede yer almayan işlem çiftleri için yapılan gönderimlerde şu mesaj tetiklenecektir: "RPI emirleri yalnızca belirli işlem çiftleri için desteklenmektedir."
III. RPI Emirleri Nasıl Gönderilir?
RPI emirleri yalnızca OpenAPI aracılığıyla gönderilebilir; hem REST hem de WebSocket yöntemleri desteklenmektedir. Emir verilirken, emir türü (type) limit emir (buy-limit veya sell-limit) olarak ayarlanmalı ve time-in-force alanı rpi olarak ayarlanmalıdır. Diğer tüm parametreler standart limit emirlerle aynı kalır.
REST Yöntemi
Spot, toplu ve marjin emir yerleştirme uç noktalarının tamamı RPI emirlerini destekler (type alanı, buy-limit veya sell-limit olmalıdır). Mevcut istek parametrelerine time-in-force alanını (rpi değeriyle) eklemeniz yeterlidir:
• Spot Emir Verme: POST /v1/order/orders/place
• Toplu Emir Verme: POST /v1/order/batch-orders
• Marjin Emir Verme: POST /v1/order/auto/place
İstek Örneği (Spot RPI Alış Emri):
{
"account-id": "12345",
"symbol": "btcusdt",
"type": "buy-limit",
"amount": "0.01",
"price": "50000",
"time-in-force": "rpi"
}
WebSocket Yöntemi
WebSocket işlem kanalları, REST API ile aynı parametreleri kullanarak RPI emir girişini de destekler:
• Spot Emir Verme: Kanal create-order
• Toplu Emir Verme: Kanal create-batchorder
• Marjin Emir Verme: Kanal create-margin-order
Yaygın Hata Kodları
| Hata Kodu |
Açıklama |
|
|
Mevcut hesap, RPI beyaz listesinde yer almıyor ve RPI emirleri göndermek için yetkilendirilmemiş. |
|
|
Bu işlem çifti RPI beyaz listesinde yer almamaktadır ve RPI emir gönderimini desteklememektedir. |
|
|
type değeri buy-limit veya sell-limit olmalıdır. |
|
|
RPI özelliği şu anda devre dışı. Lansman takvimini öğrenmek için lütfen operasyon ekibiyle iletişime geçin. |
Hangi İşlem Çiftleri RPI Emirlerini Destekler?
Get All Trading Pairs uç noktasını çağırın: GET /v2/settings/common/symbol. Yanıttaki her işlem çifti, bir enable_rpi alanı (boolean) içerir. True değeri, işlem çifti için RPI Desteği'nin etkin olduğunu; false değeri ise desteklenmediğini gösterir.
Yanıt Örneği (yalnızca temel alanlar):
{
"status": "ok",
"data": [
{ "sc": "btcusdt", "dn": "BTC/USDT", "enable_rpi": true },
{ "sc": "ethusdt", "dn": "ETH/USDT", "enable_rpi": false }
]
}
Bir işlem çifti için RPI desteklenmiyorken RPI emir isteği gönderilirse, sistem order-rpi-symbol-not-allowed hata kodunu döndürür.
IV. Eşleşme Kapsamı
RPI Emirleriyle Eşleştirilebilecek Emirler
• Kaynak: Uygulama / Web Arayüzü
• Türler: Piyasa emirleri, limit emirler, gelişmiş limit-FOK, gelişmiş limit-IOC, kâr al/zararı durdur emirleri, koşullu emirler tarafından tetiklenen piyasa/limit emirleri
• Özel: Copy trading / işlem takibi emirleri ve buzdağı emirleri normal emirler olarak değerlendirilir ve normal şekilde eşleştirilebilir
RPI Eşleştirmesine Uygun Olmayan Emirler
• Tüm API emirleri (diğer RPI emirleri ve API kanalları üzerinden tetiklenen koşullu emirler dahil)
• Grid bot emirleri
V. İşlem Kuralları
| Kural Öğesi |
Açıklama |
| Desteklenen Ürünler |
Spot (Marjin Dahil) |
| Emir Mekanizması |
Standart limit emirlerle aynıdır (aynı marjin gereksinimleri, minimum/maksimum emir boyutları ve fiyat limitleri) |
| Desteklenen İşlemler |
Toplu emir verme, değiştirme (fiyat/miktar), iptal etme, toplu emir iptali ve kısmi emir gerçekleşmesi |
| Uyumsuzluk |
Koşullu emirlerle (KA/ZD, tetik emir vb.) birleştirilemez |
| Fiyat Limiti |
Emir verilirken, emirler karşı taraftaki RPI dışı emirlerin fiyatını aşamaz; aksi takdirde iptal edilir |
Fiyat Limiti Örneği
• 99 fiyatıyla bir RPI alış emri gönderiliyor→ Kabul edildi.
• 102 fiyatıyla bir RPI alış emri gönderiliyor → Satış 2 (fiyat 102) konumundaki RPI olmayan emirle çakıştığından reddedildi
| Seviye |
Fiyat |
Miktar |
| Satış 2 |
102 |
25 |
| Satış 1 |
100 (RPI) |
15 |
| Alış 1 |
99 (RPI) |
10 |
| Alış 2 |
98 |
20 |
VI. Emir Görünürlüğü
| Modül |
Senaryo |
Açıklama |
| Emir Defteri |
Uygulama / Web |
RPI emirleri özel etiketler olmadan normal şekilde görüntülenir; fiyatlar kesiştiğinde otomatik olarak gizlenir. Gizlenen emirler eşleştirme motorunda aktif kalmaya devam eder ve koşullar sağlandığında gerçekleştirilebilir. |
| OpenAPI |
Görünmez. |
|
| Kişisel Emir Geçmişi |
Uygulama / Web |
Piyasa yapıcılar, mevcut ve geçmiş emir kayıtlarında RPI emirlerini ve "RPI" etiketini görüntüleyebilir; normal kullanıcıların emirlerinde herhangi bir özel etiket görünmez. |
| OpenAPI |
RPI emirleri normal şekilde görüntülenir ve normal emirlerden ayırt edilebilir. |
Fiyat-Kesişimi Gizleme Örnekleri
Örnek 1: Fiyatı kesişen iki RPI emri (alış fiyatı ≥ satış fiyatı) → Her iki taraf da gizlenir.
| / |
Fiyat |
Miktar |
Görünür |
| Satış 4 |
1.005 |
20 |
Evet |
| Satış 3 |
1.003 (RPI) |
15 |
Evet |
| Satış 2 |
1.001 (RPI) |
10 |
Hayır |
| Satış 1 |
999 (RPI) |
5 |
Hayır |
| Alış 1 |
1.002 (RPI) |
10 |
Hayır |
| Alış 2 |
1.000 (RPI) |
20 |
Hayır |
| Alış 3 |
998 |
25 |
Evet |
| Alış 4 |
997 (RPI) |
30 |
Evet |
Örnek 2: Bir RPI emri, bir API emri veya grid strateji emriyle kesişirse→ RPI emri gizlenir; karşı taraf emri normal şekilde görüntülenir
| / |
Fiyat |
Miktar |
Görünür |
| Satış 4 |
1.005 |
20 |
Evet |
| Satış 3 |
1.003 (RPI) |
15 |
Evet |
| Satış 2 |
1.001 (RPI) |
10 |
Hayır |
| Satış 1 |
999 (RPI) |
5 |
Hayır |
| Alış 1 |
1.002 (Grid Bot) |
10 |
Evet |
| Alış 2 |
1.000 (API) |
20 |
Evet |
| Alış 3 |
998 |
25 |
Evet |
| Alış 4 |
997 (RPI) |
30 |
Evet |
VII. Ücret Yapısı
RPI emirleri, piyasa yapıcısının orijinal Yapıcı Ücret Oranı'nın yerini alan özel bir RPI Yapıcı Ücret Oranı'na tabidir. RPI dışı emirler, orijinal ücret oranı üzerinden ücretlendirilmeye devam eder.
Özel RPI Ücret Oranı, GET /v2/reference/transact-fee-rate uç noktası aracılığıyla sorgulanabilir. Yanıt parametrelerine, mevcut etkin RPI Yapıcı Ücret Oranını temsil eden yeni bir rpiFeeRate alanı eklenmiştir. Alternatif olarak, HTX Piyasa Yapıcı Operasyonlar takımıyla doğrudan iletişime geçebilirsiniz.
VIII. API Uç Noktaları ve Veri Akışı Güncellemeleri
RPI emir mekanizmasını desteklemek amacıyla mevcut uç noktalar aşağıdaki kurallara göre düzenlenmiştir.
REST Piyasa Verileri
| Uç Nokta Adı |
HTTP İsteği |
Değişikliklerin Açıklaması |
| Emir Defteri Derinliği |
|
İsteğe bağlı bir includeRpi parametresi (Boolean, varsayılan false) ekler. true olarak ayarlandığında, toplanmamış derinlik verisi (step0) RPI emirlerini içerir. Diğer toplanmış kademeler etkilenmez. |
| Tam Emir Defteri Derinliği |
|
Yukarıdakiyle aynı, includeRpi parametresinin eklenmesiyle birlikte |
| Son Piyasa İşlemleri |
|
Her işlem için yanıt, bir isRpiişlem (Boolean) alanı ekler; true değeri, gerçekleşmenin bir RPI emri tarafından oluşturulduğunu gösterir. |
| Son İşlem Geçmişi |
|
Yukarıdakiyle aynı, ek olarak isRpiTrade alanı da bulunmaktadır |
| Tüm İşlem Çiftleri İçin Son Fiyat Bilgileri |
|
Yapısal değişiklik yok; RPI gerçekleşmeleri, metrikler içinde normal şekilde hesaba katılır. |
| Birleştirilmiş Piyasa Bildirimi Ayrıntıları |
|
Yapısal değişiklik yok; RPI gerçekleşmeleri, metrikler içinde normal şekilde hesaba katılır. |
| 24 Saatlik Piyasa Detayları |
|
Yapısal değişiklik yok; RPI gerçekleşmeleri, metrikler içinde normal şekilde hesaba katılır. |
| Mum Grafiği (K-Line) Verisi |
|
Yapısal değişiklik yok; RPI gerçekleşmeleri, metrikler içinde normal şekilde hesaba katılır. |
WebSocket Piyasa Verisi Akışı
| Kanal |
RPI Emirlerini İçerir |
Açıklama |
|
|
Hayır |
En İyi Alış/Satış ondalık verileri; RPI emirleri hesaplamalara dahil edilmez. |
|
|
Hayır |
Piyasa derinliği fiyat teklifleri, RPI bekleyen emirleri gönderiye dahil edilmez |
|
|
Evet (Yeni) |
RPI bekleyen emirleri toplamak için yeni bir push kanalı ekler. Protokol, derinlik kanalıyla tutarlıdır ve piyasa yapıcıların RPI dahil tam derinlik verilerine bağımsız olarak abone olmasına olanak tanır. |
|
|
Hayır |
Artımlı MBP derinliği; RPI emirleri gönderiye dahil edilmez. |
|
|
Hayır |
Tam MBP anlık görüntüsü; RPI emirleri gönderiye dahil edilmez. |
Emir Verme ve Emir Sorgulama Uç Noktaları (REST)
| Uç Nokta Adı |
HTTP İsteği |
Değişikliklerin Açıklaması |
| Spot Emir Verme |
|
time-in-force alanını ekler (değer: rpi) |
| Toplu Emir Verme |
|
time-in-force alanını ekler (değer: rpi). |
| Marjin Emri Ver |
|
time-in-force alanını ekler (değer: rpi). |
| Mevcut Açık Emirleri Sorgula |
|
Yanıta yeni bir zaman geçerliliği alanı eklendi (rpi değeri bir RPI emrini belirtir). |
| Emir Detaylarını Sorgula |
|
Yanıta yeni bir time-in-force alanı eklendi (rpi değeri bir RPI emrini belirtir). Yeni bir canceled-source enum değeri olan rpi_cancel eklendi; bu değer, emrin sistem tarafından RPI olmayan bir emirle fiyat kesişimi nedeniyle iptal edildiğini gösterir. |
| clientOrderId ile Sorgula |
|
Yanıta yeni bir time-in-force alanı eklendi (rpi değeri bir RPI emrini belirtir). Yeni bir canceled-source enum değeri olan rpi_cancel eklendi; bu değer, emrin sistem tarafından RPI olmayan bir emirle fiyat kesişimi nedeniyle iptal edildiğini gösterir. |
| İşlem Detayları |
|
Yanıta yeni bir time-in-force alanı eklendi (rpi değeri bir RPI emrini belirtir). Yeni bir canceled-source enum değeri olan rpi_cancel eklendi; bu değer, emrin sistem tarafından RPI olmayan bir emirle fiyat kesişimi nedeniyle iptal edildiğini gösterir. |
| Geçmiş Emirleri Ara |
|
Yanıta yeni bir time-in-force alanı eklendi (rpi değeri bir RPI emrini belirtir). Yeni bir canceled-source enum değeri olan rpi_cancel eklendi; bu değer, emrin sistem tarafından RPI olmayan bir emirle fiyat kesişimi nedeniyle iptal edildiğini gösterir. |
| Son 48 Saatteki Emir Geçmişi |
|
Yanıta yeni bir time-in-force alanı eklendi (rpi değeri bir RPI emrini belirtir). Yeni bir canceled-source enum değeri olan rpi_cancel eklendi; bu değer, emrin sistem tarafından RPI olmayan bir emirle fiyat kesişimi nedeniyle iptal edildiğini gösterir. |
| Mevcut ve Geçmiş İşlemler |
|
Yanıta yeni bir time-in-force alanı eklendi (rpi değeri bir RPI emrini belirtir). |
Emir Bildirimi (WebSocket)
| Kanal |
Açıklama |
Değişikliklerin Açıklaması |
|
|
Emir güncelleme bildirimi |
Yeni bir zaman-geçerlilik alanı eklendi (değer: rpi); bu alan, RPI emirleri ile normal emirler arasında gerçek zamanlı ayrım yapılmasını sağlar. |
|
|
Takas sonrası işlem ve emir iptali güncellemeleri |
Yeni bir time-in-force alanı eklendi (değer: rpi); fiyat geçişiyle tetiklenen iptallerin gerçek zamanlı olarak tanımlanmasını sağlayan yeni bir canceled-source enum değeri rpi_cancel eklendi. |
Yukarıdakiler RPI Emir belgelerini tamamlamaktadır.
