Emin API ile Fon Risk Analizi: Gelişmiş Rasyo Rehberi

Yatırım dünyasında en çok düşülen tuzaklardan biri, sadece nominal getiriye (panoda görünen o büyük yeşil yüzdeye) odaklanmaktır. Örneğin, bir fonun son bir yılda %110 kazandırdığını görmek harika hissettirebilir. Ancak risksiz faiz oranının %50’ye yakın seyrettiği bir makro ekonomik iklimde, bu %110’luk getirinin arkasında nasıl bir risk mimarisi yatıyor? Fon yönetimi bu getiriyi elde etmek için portföyü ne kadar hırpaladı? Düşüş dönemlerinde yatırımcısını ne kadar koruyabildi?

Bu soruların cevabı, sadece fiyata değil, sistematik bir fon risk analizi yaparak risk ayarlı getiriye (risk-adjusted return) bakmaktan geçer.

Finansal kararlarımızı rasyonel ve sistematik bir zemine oturtmak amacıyla geliştirdiğim Emin API’ye tam da bu ihtiyacı karşılayacak gelişmiş bir analiz özelliği ekledim. Yeni güncelleme ile Emin API, herhangi bir yatırım fonunun son bir yıldaki (252 iş günü) tüm fiyat geçmişini geriye dönük inceleyerek Sharpe, Sortino, Calmar ve Maksimum Düşüş (Max Drawdown) rasyolarını otomatik olarak hesaplayıp döndürüyor.

İlginizi çekebilecek makale: Hisse Seçerken Oran (Rasyo) Analizi Nasıl Yapılır?

Fon Analizinde Büyük Dörtlü: Hangi Rasyo Bize Ne Anlatıyor?

Emin API’nin döndürdüğü bu veriler, bir fonun sadece ne kadar kazandırdığını değil, o getiriyi hak edip etmediğini gösterir. İşte bilmeniz gereken referans aralıkları ve anlamları:

1. Sharpe Rasyosu

Fonun, risksiz faiz oranının (örneğin Para Piyasası Fonlarının) üzerinde elde ettiği fazla getirinin, üstlendiği toplam riske (volatiliteye) oranıdır. Alınan her bir birim riske karşılık ne kadar ekstra ödül aldığınızı gösterir.

• 0 – 1 Arası: Kabul edilebilir, ancak zayıf.
• 1 – 2 Arası: İyi ve başarılı bir yönetim.
• 2 ve Üzeri: Olağanüstü (Fonun aldığı riske fazlasıyla değdiğini gösterir).

2. Sortino Rasyosu

Sharpe rasyosuna çok benzer ancak önemli bir farkı vardır: Sharpe hem yukarı yönlü hem aşağı yönlü dalgalanmaları risk kabul eder. Oysa yatırımcı için yukarı yönlü dalgalanma bir risk değil, kazançtır. Sortino, yalnızca negatif (aşağı yönlü) dalgalanmaları hesaba katar.

• Yorumlama: Sortino rasyosunun Sharpe’tan belirgin şekilde yüksek olması, fonun yükselirken agresif, düşerken ise korumacı bir karaktere sahip olduğunu fısıldar.

3. Maksimum Düşüş (Max Drawdown)

Bir fonun son bir yıl içinde gördüğü en yüksek tepe noktasından, ardından gelen en dip noktaya yaşadığı en büyük kayıp oranıdır.

• Yorumlama: Portföyünüzün psikolojik dayanıklılık sınırını ölçer. Örneğin, %26’lık bir Max Drawdown, o fona yatırım yaptığınızda paranızın zirveden aşağıya %26 erimesine katlanıp katlanamayacağınızı sorgulamanızı sağlar.

4. Calmar Rasyosu

Yıllık getirinin, Maksimum Düşüşe bölünmesiyle elde edilir. Fon yönetiminin kriz yönetimindeki başarısını ve yaralarını ne kadar hızlı sarabildiğini ölçer.

• 1 – 3 Arası: Standart piyasa performansı.
• 3 ve Üzeri: Mükemmel (Düşük kırılganlıkla yüksek getiri üretildiğinin kanıtı).

Emin API ile Portföy Takibini Sistematize Etmek

Bu endpoint, piyasadaki yüzlerce fonu rastgele tarayıp brute-force (kaba kuvvet) yöntemiyle filtrelemek için tasarlanmadı. Zaten sistem mimarisini ve veri güvenliğini korumak adına uygulanan rate limit (istek sınırlaması) kuralları, bu tarz kaotik veri kazıma işlemlerine izin vermez.

Asıl Kullanım Amacı: Kendi radarınızda olan, portföyünüze eklemeyi düşündüğünüz veya halihazırda biriktirdiğiniz çekirdek fon listesinin (watchlist) risk röntgenini çekmek ve rasyonel bir fon risk analizi gerçekleştirmektir..

• Rasyonel Karar Süreci: Takip ettiğiniz iki hisse senedi fonu da yıl sonunda %100 getiri sağlamış olabilir. Ancak Emin API ile sorguladığınızda A fonunun Calmar rasyosu 4, B fonunun ise 1.5 çıkıyorsa; A fonunun o getiriye çok daha az sarsılarak ulaştığını anlar ve varlık dağılımınızı buna göre optimize edersiniz.
• Zaman Maliyeti Yönetimi: Excel başında saatlerce geçmiş fiyat verisi toplayıp, standart sapma ve aşağı yönlü risk formülleriyle uğraşmak yerine, strateji geliştirmeye zaman ayırırsınız.

