Uzlaşma ve Vade Sonu

Hypercall üzerindeki opsiyonlar Avrupa tipidir ve nakit olarak uzlaşılır. Vade sonunda, pozisyonlar dayanak varlığın referans fiyatına göre otomatik olarak uzlaşılır ve uzlaşma değeri hesabınıza alacak veya borç olarak yansıtılır.

Vade Sonu Zamanı

Ana ağ üzerinde, SpaceX (SPCX) kontratlarının vadesi, vade sonu tarihinde ET saatiyle 16:00'da dolar.

Testnet üzerinde vade şu anda vade sonu tarihinde 08:00 UTC saatinde dolmaktadır.

Vade sonunda:

• Yeni emirler reddedilir
• Açık emirler iptal edilir
• Pozisyonlar uzlaşma sürecine girer

Enstrüman Yaşam Döngüsü

Enstrümanlar üç durumdan geçer:

Durum	Açıklama	İşlem
Active	Normal işlem	Etkin
Expired Pending Price	Oracle'dan uzlaşma fiyatı bekleniyor	Devre dışı
Settled	Uzlaşma tamamlandı, pozisyonlar kapatıldı	Yok

Durum Geçişleri

1. Active → Expired Pending Price: Kontratın vade sonu zamanına ulaşıldı
2. Expired Pending Price → Settled: Uzlaşma fiyatı mevcut ve tüm pozisyonlar uzlaşıldı

Bir enstrüman Expired Pending Price durumuna girdiğinde, tüm açık emirler iptal edilir ve yeni emirler "Instrument has expired" mesajıyla reddedilir.

Uzlaşma Fiyatı

Uzlaşma fiyatı, dayanak varlık için Hyperliquid Oracle endeks fiyatının 30 dakikalık TWAP'ıdır (Zaman Ağırlıklı Ortalama Fiyat).

Parametre	Değer
Fiyat kaynağı	Hyperliquid Oracle (endeks fiyatı)
TWAP penceresi	30 dakika
Pencere sonu	Kontratın vade sonu zamanı

Oracle, vade sonundan 30 dakika önce örnekleme yapmaya başlar ve vade sonu zamanında TWAP'ı hesaplar.

Uzlaşma, nihai hale getirilmiş TWAP'ı gerektirir. Vade sonu anında nihai fiyat mevcut değilse, enstrüman Expired Pending Price durumunda kalır ve otomatik olarak yeniden dener. Bu durumda işlem zaten devre dışıdır, ancak nakit alacak ve borçlar yalnızca nihai oracle fiyatı mevcut olduktan sonra işlenir.

Uzlaşma Değeri Hesaplaması

Uzlaşma, opsiyonun vade sonundaki içsel değeri olarak hesaplanır:

Alım Opsiyonları:

$$\text{Uzlaşma Değeri} = \max(0, S - K) \times Q$$

Satım Opsiyonları:

$$\text{Uzlaşma Değeri} = \max(0, K - S) \times Q$$

Burada:

• $S$ = Uzlaşma fiyatı (30 dakikalık TWAP)
• $K$ = Kullanım fiyatı
• $Q$ = Pozisyon büyüklüğü (işaretli: long için pozitif, short için negatif)

Örnekler

Long Alım Opsiyonu (Karda - ITM):

• Pozisyon: Long 2 BTC-100000-C
• Uzlaşma fiyatı: 105.000 $
• İçsel değer: max(0, 105000 - 100000) = 5.000 $
• Uzlaşma değeri: 5.000 $× 2 = **+10.000$** (alacak)

Short Alım Opsiyonu (Karda - ITM):

• Pozisyon: Short 2 BTC-100000-C
• Uzlaşma fiyatı: 105.000 $
• Uzlaşma değeri: 5.000 $× -2 = **-10.000$** (borç)

Long Satım Opsiyonu (Zararda - OTM):

• Pozisyon: Long 1 BTC-100000-P
• Uzlaşma fiyatı: 105.000 $
• İçsel değer: max(0, 100000 - 105000) = 0 $
• Uzlaşma değeri: 0 $ (değersiz olarak sona erer)

Uzlaşma Süreci

Uzlaşma gerçekleştiğinde:

1. Fiyat alınır: Oracle, 30 dakikalık TWAP'ı döndürür
2. Değer hesaplanır: Her pozisyon için içsel değer hesaplanır
3. Nakit güncellenir: Uzlaşma değeri hesap bakiyesine eklenir (long ITM) veya bakiyeden düşülür (short ITM)
4. Pozisyon kaldırılır: Pozisyon kapatılır ve portföyden çıkarılır
5. Olay yayımlanır: WebSocket üzerinden PositionExpired mesajı gönderilir

Uzlaşma, her pozisyon için atomik olarak ve idempotentlik garantileriyle işlenir. Tekrarlar veya yeniden başlatmalar çifte uzlaşmaya neden olamaz.

WebSocket Olayları

