Likidasyon

Likidasyon, sistemi teminat yükümlülüklerini artık karşılayamayan hesaplardan korur. Bir hesabın özkaynağı sürdürme teminatı gereksiniminin altına düştüğünde, likidasyon süreci pozisyonları ödeme gücü olan karşı taraflara aktarır.

Tetikleme Koşulları

Likidasyon, bir hesap batık duruma geldiğinde tetiklenir:

Portföy Teminatı:

$$\text{Equity} < \text{Maintenance Margin Required}$$

Standart Teminat:

$$\text{Maintenance Margin} < 0$$

Burada sürdürme teminatı = özkaynak - gerekli MM.

Sistem, sağlık durumunu kontrol etmek için pozisyonu olan tüm hesapları sürekli olarak sorgular.

Durum Makinesi

Hesaplar dört likidasyon durumu boyunca ilerler:

Durum	Açıklama	Emir Kısıtlamaları
Healthy	Özkaynak > gerekli MM	Yok
PreLiquidation	Özkaynak < MM, ek süre aktif	Riski artıran emirler engellenir
InLiquidation	Müzayede devam ediyor	Tüm emirler engellenir
Liquidated	Müzayede tamamlandı	Hesap temizlendi

Durum Geçişleri

1. Healthy → PreLiquidation: Hesap MM eşiğinin altına düşer
2. PreLiquidation → Healthy: Hesap MM'nin üzerine çıkarak toparlanır (kullanıcı fon ekledi veya pozisyonları kapattı)
3. PreLiquidation → InLiquidation: Ek süre toparlanma olmadan sona erer
4. InLiquidation → Liquidated: Müzayede başarıyla tamamlanır

Likidasyon Öncesi Ek Süre

Bir hesap likidasyon öncesi (pre-liquidation) durumuna girdiğinde:

1. Riski artıran emirler anında engellenir
2. Riski azaltan emirlere (pozisyon kapatma) izin verilmeye devam edilir
3. 60 saniyelik bir ek süre başlar
4. Hesap ek süre bitmeden toparlanırsa (özkaynak > MM), Healthy durumuna geri döner
5. Ek süre sonunda hâlâ batık durumdaysa, likidasyon müzayedesi başlar

Ek süre kullanıcılara şunlar için zaman tanır:

• Ek teminat yatırma
• Teminat gereksinimini azaltmak için pozisyon kapatma
• Ani piyasa hareketlerine tepki verme

Likidasyon Müzayedesi

Ek süre sona erdiğinde bir Hollanda müzayedesi başlar:

Ödeme Gücü Olan Müzayede (Özkaynak > 0)

Başlangıç fiyatı = özkaynak × (1 - ceza), zaman içinde azalır.

Likidatörler, hesabın pozisyonlarını devralmak için şunlar karşılığında teklif verir:

• Hesap özkaynağı (ceza düşülmüş olarak)
• Tüm pozisyonların sorumluluğu

Ceza, likidatörlerin katılımı için teşvik yaratır.

Ödeme Gücü Olmayan Müzayede (Özkaynak < 0)

Hesap ödeme gücünü yitirmişse (özkaynak negatif), sigorta fonu batık pozisyonları üstlenmeleri için likidatörlere bonus sağlar.

Pozisyon Transferi

Bir likidasyon tamamlandığında:

1. Tüm pozisyonlar likide edilen hesaptan likidatöre aktarılır
2. Likidatör uzlaşma değerini alır (ödeme gücü olan durumda) veya öder (ödeme gücü olmayan durumda bonus alır)
3. Teminat kökü (margin root) zincir üzerinde güncellenir
4. Hesap durumu Liquidated durumuna geçer

Kısmi vs Tam Likidasyon

Tür	Koşul	Davranış
Kısmi	≤ 5 pozisyon	MM yeniden sağlanana kadar belirli pozisyonlar likide edilir
Tam	> 5 pozisyon	Hesabın tamamı likide edilir

Kısmi likidasyon deterministiktir:

• Pozisyonlar tutarlı bir algoritmayla sıralanır (rastgele değildir)
• Likidatör pozisyonları tanımlı sırayla alır
• Hesap sağlıklı duruma dönünce süreç durur

Ödeme Aczi Şelalesi

Likidasyon tam değeri geri kazanamadığında, kayıplar sırasıyla şu şekilde emilir:

1. Hesap Özkaynağı: Likide edilen kullanıcı, özkaynağı kadar zararı üstlenir
2. Sigorta Fonu: Özkaynak yetersizse açığı karşılar
3. ADL (Otomatik Kaldıraç Azaltma): Sigorta fonu tükenirse, kârlı karşı tarafların kaldıracı orantılı olarak azaltılır
4. Sosyalleştirilmiş Zarar: Nihai güvenlik ağı (şu anda uygulanmamaktadır)

Sigorta Fonu

Sigorta fonu:

• Likidasyon cezalarından birikir
• Ödeme gücü olmayan likidasyonları karşılar
• İşlem ücretleri ve cezalarla yeniden doldurulur
• Minimum rezerv hedefi vardır

ADL (Otomatik Kaldıraç Azaltma)

Sigorta fonu kayıpları karşılayamazsa:

