Likidasyon

Likidasyon, sistemi teminat yükümlülüklerini artık karşılayamayan hesaplara karşı korur. Bir hesabın özkaynağı sürdürme teminatı gereksiniminin altına düştüğünde Hypercall önce kısa opsiyonları kapatarak hesabı düzeltmeye çalışır. Bu zamanında işe yaramazsa hesap tam likidasyona geçer.

Tetiklenme Koşulları

Likidasyon, bir hesap su altına düştüğünde (underwater) tetiklenir:

Portföy Teminatı:

$$\text{Özkaynak} < \text{Gerekli Sürdürme Teminatı}$$

Standart Teminat:

$$\text{Nakit} < \text{Gerekli MM}$$

SM likidasyonunu özkaynak değil, nakit sürdürme marjı (cash - mm_required) belirler; bu nedenle NAV'ı yükselten long opsiyon değerlemeleri nakit açığını engellemez. maintenance_margin = equity - mm_required API alanı hâlâ raporlanır ancak SM likidasyon tetikleyicisi değildir. Bkz. Standart Teminat.

Portföy teminatlı bir hesapta özkaynak, PM borç verme havuzuna borçlu olunan tutarlar düşülerek hesaplanır ve sürdürme gereksinimi, Hyperliquid'in HyperCore üzerindeki perp pozisyonlarınızı kendi kurallarıyla likide etmesini de hesaba katar. Hyperliquid bu perp pozisyonlarını Hypercall'dan bağımsız olarak kendi kuralları çerçevesinde yine de likide edebilir. Bkz. Portföy Teminatı.

Hypercall, pozisyonu olan her hesabın sağlığını 5 saniyede bir kontrol eder.

Durumlar

Durum	Ne oluyor	Emirler
Healthy	PM: özkaynak gerekli MM'nin üzerinde veya ona eşit. SM: nakit gerekli MM'nin üzerinde veya ona eşit.	Tüm emirlere izin verilir
PreLiquidation	Kısmi likidasyon: Hypercall, hesabın kısa opsiyonları için kapatma emirleri verir	Yalnızca mevcut bir pozisyonu azaltan emirler
InLiquidation	Tam likidasyon. Standart teminat: hesabın portföyü bir likidatöre sunulur	Yalnızca mevcut bir pozisyonu azaltan emirler
Liquidated	Bir likidatör hesabın portföyünü devraldı	Yalnızca mevcut bir pozisyonu azaltan emirler

PreLiquidation ve InLiquidation durumlarında çekimler ve PM nakit süpürmeleri devre dışıdır. Bir PM hesabı tam likidasyon için boşaltılmaya başlandığında tüm emirleri engellenir.

Durum Geçişleri

1. Healthy'den PreLiquidation'a: hesap MM eşiğinin altına düşer.
2. PreLiquidation'dan Healthy'ye: hesap tampon eklenmiş hedefe, yani gerekli MM × 1,05'e ulaşır ve likidasyon emirlerinin hiçbiri açık kalmaz. Sınır dahildir.
3. PreLiquidation'dan InLiquidation'a: hesap hâlâ hedefin altındadır ve aşağıdaki geçiş koşullarından biri gerçekleşir.
4. InLiquidation'dan Healthy'ye: hesap bir likidatör devralmadan önce toparlanır ve tam likidasyon durdurulur.
5. InLiquidation'dan Liquidated'a: bir likidatör hesabı devralır.

Kısmi Likidasyon

Bir hesap PreLiquidation durumuna girdiğinde:

1. Risk ekleyecek emirler anında reddedilir. Mevcut bir pozisyonu azaltan emirler kabul edilmeye devam eder.
2. Hypercall, risk ekleyen açık emirlerinizi iptal eder ve kısa opsiyonlarınız için yalnızca azaltmaya yönelik (reduce-only) alış emirleri verir; bu emirler hesabı gerekli MM × 1,05 seviyesine geri getirecek büyüklüktedir. Kontrat başına en fazla teminatı serbest bırakan kısa pozisyonlar önce kapatılır.
3. Her emir, en iyi satış fiyatı (satış yoksa orta fiyat ya da alış fiyatı) artı bir likidasyon bonusu ile fiyatlanır. Bonus %0,5 ile başlar ve 5 dakika içinde doğrusal olarak %10'a yükselir. Emirler 5 saniyede bir yeniden fiyatlanır.
4. Hesap hedefe yeniden ulaştığı ya da onu aştığı ve likidasyon emirleri ortadan kalktığı anda Healthy durumuna döner.