PositionExpired

Bir pozisyon uzlaşıldığında gönderilir:

{
  "type": "PositionExpired",
  "wallet_address": "0x...",
  "symbol": "BTC-20250131-100000-C",
  "position_size": 2.0,
  "settlement_price": 5000.0,
  "settlement_value": 10000.0,
  "timestamp": 1738310400000
}

Alan	Açıklama
position_size	İşaretli pozisyon büyüklüğü (pozitif = long, negatif = short)
settlement_price	Kontrat başına içsel değer
settlement_value	Toplam nakit uzlaşma tutarı

MarketExpired

Bir enstrüman Expired Pending Price durumuna geçtiğinde gönderilir:

{
  "type": "MarketUpdate",
  "symbol": "BTC-20250131-100000-C",
  "status": "MARKET_EXPIRED",
  "timestamp": 1738310400000
}

API Uç Noktaları

Enstrüman Durumunu Al

GET /instruments/{symbol}

Enstrümanın mevcut durumunu döndürür (ACTIVE, EXPIRED_PENDING_PRICE veya SETTLED).

Uzlaşma Geçmişini Al

GET /settlement/history?wallet=0x...

Hesabınız için uzlaşma kayıtlarını döndürür.

Yanıt:

{
  "success": true,
  "data": [
    {
      "symbol": "BTC-20250131-100000-C",
      "position_size": 2.0,
      "settlement_price": 5000.0,
      "settlement_value": 10000.0,
      "settled_at": 1738310400000
    }
  ]
}

Hata Yönetimi

Oracle Erişilemez Durumda

Oracle, vade sonunda bir uzlaşma fiyatı sağlayamazsa:

• Enstrüman Expired Pending Price durumunda kalır
• Sistem her 30 saniyede bir yeniden dener
• Nihai fiyat bekleyişi uzun sürerse üretim uyarı sistemi tetiklenir

Oracle'ın erişilebilirliğinden bağımsız olarak, işlem vade sonunda derhal engellenir.

Nihai Fiyat Gecikmesi

Nihai TWAP gecikirse:

• Uzlaşma gecikir
• Sistem, nihai oracle uzlaşma fiyatını bekler
• Kullanıcılar enstrümanın Expired Pending Price durumunda kaldığını görebilir
• Nakit uzlaşma, yeniden deneme yolu nihai fiyatı uyguladıktan sonra görünür

Sistem Yeniden Başlatması

Uzlaşma durumu veritabanına kaydedilir. Sistem yeniden başlarsa:

• Vadesi dolmuş enstrümanlar başlangıçta veritabanından tespit edilir
• Uzlaşma otomatik olarak devam eder
• İdempotentlik garantileri çifte uzlaşmayı önler

Parametreler

Parametre	Değer	Açıklama
Vade sonu kontrol aralığı	60 saniye	Sistemin vade sonlarını ne sıklıkla kontrol ettiği
TWAP penceresi	30 dakika	Uzlaşma fiyatı ortalama alma penceresi
Uzlaşma yeniden deneme aralığı	30 saniye	Fiyat mevcut olmadığında yeniden deneme sıklığı
Nihai fiyat uyarı eşiği	30 dakika	Vadesi dolmuş bir enstrüman hâlâ nihai fiyat bekliyorsa uyarı
Bekleyen ödeme uyarı eşiği	1 saat	Uzlaşma ödeme kayıtları uygulanmamış kalırsa kritik uyarı

En İyi Uygulamalar

1. Vade sonlarını izleyin: Pozisyonlarınızın vade sonu tarihlerini portföy uç noktası üzerinden takip edin
2. Önceden plan yapın: Uzlaşmadan kaçınmak istiyorsanız pozisyonlarınızı vade sonundan önce kapatın
3. Uzlaşma fiyatlarını kontrol edin: Oracle fiyatının beklentilerinizle eşleştiğini doğrulayın
4. WebSocket'e abone olun: Anında bildirim için gerçek zamanlı PositionExpired olaylarını alın
5. Teminat tamponu bulundurun: Karda (ITM) sonuçlanabilecek short uzlaşmaları için yeterli teminat sağlayın

Zincir Üstü Uzlaşma

Ana ağda, uzlaşma fiyatları hesaplamanın ardından zincir üstüne kaydedilir:

• Oracle, uzlaşma TWAP'ını hesaplar ve nihai vade sonu fiyatını yayımlar.
• Exchange kontratı, kaydedilen uzlaşma fiyatını zincir üstünde doğrulayabilir.
• Canlı oracle akışları zincir üstünde yayınlanmaz. Nihai uzlaşma fiyatları, vade sonu için zincir üstü referanstır.

---

Ayrıca bakınız:

• Likidasyon: Teminat yetersizse ne olur
• Portföy Teminatı: Pozisyonlar teminatı nasıl etkiler
• Standart Teminat: Pozisyon bazında teminat hesaplaması