TR fonları

Fon yolları kanonik kimliği (fund:TLY) ya da çıplak TEFAS kodunu (TLY) kabul eder. Sağlayıcı raporlamadığında alanlar null'dır — hiçbir değer varsayılanla doldurulmaz.

Deneme Alanı'nda deneyin →

Tek çağrı fonun kimlik kartını döndürür. Ad, kurucu, kategori, ISIN, risk değeri, ücret, yatırımcı sayısı ve fon büyüklüğüne ek olarak profil şunları taşır:

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/funds/fund:TLY/profile"

{
  "instrument_id": "fund:TLY",
  "code": "TLY",
  "fund_type": "Serbest Fon",
  "product_type": "mutual_fund",
  "tefas_status": "open",
  "befas_status": null,
  "status_text": "TEFAS'ta İşlem Görüyor",
  "management_fee_source": "reported",
  "shares_outstanding": "24394721",
  "share_ceiling": "1000000000",
  "total_share_count": "1000000000",
  "occupancy_pct": "2.4395",
  "occupancy_flag": null,
  "occupancy_note": null,
  "occupancy_as_of": "2026-09-15",
  ...
}

Her fonun NAV geçmişinden günlük önceden hesaplanır: standart pencerelerde (1a/3a/6a/YBB/1y/3y/5y) noktadan-noktaya getiriler, yıllık volatilite, maksimum düşüş ve Sharpe/Sortino. Getiri/volatilite/düşüş yüzdedir; Sharpe/Sortino yapılandırılabilir bir risksiz faiz oranı kullanır ve bu oran her yanıtta risk_free_rate olarak döner, böylece varsayım açıktır. NAV toplam-getiriye sadıktır (TR fon birim fiyatları biriktiricidir — gelir fiyata yansır, ayrı dağıtım yoktur).

1w ve 9m anahtarları farklı bir kaynaktan gelir: sağlayıcının raporladığı (TEFAS ile tutarlı) değerlerdir ve tarihleri provider_returns_as_of alanındadır. Diğer anahtarlar PortGate tarafından hesaplanır ve tarihi as_of'tur. Kaynağında fona ait satır yoksa anahtar hiç gelmez; satır var ama değer yoksa null gelir.

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/funds/fund:TLY/performance"

Fon başına bir performans çağrısı yerine, tüm TR fonlarını tek çağrıda bir dönemdeki getiriye göre sıralayın.

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/funds/ranking?period=1y&type=mutual_fund&limit=20"

{
  "period": "1y",
  "order": "desc",
  "type": "mutual_fund",
  "as_of": "2026-09-15",
  "total": 1850,
  "entries": [
    {
      "rank": 1,
      "instrument_id": "fund:TLY",
      "code": "TLY",
      "name": "TERA BİRİNCİ SERBEST",
      "product_type": "mutual_fund",
      "fund_type": "Serbest Fon",
      "return_pct": "1334.88",
      "nav": "10133.51",
      "investor_count": 102462
    },
    ...
  ],
  "currency": "TRY"
}

Bir fona günlük yatırımcı para giriş ve çıkışı (nakit giriş/çıkışı) — alımlar eksi geri satımlar, getiri değil. Fiyat artışı asla akış sayılmaz.

İşlem günü başına: net_flow_try = (shares_t − shares_t−1) × price_t (TRY), ayrıca fonun günlük dolaşımdaki pay serisinden hesaplanan shares_delta ve investor_count_delta.

Şu günler suspect: true olarak işaretlenir ve özet toplamlarından çıkarılır: birim fiyatın günden güne %25'ten fazla oynadığı günler (suspect_reason: price_move — bölünme, yeniden değerleme ya da veri hatası) ve iki taraftan birinde sıfır paylı yer tutucu satır bulunan günler (zero_shares). Şüpheli satırlar yine de döner, böylece seride sessiz boşluk olmaz; özet bunları suspect_days içinde sayar.

200 yanıtlarında summary her zaman vardır: varsayılan olarak from..to döneminin toplamıdır (window: "range"). İçeriği: start_date / end_date (penceredeki ilk ve son işlem günü, veri yoksa null), trading_days (şüpheli günler dahil), şüpheli olmayan günler üzerinden net_flow_try, shares_delta ve investor_count_delta toplamları ve suspect_days.

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/funds/fund:AFA/investor-flows?from=2026-07-07&to=2026-07-10"

{
  "instrument_id": "fund:AFA",
  "currency": "TRY",
  "points": [
    {
      "date": "2026-07-07",
      "net_flow_try": "-4277961.871288",
      "shares_delta": "-3543524",
      "investor_count_delta": -35,
      "price": "1.207262",
      "shares_outstanding": "4235932017",
      "investor_count": 45038,
      "suspect": false,
      "suspect_reason": null
    },
    ...
  ],
  "summary": {
    "window": "range",
    "start_date": "2026-07-07",
    "end_date": "2026-07-10",
    "trading_days": 4,
    "net_flow_try": "-21237706.568717",
    "shares_delta": "-17570061",
    "investor_count_delta": -63,
    "suspect_days": 0
  }
}

Bilinmeyen bir fon kodu 404 değil, boş bir points listesi (ve sıfır özet) döndürür.

Fon portföyleri aylık olarak, fon fon yayımlanır (TEFAS açıklama döngüsü): fonların kabaca yarısı ayın 3'üne, ~%90'ı ise 7'sine kadar yayımlanmış olur. period değeri YYYYMM biçimindedir; belirtmediğinizde her fonun en son açıkladığı dönemi sunarız; bu dönem ayın başında fonlar arasında farklılık gösterebilir.

Fon NAV'ı data_delay_seconds: 0 taşır çünkü doğası gereği gün sonudur (canlı bir tik değil) — gerekçesi veri ve tazelik politikasında.

curl -H "X-API-Key: $PORTGATE_KEY" \
  "https://api.theportfoy.com/portgate/v1/funds/holders-of/bist:ASELS"

{
  "instrument_id": "bist:ASELS",
  "holders": [
    {"fund_code": "AFA", "period": "202608", "weight_pct": "4.25", "value": "125000000.5", "quantity": "400000"},
    {"fund_code": "TGE", "period": "202608", "weight_pct": null, "value": null, "quantity": null},
    ...
  ],
  "note": "funds whose LATEST disclosed portfolio contains the instrument"
}

Her tutan, açıklama dönemini ve pozisyonunu taşır: weight_pct (o fonun portföyündeki pay, yüzde), value (TRY) ve quantity. Pozisyon büyüklüğü henüz mevcut değilse bu üç alan null'dır.

Bir tutanın tüm portföyü için /v1/funds/{CODE}/holdings çağırın.