• Kârlı pozisyonlara sahip karşı taraflar seçilir
• Pozisyonlar mark fiyatından zorla kapatılır
• Seçimde en yüksek kâr ve kaldıraç önceliklendirilir
• Etkilenen kullanıcılara bildirim gönderilir

API Uç Noktaları

Likidasyon Durumunu Alma

GET /liquidation/status?wallet=0x...

Yanıt:

{
  "success": true,
  "data": {
    "wallet": "0x...",
    "state": "pre_liquidation",
    "margin_mode": "portfolio",
    "equity": "4500.00",
    "mm_required": "5000.00",
    "maintenance_margin": "-500.00",
    "entered_pre_liq_at": 1737312000000,
    "mm_shortfall": "500.00",
    "auction_id": null
  }
}

Likidasyon Geçmişini Alma

GET /liquidation/history?wallet=0x...&limit=20

Bir hesabın durum geçiş geçmişini döndürür.

Herkese Açık Likidasyon Geçmişini Alma

GET /liquidations?limit=50

Tüm cüzdanlardaki likidasyon geçiş geçmişini en yeniden başlayarak döndürür. Bu uç nokta herkese açıktır ve likidatör botları ile izleme araçları için imleç (cursor) sayfalaması kullanır.

Sorgu parametreleri

• cursor: Önceki sayfa tarafından döndürülen opak imleç.
• limit: Sayfa boyutu, varsayılan 50, maksimum 100.
• wallet: İsteğe bağlı cüzdan filtresi.
• status veya state: İsteğe bağlı likidasyon geçiş durumu filtresi. Kabul edilen değerler: healthy, pre_liquidation, in_liquidation ve liquidated.
• margin_mode: İsteğe bağlı teminat modu filtresi. Kabul edilen değerler: standard ve portfolio.
• liquidation_mode: İsteğe bağlı likidasyon modu filtresi. Kabul edilen değerler: partial ve full.

Yanıt: Likidasyon geçiş kayıtlarını ve bir sonraki istek için page.next_cursor değerini içeren PublicLiquidationsResponse.

Müzayede Ayrıntılarını Alma

GET /liquidation/auction/{auction_id}

Müzayede durumunu, pozisyonları ve uzlaşma ayrıntılarını döndürür.

WebSocket Bildirimleri

Likidasyon durum değişiklikleri liquidation kanalında yayınlanır:

{
  "type": "LiquidationStateChange",
  "wallet": "0x...",
  "previous_state": "healthy",
  "new_state": "pre_liquidation",
  "equity": "4500.00",
  "mm_required": "5000.00",
  "shortfall": "500.00",
  "auction_id": null,
  "timestamp": 1737312000000
}

Cüzdanınız için gerçek zamanlı güncellemeler almak üzere abone olun.

Parametreler

Parametre	Değer	Açıklama
poll_interval	5 saniye	Sağlık kontrolü sıklığı
grace_period	60 saniye	Müzayede başlamadan önceki süre
min_shortfall_threshold	0	Likidasyon öncesi durumu tetiklemek için minimum açık
partial_liquidation_threshold	5 pozisyon	Bunun altında kısmi likidasyon kullanılır

En İyi Uygulamalar

Yatırımcılar İçin

1. Teminat oranını izleyin: Özkaynağı MM'nin oldukça üzerinde tutun (2x tampon önerilir)
2. Uyarılar ayarlayın: Likidasyon öncesi durumunu erken tespit etmek için WebSocket kullanın
3. Hazır sermaye bulundurun: Yatırmak üzere yedek teminatı hazır tutun
4. Zarar durdur (stop-loss) kullanın: Likidasyondan önce pozisyon azaltmayı otomatikleştirin

Sağlık Durumunu Sorgulama

Teminat durumunuzu düzenli olarak kontrol edin:

# Portfolio margin
curl "https://api.hypercall.xyz/portfolio?wallet=0x..."

# Look for:
# - equity vs maintenance_margin_required
# - margin_ratio (equity / IM)

Ek Süre İçinde Toparlanma

Likidasyon öncesi duruma girerseniz:

1. Fonlama akışı üzerinden teminat yatırın
2. Teminat gereksinimini azaltmak için pozisyonları kapatın
3. Riski artıran açık emirleri iptal edin

Riski azaltan işlemlere, likidasyon öncesi durumda dahi her zaman izin verilir.

Zincir Üzeri vs Zincir Dışı

Bileşen	Konum	Notlar
Sağlık izleme	Zincir dışı	5 saniyelik sorgulama
Durum geçişleri	Zincir dışı	Kaydedilir ve saklanır
Ek süre zamanlayıcısı	Zincir dışı	Yapılandırılabilir
Müzayede yürütme	Zincir üzeri	Controller kontratında pozisyon transferi
Uzlaşma	Zincir üzeri	Değer transferi ve teminat kökü güncellemesi

Zincir dışı motor tespit ve orkestrasyonu yürütür; zincir üzeri yürütme uzlaşma kesinliğini sağlar.

---

Ayrıca bakınız:

• Portföy Teminatı: Portföy hesapları için MM hesaplaması
• Standart Teminat: Standart hesaplar için MM hesaplaması
• Teminat Tabanı: Likidasyon eşiğini etkileyen güvenlik tabanları