Emin API ile Tüm Fon Getirilerini Tek Formülle Kıyaslayın

Yatırımcıların karar alma süreçlerinde geçmiş performans analizi önemli bir yer tutuyor. Trendi takip etmek isteyen ya da belli periyotlarda benzer fonların performanslarını kıyaslamak isteyen yatırımcılar için 1 ay, 3 ay, 6 ay, yılbaşından itibaren, 1 yıl, 3 yıl ve 5 yıllık fon performanslarını tek bir e-tabloda kıyaslayabilmenin oldukça faydalı olabileceğini düşündüm.

Emin API Nedir?

Belki fark etmişsinizdir, 13 Nisan 2026’dan itibaren TEFAS üzerinden IMPORTXML formülü ile e-tablolara veri çekmek imkansız hale geldi. Bu sebeple, kendi sunucum üzerinde çalışan; TEFAS’la doğrudan muhatap olarak fon fiyat bilgilerini kazıyan ve son kullanıcıya ileten bir API oluşturmaya başladım.

Emin API ile fon fiyatlarını çekmek için: Excel ile TEFAS Fon Fiyatı Çekmek (Güncellendi)

Yakın zamanda ise, TEFAS’taki tüm fonların geçmiş performanslarını karşılaştırabilecek bir API uç noktası oluşturdum ve bu yazıda sizlerle paylaşmak istedim.

E-Tablolar’da TEFAS Tüm Fon Getiriler

Aşağıda, e-posta ve isminizle kayıt oluşturarak tamamen size özel üretilmiş kod ile tüm fon geçmiş performanslarını tek formül ile E-Tablonuza aktarabilirsiniz.

Emin API ile Neleri Kıyaslayabilirsiniz?

Yeni oluşturduğum uç nokta sayesinde, piyasadaki tüm fonların aşağıdaki verilerine anlık olarak erişebileceksiniz:

• Zaman Bazlı Getiriler: 1 Ay, 3 Ay, 6 Ay, Yılbaşı (YBG), 1 Yıl, 3 Yıl ve 5 Yıl.
• Risk Analizi: Fonların risk değerleri (1-7 arası).
• Sektörel Kıyaslama: Fon türlerine göre gruplandırma ve filtreleme imkanı.

Adım Adım Kurulum Rehberi

Aşağıdaki adımları takip ederek e-tablonuzu profesyonel bir fon analiz terminaline dönüştürebilirsiniz.

1. Özel Kodunuza Erişin

Aşağıdaki alana adınızı ve e-postanızı girerek size özel tanımlanmış API anahtarını içeren kod bloğuna ulaşın.

/**
 * Emin API üzerinde TEFAS tüm fon getirilerini getirir
 * @return tüm fonlar, zaman bazlı getirileri ve risk değerleri
 * @customfunction
 */
function EMIN_API_TUM_GETIRILER() {
  const cache = CacheService.getScriptCache();
  const cacheKey = "tefas_data_full";
  
  const apiKey = "ABONE_API_ANAHTARI";

  // 1. Önbellekten parçalı veriyi çekmeyi dene
  let fullData = "";
  let chunkCount = cache.get(cacheKey + "_chunks");
  
  if (chunkCount) {
    for (let i = 0; i < chunkCount; i++) {
      fullData += cache.get(cacheKey + "_" + i) || "";
    }
  }

  if (fullData) {
    return parseAndTableize(fullData);
  }

  // 2. Önbellekte yoksa API'den çek
  const url = "https://api.eminarslantas.com/tefas/tumgetiriler/?api_key=" + apiKey;
  try {
    const response = UrlFetchApp.fetch(url, { "muteHttpExceptions": true });
    if (response.getResponseCode() !== 200) return "API Hatası: " + JSON.parse(response.getContentText()).message;
    
    const jsonString = response.getContentText();
    
    // 3. Veriyi 100KB'lık parçalara bölerek önbelleğe kaydet
    const chunkSize = 90000; // 90KB
    const chunks = [];
    for (let i = 0; i < jsonString.length; i += chunkSize) {
      chunks.push(jsonString.substring(i, i + chunkSize));
    }
    
    chunks.forEach((chunk, index) => {
      cache.put(cacheKey + "_" + index, chunk, 21600);
    });
    cache.put(cacheKey + "_chunks", chunks.length.toString(), 21600);

    return parseAndTableize(jsonString);
    
  } catch (e) {
    return "Bağlantı Hatası: " + e.toString();
  }
}

function parseAndTableize(jsonString) {
  try {
    const data = JSON.parse(jsonString);
    const headers = ["Kod", "Fon Adı", "Tür", "1 Ay (%)", "3 Ay (%)", "6 Ay (%)", "1 Yıl (%)", "Yıl Başı (%)", "3 Yıl (%)", "5 Yıl (%)", "Risk Değeri"];
    const result = [headers];

    data.funds.forEach(fund => {
      result.push([
        fund.kod || "", fund.ad || "", fund.tur || "",
        formatReturn(fund.getiri_1a), formatReturn(fund.getiri_3a), formatReturn(fund.getiri_6a),
        formatReturn(fund.getiri_1y), formatReturn(fund.getiri_yb), formatReturn(fund.getiri_3y),
        formatReturn(fund.getiri_5y), fund.risk || "-"
      ]);
    });
    return result;
  } catch (e) { return "Veri İşleme Hatası: " + e.toString(); }
}

function formatReturn(value) {
  if (value === null || value === undefined || value === "") return "";
  return Number(value) / 100;
}

2. Apps Script Entegrasyonu

Kopyaladığınız kodu e-tablonuzda şu yola yapıştırın: Uzantılar > Apps Komut Dosyası (Açılan pencereye kodu yapıştırıp “Kaydet” ikonuna tıklamanız yeterlidir.)

3. Formülü Çalıştırın

Tablonuzun A1 hücresine (veya boş bir alanın en sol üstüne) şu formülü yazın:

=EMIN_API_TUM_GETIRILER()

Bu işlemden sonra saniyeler içinde TEFAS’taki tüm fonlar ve getirileri başlıklarıyla birlikte tablonuza dökülecektir.

Sonuç

Finansal özgürlüğü “zorunda olmama gücü” olarak tanımlayan bir yatırımcı için zaman, paradan daha değerli bir emtiadır. Veriyi manuel olarak toplamakla uğraşmak yerine, veriyi analiz ederek strateji geliştirmek sizi gerçek bağımsızlığa bir adım daha yaklaştırır.

Emin API, sadece bir kod parçası değil; yatırım süreçlerinizde kaosu engelleyen, disiplinli ve yapısal bir analiz sisteminin ilk adımıdır. Kendi sisteminizi kurun, otoritenizi oluşturun ve kararlarınızı rakamların gücüne dayandırın.

Siz de bu sistemi kullanırken karşılaştığınız deneyimleri veya eklenmesini istediğiniz özellikleri benimle paylaşabilir, inşa etmeye çalıştığım bu sistemin gelişmesine katkıda bulunabilirsiniz.