Bonus sizin için bir maliyettir: kısa pozisyonlarınızın hızla kapatılması için piyasanın üzerinde ödediğiniz tutardır.

Bu süreyi hesabı kendiniz düzeltmek için kullanın:

• Teminat yatırın
• Pozisyonları, özellikle kısa opsiyonları kapatın
• Risk ekleyen emirleri iptal edin

Tam Likidasyona Geçiş

PreLiquidation durumunda olup hâlâ hedefin altında kalan bir hesap, aşağıdakilerden herhangi biri gerçekleştiğinde tam likidasyona geçer:

• Özkaynak negatiftir.
• Kısmi likidasyonun kapatabileceği kısa opsiyon kalmamıştır.
• Geçiş süresi dolmuştur. Süre, hesabın PreLiquidation durumuna girmesinden 20 dakika sonradır.

20 dakikalık süre, kısa süreli hatalı bir değerlemenin bir hesabı doğrudan tam likidasyona itmemesini de sağlar.

Tam Likidasyon

Standart teminatlı bir hesapta tam likidasyon, hesabın portföyünü Hypercall motoru içindeki bir likidatöre devreder. Hypercall önce hesabın tüm açık emirlerini iptal eder, ardından hesabı sunar.

• Likidatör hesabı gerekli MM × 1,05 seviyesine geri getirmek zorundadır; bu nedenle hesabın eksik teminatını o karşılar.
• Hesabın hâlâ pozitif özkaynağı varsa likidatör bu özkaynağı size öder.
• Likidatör tüm pozisyonları ve hesabın nakdini alır.

Hesap bir likidatör devralmadan önce toparlanırsa tam likidasyon durdurulur ve hesap Healthy durumuna döner.

Portföy teminatlı bir hesap için planlamanız gereken adım yukarıdaki kısmi likidasyondur. Bir PM hesabı tam likidasyona geçtiğinde açık emirleri iptal edilir ve işlem süresince emirleri engellenir; bu adımın geri kalanı kesinleştiğinde bu sayfada açıklanacaktır.

Özkaynağı Aşan Zararlar

Bir hesabın özkaynağını aşan zarar, hiçbir zaman diğer trader'ların pozisyonları kapatılarak karşılanmaz; Hypercall'da otomatik kaldıraç azaltma (auto-deleveraging) yoktur. Zararı kimin üstleneceği teminat moduna bağlıdır.

Standart teminat. Likidatör, hesabın pozisyonlarını ve nakdini açığı dahil olduğu gibi devralır. Negatif özkaynaktan doğan açık likidatörde kalır.

Portföy teminatı. Hesabın likidasyondan sonra hâlâ borçlu olduğu tutar (havuz kredileri ve ödenmemiş uzlaşma) sabit bir şelaleden geçer:

1. Borçlunun teminatı. Hypercall, hesabın HyperCore teminatından tahsilat yapar. Bkz. geri tahsilat. Bir kredi ancak tahsilat imkânları tükendikten sonra zarar olarak yazılır.
2. İlk zarar rezervi. Önce borçlunun hâlâ uzlaşma borcu olduğu hesaplara, en eski partiden başlayarak ödeme yapar, ardından zarar yazılan krediyi karşılar.
3. Havuzdaki borç verenler. Rezervin karşılayamadığı kısım havuzun pay fiyatını düşürür.

Borç silinmez. Borçludan daha sonra tahsil edilen tutar önce hâlâ alacaklı olan settlement karşı taraflarına, en eski partiden başlayarak ödenir, ardından açık havuz kredisine gider; yalnızca kalan kısım, her birinin kaybıyla orantılı olarak rezerve ve borç verenlere döner. İlk zarar rezervi yalnızca PM kredilerini karşılar; platform genelinde bir sigorta fonu yoktur.

API Uç Noktaları

Likidasyon Durumunu Alma

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

Hiç Healthy durumundan çıkmamış bir hesap için data değeri null olur.

Yanıt:

