Genel Bakış
HTX Perakende Fiyat İyileştirme Programı, RPI emirleri aracılığıyla piyasa yapıcılar ve perakende yatırımcılar için kazan-kazan sonucu elde etmeyi amaçlayan bir mekanizmadır.
Program, yalnızca algoritmik olmayan emirlerle eşleşen bir emir türü (RPI emri) sunarak yapıcı emirlerini algoritmik emirler tarafından öncelikli olarak alınmaktan korur ve piyasa adaletini korur. Aynı zamanda yatırımcılara daha zengin piyasa likiditesi ve daha iyi gerçekleşme fiyatları sunar.
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 olmayan hesaplar RPI emri gönderdiğinde şu mesaj görüntülenir: Hesabınız RPI emirleri vermek için yetkilendirilmemiş.
- Futures işlemleri için RPI etkinleştirilmemişse aşağıdaki mesaj görüntülenir: Bu futures işlem çifti RPI emirlerini desteklemiyor.
- RPI işlevi platformda devre dışıysa şu mesaj görüntülenir: RPI işlevi şu anda devre dışı.
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 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
Tüm Futures V5 emir yerleştirme uç noktaları RPI emirlerini destekler (type alanı, limit olmalıdır). Mevcut istek parametrelerine ek olarak time_in_force alanını rpi olarak ayarlamanız yeterlidir:
- Futures Emir Verme:
POST /v5/order - Toplu Emir Verme:
POST /v5/batch-order
İstek örneği (yalnızca temel alanlar; eksiksiz parametreler için lütfen Futures Emir Verme API belgelerine başvurun):
{
"contract_code": "BTC-USDT",
"type": "limit",
"direction": "buy",
"price": "50000",
"vol": "1",
"time_in_force": "rpi"
}
WebSocket Yöntemi
WebSocket (WS) işlem kanalları, REST API ile aynı parametreleri kullanarak RPI emir girişini de destekler:
- Futures Emir Verme: Kanal
place_order - Toplu Emir Verme: Kanal
place_batch_orders
Yaygın Hata Mesajları
| Hata Mesajı |
Tetikleme |
| Hesabınız RPI emirleri vermek için yetkilendirilmemiş. |
Beyaz listede olmayan bir hesap, RPI emri vermeye çalışıyor |
| Bu futures işlem çifti RPI emirlerini desteklemiyor. |
Bu futures ürünü için RPI etkinleştirilmemiş (enable_rpi=false) |
| RPI işlevi şu anda devre dışı. |
RPI genel anahtarı platformda devre dışı bırakılmıştır |
| RPI emir tipi limit olmalıdır. |
RPI emri verilirken tip limit olarak ayarlanmamış. |
Hangi Futures İşlem Çiftleri RPI Emirlerini Destekler?
GET /linear-swap-api/v1/swap_contract_info futures bilgi uç noktasını çağırın. Yanıttaki her futures işlem çifti, bir enable_rpi alanı (Boole) içerir. True değeri, futures ç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": [
{
"contract_code": "BTC-USDT",
"enable_rpi": true
},
{
"contract_code": "ETH-USDT",
"enable_rpi": false
}
]
}
RPI desteklemeyen bir futures işlem çifti için RPI emir isteği gönderilirse, sistem "Bu futures işlem çifti RPI emirlerini desteklemiyor" hata mesajını döndürür.
IV. Eşleşme Kapsamı
RPI Emirleriyle Eşleştirilebilecek Emirler
- Kaynak: Uygulama / Web Arayüzü
- Tür: Manuel olarak gönderilen, algoritmik olmayan emirler
RPI Eşleştirmesine Uygun Olmayan Emirler
- Tüm API emirleri (diğer RPI emirleri dahil)
- Grid bot emirleri
V. İşlem Kuralları
| Kural Öğesi |
Açıklama |
| Desteklenen Ürünler |
USDT Swap |
| 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
- 64.900 fiyatıyla bir RPI alış emri gönderiliyor → Kabul edildi.
- 65.020 fiyatıyla bir RPI alış emri gönderiliyor → Satış 2 (fiyat 65.020) konumundaki RPI olmayan emirle çakıştığından reddedildi.
| Seviye |
Fiyat |
Miktar |
| Satış 2 |
65.020 |
25 |
| Satış 1 |
65.000 (RPI) |
15 |
| Alış 1 |
64.900 (RPI) |
10 |
| Alış 2 |
64.880 |
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. |
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 /linear-swap-api/v1/swap_fee uç noktası aracılığıyla sorgulanabilir. Yanıt parametrelerine, mevcut etkin RPI Yapıcı Ücret Oranını temsil eden yeni bir rpi_fee_rate alanı eklenmiştir. RPI, futures işlem çiftine uygulanmıyorsa boş bir dize döndürülür. 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
Futures RPI emir mekanizmasını desteklemek amacıyla mevcut uç noktalar aşağıdaki kurallara göre düzenlenmiştir.
Futures Temel Bilgileri (REST)
| Uç Nokta Adı |
HTTP İsteği |
Değişikliklerin Açıklaması |
| Futures Bilgileri |
|
Yanıt parametreleri, futures işlem çiftinin RPI emirlerini destekleyip desteklemediğini gösteren yeni bir enable_rpi (Boolean) alanı içerir. |
Emir Verme ve Emir Sorgulama Uç Noktaları (REST)
| Uç Nokta Adı |
HTTP İsteği |
Değişikliklerin Açıklaması |
| Futures Emirleri Ver |
|
"time_in_force" istek parametresine yeni bir sayılandırılmış değer olan "rpi" eklendi. |
| Toplu Emir Verme |
|
"time_in_force" istek parametresine yeni bir sayılandırılmış değer olan "rpi" eklendi. |
| Mevcut Açık Emirleri Sorgula |
|
Yanıttaki "time_in_force" alanına yeni bir "rpi" değeri eklendi. |
| Emir Geçmişini Görüntüle |
|
"time_in_force" yanıt alanına yeni bir "rpi" değeri eklenmiştir. Ayrıca "cancel_reason" artık yeni bir iptal nedeni içermektedir: RPI emir fiyatları, RPI olmayan emir fiyatlarını geçemez. |
| Emir Detaylarını Sorgula |
|
"time_in_force" yanıt alanına yeni bir "rpi" değeri eklenmiştir. Ayrıca "cancel_reason" artık yeni bir iptal nedeni içermektedir: RPI emir fiyatları, RPI olmayan emir fiyatlarını geçemez. |
Emir Bildirimi (Websocket)
| Kanal |
Açıklama |
Değişikliklerin Açıklaması |
|
|
Emir güncelleme bildirimi |
"time_in_force" alanına yeni bir "rpi" değeri eklenmiştir, bu sayede RPI emirleri normal emirlerden gerçek zamanlı olarak ayırt edilebilir. Ayrıca "cancel_reason" artık yeni bir iptal nedeni içermektedir: RPI emir fiyatları, RPI olmayan emir fiyatlarını geçemez. |
|
|
İşlem detayları bildirimi |
"time_in_force" alanına yeni bir "rpi" değeri eklenmiştir. Ayrıca cancel_reason artık yeni bir iptal nedeni içermektedir: RPI emir fiyatları, RPI olmayan emir fiyatlarını geçemez. |
REST Piyasa Verileri
| Uç Nokta Adı |
HTTP İsteği |
Değişikliklerin Açıklaması |
| Emir Defteri Derinliği |
|
İsteğe bağlı bir "include_rpi" parametresi ekler (Boolean, varsayılan false). true olarak ayarlandığında, yanıt RPI emir defteri derinliğini içerir. false olarak ayarlandığında, davranış mevcut endpoint ile aynı kalır. |
| En İyi Fiyat Seviyesi |
|
RPI emirleri dahil edilmez ve herhangi bir değişiklik gerekmez. RPI emirleri dahil en iyi fiyat seviyelerini elde etmek için üst düzey verileri almak amacıyla "GET /linear-swap-ex/market/depth?include_rpi=true" kullanın. |
| Birleştirilmiş Detaylar |
|
Emir defteri derinliği RPI emirlerini içermezken, işlem verileri RPI emirlerini içerir. |
| Toplu Birleştirilmiş Detaylar |
|
Emir defteri derinliği RPI emirlerini içermezken, işlem verileri RPI emirlerini içerir. |
| 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. |
| Son Piyasa İşlemleri |
|
Her işlem için yanıt, bir "is_rpi_trade (Boolean) alanı ekler; "true" değeri, gerçekleşmenin bir RPI emri tarafından oluşturulduğunu gösterir. |
| Son İşlem Geçmişi |
|
"is_rpi_trade" alanının eklenmesi dışında yukarıdakiyle aynı |
| Futures Ücret Oranı Sorgulama |
|
Yanıt parametrelerine yeni bir "rpi_fee_rate" alanı eklendi. |
Websocket Piyasa Verisi Akışı
| Kanal |
RPI Emirlerini İçerir |
Açıklama |
|
|
Hayır |
En iyi fiyat seviyesi push bildirimi; RPI emirleri dahil değildir. |
|
|
Hayır |
Piyasa derinliği push bildirimi; RPI emirleri dahil değildir. |
|
|
Evet (Yeni) |
RPI emirlerini 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ı derinlik push bildirimi; RPI emirleri dahil değildir. |
|
|
— |
Grafik push; RPI gerçekleşmeleri metriklere normal şekilde dahil edilir. |
|
|
— |
Birleştirilmiş detaylar push; RPI gerçekleşmeleri metriklere normal şekilde dahil edilir. |
|
|
— |
İşlem detayları push; RPI gerçekleşmeleri metriklere normal şekilde dahil edilir; RPI gerçekleşmelerini tanımlamak için yeni bir "is_rpi_trade" alanı eklenir. |
HTX Ekibi
20 Eylül 2026