PM Riskini Simüle Etme

Portföy Teminatı sayfasında açıklanan her sayıyı hesabınız için geri okuyabilir ve her işlemi göndermeden önce önizleyebilirsiniz. Simülatör ayrı bir model değildir: emirlerinizi kontrol eden ve likidasyon izleyicisini çalıştıran aynı teminat kodunu, aynı politika ve aynı motor anlık görüntüsü üzerinde çalıştırır.

Uygulamada

Portföy teminatı sayfası (/risk/span), bir PM hesabı için şunları gösterir:

özsermaye, IM, MM, alım gücü ve sürdürme tamponu
tarama riski, opsiyon tabanı ve gama ek yükü ayrı ayrı
her dayanak varlık için senaryo ızgarası; her senaryonun ve her bacağın K/Z değeriyle birlikte
Pozisyonları simüle et: portföyünüze varsayımsal bacaklar ekleyin ya da portföyünüzü bunlarla değiştirin, ardından mevcut IM ve MM değerlerini simüle edilenlerle karşılaştırın. Bir simülasyon hiçbir zaman emir vermez veya hesap durumunu değiştirmez.

Sayfa her 5 saniyede bir yenilenir.

Uç noktalar

Uç nokta	Neyi yanıtlar	Kimlik doğrulama
`GET /portfolio?wallet=`	Mevcut özsermaye, IM, MM ve pozisyonlar	Yok
`GET /risk/grid?wallet=`	Mevcut tarama riski, taban, ek yük ve dayanak varlık bazında senaryo matrisi	Yok
`POST /risk/simulate/portfolio`	Pozisyonlarınız farklı olsaydı IM ve MM	Yok
`POST /risk/simulate/orders`	Bir emrin veya paketin teminat kontrolünden geçip geçmeyeceği ve IM maliyeti	Yok
`GET /liquidation/status?wallet=`	Likidasyon durumu ve açık	Yok

Hepsi wallet olarak yönetici cüzdanınızı alır; Hypercall bunu PM hesabınıza çözümler. GET /risk/grid yalnızca PM hesapları için yanıt verir.

Risk ızgarası

GET /risk/grid, hesabın mevcut gereksinimini ve her dayanak varlık için o dayanak varlığın puanlandığı senaryoları (ek senaryolar dahil kendi ızgarası) şu bilgilerle döndürür:

scenarios[]: id, spot_shock_pct, vol_shock_pct, pnl_weight, is_tail ve dayanak varlığın o senaryodaki total_pnl değeri
extended_risk_matrix.instruments[]: scenarios ile hizalı, bacak bazında scenario_pnls

En üst düzeydeki scanning_risk, tahsil edilen sayıdır: her dayanak varlığın en kötü ağırlıklı kaybının toplamı. Matristeki worst_scenario_index, tek bir dayanak varlığın ızgarası için bir tanılama değeridir ve dayanak varlıklar genelinde teminatı belirlemez.

Portföy simülasyonu

curl -X POST https://api.hypercall.xyz/risk/simulate/portfolio \
  -H 'Content-Type: application/json' \
  -d '{
    "wallet": "0xYourManagerWallet",
    "add_positions": true,
    "positions": [
      {"symbol": "BTC-20261231-100000-C", "quantity": "-1"},
      {"symbol": "BTC-20261231-110000-C", "quantity": "1"},
      {"symbol": "BTC-PERP", "quantity": "0.25"}
    ]
  }'

add_positions: true (varsayılan), her işaretli miktarı mevcut pozisyonunuza ekler. false, portföyünüzü tam olarak bu listeyle değiştirir.
Her biri bir kez listelenmek üzere en fazla 50 sembol. Hem opsiyon hem de perp sembolleri kabul edilir.
Pozisyonlar mevcut işaret fiyatlarıyla değerlenir. Prim tahsil edilmez ve emir defterine başvurulmaz.

Yanıt current, simulated ve delta alanlarını içerir. Her özette şunları okuyun:

Alan	Anlamı
`equity`	Metodoloji sayfasında tanımlandığı şekliyle özsermaye
`position_initial_margin`	Pozisyonlar üzerindeki IM: max(tarama riski, taban) + ek yük
`position_maintenance_margin`	MM, 0.85 × pozisyon IM'si
`open_orders_initial_margin`	Canlı bekleyen emirleriniz için ayrılan tutar
`total_initial_margin`	Pozisyon IM'si artı açık emir IM'si
`initial_margin_available`	Özsermaye eksi toplam IM. Negatif değer, yeni riskin reddedileceği anlamına gelir
`maintenance_margin_available`	Özsermaye eksi MM. Negatif değer likidasyon anlamına gelir
`scanning_risk`, `option_floor`, `gamma_overlay`	Üç bileşen
`underlyings[]`	`GET /risk/grid` içindeki gibi dayanak varlık bazında senaryo matrisi
`venue_liquidation`	Hyperliquid perp pozisyonlarınız olduğunda bulunur: her Hyperliquid bölmesinin ızgaradan sağ çıkıp çıkmadığı (`hedge_survives`), kaybedilecek teminat ve platformu dikkate alan IM ve MM

metadata, simülasyonun çalıştığı motor anlık görüntüsünü tanımlar (l2_seq, evaluated_at_ms).

Emir simülasyonu

POST /risk/simulate/orders, hiçbir şey göndermeden emir kabulünün finansal kısmını çalıştırır:

execution_mode: "resting" tam olarak bir emir alır ve onu bekleyen emir olarak ücretlendirir.
execution_mode: "atomic" bacakları birlikte gerçekleşen bir paket olarak değerlendirir; bir kombinin teminatlandırıldığı şekilde.
hypothetical_open_orders, henüz vermediğiniz bekleyen emirleri eklemenize olanak tanır; bunlar orders öncesinde değerlendirilir.

Yanıta admissible eklenir ve bu değer false olduğunda bir rejection_reason döner. delta bloğu, emrin tüketeceği IM'yi gösterir. İstek örnekleri Kimlik Doğrulama sayfasındadır.

Emir simülatörü yalnızca teminat sorusunu yanıtlar. Eşleştirme, fiyat bantları, RPI, nonce'lar, hız sınırları ve işlem durdurmaları simüle edilmez; ayrıca gerçek emri göndermeden önce motor durumu değişebilir.

Hatalar

Durum	`error`	Anlamı
`400`	`invalid_simulation`	Hatalı biçimlendirilmiş istek, bilinmeyen veya vadesi dolmuş sembol, yinelenen sembol ya da 50'den fazla öğe
`429`	`risk_simulation_saturated`	Simülasyon kapasitesi paylaşımlı ve sınırlıdır; geri çekilme (backoff) ile yeniden deneyin
`503`	`risk_inputs_unavailable`	Bir girdi eksik veya güncel değil; örneğin bir opsiyon için IV işareti yok ya da HyperCore anlık görüntüsü eskimiş. Gerçek emir de aynı nedenle reddedilir

Simülasyonlara ilişkin hız sınırları Hız Sınırları sayfasında listelenmiştir.

Uygulamada​

Uç noktalar​

Risk ızgarası​

Portföy simülasyonu​

Emir simülasyonu​

Hatalar​

İlgili​