Skip to content

v0.11.0 — TEFAS varlık dağılımı JSON üzerinden

Latest

Choose a tag to compare

@saidsurucu saidsurucu released this 07 Aug 16:57

TEFAS allocation artık tarayıcısız

0.9.0'dan beri Fund.allocation Akamai korumalı SSR sayfasını Scrapling +
patchright Chromium ile render ediyordu, allocation_history() ise "TEFAS artık
tarihsel allocation sunmuyor" gerekçesiyle deprecated'di. İkisi de aynı sonuca
dayanıyordu ve o sonuç yanlıştı.

2026-04 geçişi endpoint'i kaldırmamış, yeniden adlandırmıştı
(BindHistoryAllocation → dagilimSiraliGetirT). Akamai sadece HTML sayfalarını
koruyor; /api/funds/* çerezsiz, tarayıcısız, düz bir httpx POST'una cevap
veriyor — ve tarih aralığı kabul ediyor.

Değişiklikler

  • get_allocation() JSON endpoint'ini kullanıyor. Scrapling yok, Chromium yok;
    start/end/fund_type artık gerçekten dikkate alınıyor.
  • allocation_history() deprecated değil, implemente edildi.
  • [allocation] extra'sı boşaltıldı — mevcut kurulum komutları çalışmaya devam eder.
  • Dönen DataFrame'e code kolonu eklendi.
  • _post_json_v2: HTTP 429 backoff + errors_as_empty (tüm TEFAS v2 çağrılarına fayda).

Breaking

  • ASSET_TYPE_MAPPING kaldırıldı. Emekliye ayrılan endpoint'in büyük harfli
    kısaltmalarını çözüyordu ve birkaç kodda yanlıştı: kba = Kamu Dış
    Borçlanma Araçları ("Kira Sertifikası Alım" değil), d = Diğer ("Döviz"
    değil), vdm = Varlığa Dayalı Menkul Kıymetler ("Vadeli Mevduat" değil),
    tpp = Takasbank Para Piyasası ("Ters Repo Para Piyasası" değil).
    Yerine ASSET_TYPE_LABELS geldi: 34 etiket, TEFAS'ın kendi sayfalarındaki
    ağırlıklarla ~330 fon üzerinden eşleştirilerek doğrulandı.
  • Doğrulanamayan 7 nadir kodda asset_type/asset_name artık None — tahmin
    üretilmiyor. Doğru sayının üstündeki yanlış etiket downstream'de tespit edilemez.

Bilinmesi gerekenler

  • Ağırlıklar negatif olabilir (ABG: Hisse Senedi %114.14, Repo %-14.14).
  • Sorgu başına en fazla 1 ay; geniş aralıklar otomatik parçalanır.
  • TEFAS ~4 istekten sonra HTTP 429 döner ve blok ~45 sn sürer.