{
  "success": true,
  "data": {
    "wallet": "0x...",
    "state": "pre_liquidation",
    "liquidation_mode": "partial",
    "margin_mode": "portfolio",
    "equity": "4500.00",
    "mm_required": "5000.00",
    "maintenance_margin": "-500.00",
    "shortfall": "500.00",
    "partial_liquidation": {
      "entered_at": 1737312000000,
      "target_equity": "5250.00",
      "mm_shortfall": "500.00",
      "escalation_deadline": 1737313200000,
      "bonus_bps": 50
    },
    "full_liquidation": null
  }
}

partial_liquidation ayrıca açık likidasyon emri kimliklerini de listeler. full_liquidation, margin_needed, winner ve güncel gerekli teklif dahil devralma ayrıntılarını içerir.

Likidasyon Geçmişini Alma

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

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

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

GET /liquidations?limit=50

Cüzdanlar genelindeki likidasyon geçişi geçmişini en yeniden eskiye doğru döndürür. Uç nokta herkese açıktır ve likidatör botları ile izleme araçları için imleç tabanlı sayfalama kullanır.

Sorgu parametreleri

• cursor: Önceki sayfanın döndürdüğü opak imleç.
• limit: Sayfa boyutu; varsayılan 50, en fazla 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'dır.
• margin_mode: İsteğe bağlı teminat modu filtresi. Kabul edilen değerler standard ve portfolio'dur.
• liquidation_mode: İsteğe bağlı likidasyon modu filtresi. Kabul edilen değerler partial ve full'dür.

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

Açık Artırma Ayrıntılarını Alma

GET /liquidation/auction/{auction_id}

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

WebSocket Bildirimleri

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

{
  "type": "LiquidationStateChange",
  "wallet_address": "0x...",
  "previous_state": "healthy",
  "new_state": "pre_liquidation",
  "liquidation_mode": "partial",
  "margin_mode": "portfolio",
  "equity": "4500.00",
  "mm_required": "5000.00",
  "maintenance_margin": "-500.00",
  "shortfall": "500.00",
  "partial_liquidation": { "escalation_deadline": 1737313200000, "bonus_bps": 50 },
  "full_liquidation": null,
  "timestamp": 1737312000000
}

partial_liquidation ve full_liquidation, durum uç noktasıyla aynı alanları taşır. Cüzdanınız için gerçek zamanlı güncellemeler almak üzere abone olun.

Parametreler

Parametre	Değer	Açıklama
Sağlık kontrolü aralığı	5 saniye	Hesap sağlığının ne sıklıkla kontrol edildiği
Toparlanma hedefi	Gerekli MM × 1,05	Healthy durumuna dönmek için gereken özkaynak (PM) veya nakit (SM) ve tam likidasyonun geri getirdiği seviye
Asgari açık	0	Herhangi bir açık kısmi likidasyonu başlatır
Likidasyon bonusu	5 dakika içinde %0,5'ten %10'a yükselir	Kısmi likidasyon emirlerinde referans fiyatın üzerine eklenen prim
Yeniden fiyatlama aralığı	5 saniye	Kısmi likidasyon emirlerinin ne sıklıkla yeniden fiyatlandığı
Geçiş süresi	20 dakika	Tam likidasyon başlamadan önce PreLiquidation durumunda geçen süre

En İyi Uygulamalar

Trader'lar İçin

1. Teminat oranını izleyin: Özkaynağı MM'nin belirgin şekilde üzerinde tutun (2 kat tampon önerilir)
2. Uyarılar kurun: Ön likidasyonu erken tespit etmek için WebSocket kullanın
3. Yedek sermaye hazır tutun: Yatırmaya hazır yedek teminat bulundurun
4. Kısa pozisyonları kendiniz kapatın: Kendi verdiğiniz emirlerde likidasyon bonusu ödemezsiniz

Sağlık Sorgulama

Teminat durumunuzu düzenli olarak kontrol edin:

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

# Look for:
# - span_margin.equity vs span_margin.maintenance_margin_required (portfolio)
# - margin_summary.standard_margin.maintenance_margin_headroom (standard)

---

Ayrıca bkz.:

• 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ı
• PM Finansmanı: PM borcunun nasıl tahsil edildiği
• PM Risk Parametreleri: MM oranı ve yürürlükteki diğer tüm PM ayarları
• PM Riskini Simüle Etme: varsayımsal bir portföyde MM marjını kontrol edin