HTX Futures Perakende Fiyat İyileştirme Programı (RPI Emirleri)

20.09 14:42:11 (UTC+3)USDT Teminatlı Futures Rehberi

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

GET /linear-swap-api/v1/swap_contract_info

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

POST /v5/order

"time_in_force" istek parametresine yeni bir sayılandırılmış değer olan "rpi" eklendi.

Toplu Emir Verme

POST /v5/batch-order

"time_in_force" istek parametresine yeni bir sayılandırılmış değer olan "rpi" eklendi.

Mevcut Açık Emirleri Sorgula

GET /v5/trade/order/opens

Yanıttaki "time_in_force" alanına yeni bir "rpi" değeri eklendi.

Emir Geçmişini Görüntüle

GET /v5/trade/order/history

"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

GET /v5/trade/order

"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ı

orders.$contract_code

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.

match_orders.$contract_code

İş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

GET /linear-swap-ex/market/depth

İ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

GET /linear-swap-ex/market/bbo

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

GET /linear-swap-ex/market/detail/merged

Emir defteri derinliği RPI emirlerini içermezken, işlem verileri RPI emirlerini içerir.

Toplu Birleştirilmiş Detaylar

/v2/linear-swap-ex/market/detail/batch_merged

Emir defteri derinliği RPI emirlerini içermezken, işlem verileri RPI emirlerini içerir.

Mum Grafiği (K-Line) Verisi

GET /linear-swap-ex/market/history/kline

Yapısal değişiklik yok; RPI gerçekleşmeleri, metrikler içinde normal şekilde hesaba katılır.

Son Piyasa İşlemleri

GET /linear-swap-ex/market/trade

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

GET /linear-swap-ex/market/history/trade

"is_rpi_trade" alanının eklenmesi dışında yukarıdakiyle aynı

Futures Ücret Oranı Sorgulama

GET /linear-swap-api/v1/swap_fee

Yanıt parametrelerine yeni bir "rpi_fee_rate" alanı eklendi.

Websocket Piyasa Verisi Akışı

Kanal

RPI Emirlerini İçerir

Açıklama

market.$contract_code.bbo

Hayır

En iyi fiyat seviyesi push bildirimi; RPI emirleri dahil değildir.

market.$contract_code.depth.$type

Hayır

Piyasa derinliği push bildirimi; RPI emirleri dahil değildir.

market.$contract_code.full_depth.$type

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.

market.$contract_code.depth.size_${size}.high_freq

Hayır

Artımlı derinlik push bildirimi; RPI emirleri dahil değildir.

market.$contract_code.kline.$period

—

Grafik push; RPI gerçekleşmeleri metriklere normal şekilde dahil edilir.

market.$contract_code.detail

—

Birleştirilmiş detaylar push; RPI gerçekleşmeleri metriklere normal şekilde dahil edilir.

market.$contract_code.trade.detail

—

İş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