Google E-Tablolar Entegrasyonu: Kendi Analiz Sistemini Kur

Emin API’nin sunduğu bu verileri tamamen otomatik hale getirmek ve kendi kişisel yatırım tablonuza entegre etmek oldukça basit. Aşağıdaki Google Apps Script kodunu E-Tablonuzun uzantılar kısmına ekleyerek, kayıt sonrası size özel tanımlanan API anahtarınızla rasyoları doğrudan hücrelerinize yazdırabilirsiniz.

/**
 * Emin API kullanarak belirtilen fon koduna ait rasyoları listeler.
 *
 * @param {string} fon_kodu İncelemek istenen fonun kodu (Örn: "GVI").
 * @return {object[][]} Başlıklar ve değerlerden oluşan yatay (2 satırlı) tablo aralığı.
 * @customfunction
 */
function EMIN_API_FON_RASYOLARI(fon_kodu) {
  if (!fon_kodu) {
    return [["Hata: Eksik parametre girdiniz."]];
  }
  var api_key = "ABONE_API_ANAHTARI";
  var ticker = fon_kodu.toString().trim().toUpperCase();
  
  // Önbellek kontrolü (Format: emin_api_rasyo_TICKER - 6 Saat)
  var cache = CacheService.getScriptCache();
  var cacheKey = "emin_api_rasyo_" + ticker;
  var cachedData = cache.get(cacheKey);
  
  var jsonResponse;
  
  if (cachedData != null) {
    jsonResponse = JSON.parse(cachedData);
  } else {
    var url = "https://api.eminarslantas.com/tefas/fon/" + ticker + "/rasyolar?api_key=" + api_key;
    
    try {
      var response = UrlFetchApp.fetch(url, { "muteHttpExceptions": true });
      var responseCode = response.getResponseCode();
      var responseText = response.getContentText();
      
      try {
        jsonResponse = JSON.parse(responseText);
      } catch (e) {
        jsonResponse = null;
      }
      
      if (responseCode !== 200 || !jsonResponse || jsonResponse.success === false || jsonResponse.status !== "success") {
        if (jsonResponse && jsonResponse.message) {
          return [["Hata: " + jsonResponse.message]];
        }
        return [["Hata: Sunucu hatası veya geçersiz yanıt (Kod: " + responseCode + ")"]];
      }
      
      // 6 saat (21600 saniye) önbelleğe alma
      cache.put(cacheKey, JSON.stringify(jsonResponse), 21600);
      
    } catch (e) {
      return [["Hata: Bağlantı kurulamadı (" + e.toString() + ")"]];
    }
  }
  
  var metrics = [
    { label: "Fon Kodu", key: "ticker" },
    { label: "Yıllık Getiri (%)", key: "annual_return" },
    { label: "Yıllık Volatilite (%)", key: "annual_volatility" },
    { label: "Sharpe Oranı", key: "sharpe_ratio" },
    { label: "Sortino Oranı", key: "sortino_ratio" },
    { label: "Calmar Oranı", key: "calmar_ratio" },
    { label: "Maksimum Düşüş (Max DD %)", key: "max_drawdown" }
  ];
  
  // Yatay çıktı mimarisi: 1. satır tamamen başlıklar, 2. satır tamamen değerler olacak.
  var rowHeaders = [];
  var rowValues = [];
  
  for (var i = 0; i < metrics.length; i++) {
    rowHeaders.push(metrics[i].label);
    
    var val = jsonResponse[metrics[i].key];
    if (val === undefined || val === null) { val = ""; }
    rowValues.push(val);
  }
  
  return [rowHeaders, rowValues];
}

Kodu Uzantılar > Apps Komut Dosyası üzerinden kodunuzun en altına ekledikten sonra, artık bir fonun rasyolarına ulaşmak aşağıdaki formülle mümkün hale gelir.

==EMIN_API_FON_RASYOLARI(FON_KODU)

FON_KODU kısmına "AFT", "GVI" vb. gibi fon kodunu elle yazabileceğiniz gibi, fon kodunun bulunduğu hücreyi (örn. A1) de referans olarak gösterebilirsiniz.

Sonuç ve Gelecek Geliştirmeler

Finansal özgürlük, sadece çok kazanmak değil; kurulan sistemlerin sürdürülebilir olması ve taşınan riskin farkında olunmasıdır. Emin API’nin bu yeni rasyo özelliği, kararlarınızı sezgilerden arındırıp tamamen matematiksel verilere dayandırmanız için yayında.

Sizden Gelenlerle Büyüyoruz: Emin API, yatırım süreçlerini kolaylaştırmak için sürekli geliştiriliyor. Bir sonraki aşamada sistemde görmeyi hayal ettiğiniz, yatırım kararlarınıza katma değer sağlayacak yeni bir rasyo veya özellik var mı? Taleplerinizi ve sistem mimarisine dair önerilerinizi sosyal medya veya doğrudan e-posta kanalları üzerinden bana her zaman iletebilirsiniz.