Yatırım tavsiyesi değildir. Tüm rakamlar TEFAS'ın halka açık verisinden üretilmiştir; kararların sorumluluğu sana aittir.
f
Fonoloji
geliştiriciler için

REST API
dokümanı

JSON yanıt, kararlı URL şeması, nazik rate limit başlıkları. AI özeti ve PNG görseller dahil — hepsi tek anahtarla. Kayıt olun, 2 dakikada uygulamanıza bağlayın.

Ücretsiz plan var · 15.000 istek/ay, kredi kartı gerekmiyor
Ücretsiz anahtar alPlanları gör
Basit auth

X-API-Key başlığı. JWT/OAuth karmaşası yok.

Düşük gecikme

Türkiye edge sunucusu — p95 <50ms.

PNG görseller

Portföy + heatmap görselleri cache'lenmiş, anlık servise hazır.

AI özetler

DeepSeek tarafından üretilmiş Türkçe fon özetleri.

Hızlı başlangıç

Ortam değişkenini ayarla ve çağır.

cURL
export KEY="fon_..."
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE"
Node (fetch)
const res = await fetch(
  "https://fonoloji.com/v1/funds/PHE",
  { headers: { "X-API-Key": process.env.FONOLOJI_KEY } }
);
const fund = await res.json();
Python
import os, requests
key = os.environ["FONOLOJI_KEY"]
r = requests.get(
  "https://fonoloji.com/v1/funds/PHE",
  headers={"X-API-Key": key},
)
print(r.json())

Örnek yanıtlar

Tüm endpoint'ler JSON döner. Tarihler ISO-8601, parasal değerler TL cinsinden.

GET /funds/PHE
{
  "fund": {
    "code": "PHE",
    "name": "PUSULA PORTFÖY HİSSE SENEDİ FONU (HİSSE SENEDİ YOĞUN FON)",
    "type": "YAT",
    "category": "Hisse Senedi Şemsiye Fonu",
    "management_company": "Pusula Portföy Yönetimi A.Ş.",
    "isin": "TRYPSLP00010",
    "risk_score": 6,
    "trading_status": "AKTİF",
    "trading_start": "09:00",
    "trading_end": "17:00",
    "buy_valor": 1,
    "sell_valor": 2,
    "current_price": 2.816142,
    "current_date": "2026-04-30",
    "return_1d": -0.000586,
    "return_1w": -0.00501,
    "return_1m": 0.091457,
    "return_3m": 0.512178,
    "return_6m": 1.230964,
    "return_1y": 1.670785,
    "return_ytd": 0.946855,
    "real_return_1y": 1.040792,
    "volatility_90": 0.174613,
    "sharpe_90": 7.9141,
    "sortino_90": 12.8878,
    "calmar_1y": 6.39,
    "beta_1y": 1.0017,
    "max_drawdown_1y": -0.172801,
    "ma_30": 2.672913,
    "ma_90": 2.15306,
    "ma_200": 1.67323,
    "aum": 36522590809.75,
    "investor_count": 90471,
    "first_seen": "2024-04-09",
    "last_seen": "2026-05-01",
    "kap_url": "https://www.kap.org.tr/tr/fon-bilgileri/genel/phe-..."
  },
  "portfolio": {
    "code": "PHE",
    "date": "2026-04-22",
    "stock": 79.18,
    "government_bond": 0,
    "treasury_bill": 0,
    "corporate_bond": 0,
    "eurobond": 0,
    "gold": 0,
    "cash": 0,
    "other": 20.82
  }
}
GET /funds/PHE/history?period=1y
{
  "code": "PHE",
  "period": "1y",
  "points": [
    {
      "date": "2025-05-02",
      "price": 1.036193,
      "total_value": 0,
      "investor_count": 632
    },
    {
      "date": "2025-05-05",
      "price": 1.047051,
      "total_value": 0,
      "investor_count": 619
    },
    ...
    {
      "date": "2026-04-29",
      "price": 2.817793,
      "total_value": 36522590809.75,
      "investor_count": 90471
    },
    {
      "date": "2026-04-30",
      "price": 2.816142,
      "total_value": null,
      "investor_count": null
    }
  ]
}
GET /funds/PHE/ai-summary
{
  "code": "PHE",
  "summary": "Pusula Portföy Hisse Senedi Fonu, son 1 yılda nominal %167.1, reel olarak ise %104.1 getiri sağladı. Portföyün %79'u hisse senedinden oluşuyor, bu da fonun hisse senedi yoğun kategorisiyle uyumlu. Sharpe oranı 7.91 ve volatilitesi %17.5 seviyesinde, bu da yüksek getiriyle birlikte görece makul bir risk profili olduğunu gösteriyor. Maksimum değer kaybı %17.3 olarak gerçekleşti. Fonun toplam yönetilen varlığı 36.52 milyon TL seviyesinde bulunuyor.",
  "cached": true,
  "model": "gpt-4.1-mini",
  "generated_at": 1777632746304
}
GET /funds/XYZ/holdings-image (cache miss)
// HTTP 503 — görsel henüz cache'te değil
{
  "error": "Görsel henüz hazırlanmadı",
  "message": "Bu fon için görsel cache boş. Birkaç dakika sonra tekrar deneyin veya tarayıcıdan https://fonoloji.com/fon/PHE adresini ziyaret ederek cache'i ısıtın.",
  "retryAfterSeconds": 60
}

Görsel ve AI endpoint'leri

Portföy görselleri, ısı haritası PNG'leri ve AI fon özetleri hazır cache'ten servis edilir — API üzerinden sıfırdan üretim yapılmaz. Bir fonun cache'i hazırsa anlık (x-cache: HIT) yanıt alırsın; hazır değilse 503 Service Unavailable + Retry-After: 60 döner. Cache, fonun sayfası site üzerinden ziyaret edildiğinde otomatik ısınır.

Fon portföy görseli
https://fonoloji.com/v1/funds/PHE/holdings-image?variant=v6

Variants: v3 (poster), v4 (radial), v5 (sınıf), v6 (değişim defteri — önceki ay diff).

Fon ısı haritası
https://fonoloji.com/v1/funds/PHE/heatmap-image?period=daily

period=daily | monthly | quarterly. Günlük cache, gece yenilenir.

Hisse ısı haritası
https://fonoloji.com/v1/stocks/AKBNK/heatmap-image?period=monthly

BIST hissesinin tarihsel performans haritası — Yahoo verisinden.

AI fon özeti
https://fonoloji.com/v1/funds/PHE/ai-summary

DB'den okur; yoksa 404. Türkçe 3-5 cümle özet.

görseli kaydet
curl -H "X-API-Key: $KEY" -o phe-portfoy.png \
  "https://fonoloji.com/v1/funds/PHE/holdings-image?variant=v6"

# Yanıt başlıkları:
# Content-Type: image/png
# X-Cache: HIT
# Cache-Control: public, max-age=3600, s-maxage=86400

Endpoint'ler

Base URL: https://fonoloji.com/v1 · Kimlik: X-API-Key başlığı veya ?api_key= query parametresi

Fonlar

Tüm fonlar; sort/filter destekli liste (limit, offset, category, manager, sort)

Tam URL
https://fonoloji.com/v1/funds
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds"

Sadece TEFAS kodları (toplu indirim için, saatte 5 istek)

Tam URL
https://fonoloji.com/v1/funds/codes
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/codes"

Tek fonun tüm metrikleri + son portföy snapshot

Tam URL
https://fonoloji.com/v1/funds/PHE
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE"

Fiyat geçmişi (period=1w|1m|3m|6m|1y|5y|all)

Tam URL
https://fonoloji.com/v1/funds/PHE/history
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/history"

Fon portföyündeki hisseler (en güncel 2 dönem karşılaştırmalı)

Tam URL
https://fonoloji.com/v1/funds/PHE/holdings
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/holdings"

Dağılım sayfası verisi (varlık sınıfı + pozisyon listesi, JSON)

Tam URL
https://fonoloji.com/v1/funds/PHE/holdings-data
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/holdings-data"

Mevcut rapor tarihleri listesi

Tam URL
https://fonoloji.com/v1/funds/PHE/holdings-dates
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/holdings-dates"

Portföy dağılım görseli (PNG, V5/V6 varyantları)

Tam URL
https://fonoloji.com/v1/funds/PHE/holdings-image
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/holdings-image"

PNG döner. Cache'te yoksa 503 + Retry-After; ısınması için /fon/<kod> sayfası bir kez ziyaret edilmeli.

Performans haritası verisi (period=daily|monthly|quarterly)

Tam URL
https://fonoloji.com/v1/funds/PHE/heatmap
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/heatmap"

Performans haritası görseli (PNG)

Tam URL
https://fonoloji.com/v1/funds/PHE/heatmap-image
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/heatmap-image"

PNG döner. Cache'te yoksa 503 + Retry-After; ısınması için /fon/<kod> sayfası bir kez ziyaret edilmeli.

Fonun portföyündeki hisselerin ağırlıklı F/K, PD/DD, ROE, temettü ortalaması + top 5 sektör

Tam URL
https://fonoloji.com/v1/funds/PHE/fundamentals-aggregate
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/fundamentals-aggregate"

Kategori içi yüzdelik dilimleri (Sharpe, return, vol)

Tam URL
https://fonoloji.com/v1/funds/PHE/percentile
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/percentile"

Ay-bazında getiri matrisi (yıl × ay)

Tam URL
https://fonoloji.com/v1/funds/PHE/monthly-returns
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/monthly-returns"

Maksimum kayıp (drawdown) zaman serisi

Tam URL
https://fonoloji.com/v1/funds/PHE/drawdown
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/drawdown"

Varlık dağılımının zaman içindeki değişimi

Tam URL
https://fonoloji.com/v1/funds/PHE/portfolio-timeline
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/portfolio-timeline"

BIST100 / kategoriye karşı kümülatif performans

Tam URL
https://fonoloji.com/v1/funds/PHE/vs-benchmark
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/vs-benchmark"

Fon-özel KAP bildirimleri

Tam URL
https://fonoloji.com/v1/funds/PHE/disclosures
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/disclosures"

Anlık NAV tahmini (Yahoo + portföy ağırlıklı)

Tam URL
https://fonoloji.com/v1/funds/PHE/live-estimate
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/live-estimate"

Geçmiş NAV tahminlerinin gerçeğe yakınlığı

Tam URL
https://fonoloji.com/v1/funds/PHE/estimate-accuracy
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/estimate-accuracy"

Stress-test, alfa, mevsimsellik, leakage skorları

Tam URL
https://fonoloji.com/v1/funds/PHE/advanced
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/advanced"

AI tarafından üretilmiş Türkçe özet (DB cache, readonly)

Tam URL
https://fonoloji.com/v1/funds/PHE/ai-summary
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/ai-summary"

DB'den okur — taze üretim yapmaz. Yoksa 404.

Portföydeki hisseler için aracı kurum hedef fiyatları

Tam URL
https://fonoloji.com/v1/funds/PHE/analyst-consensus
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/analyst-consensus"

Fon vs gram altın karşılaştırma

Tam URL
https://fonoloji.com/v1/funds/PHE/gold-parity
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/PHE/gold-parity"

Yeni kurulan fonlar (son N gün)

Tam URL
https://fonoloji.com/v1/funds/new
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/new"

TEFAS'tan kaldırılmış fonlar

Tam URL
https://fonoloji.com/v1/funds/archived
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/archived"

Tüm fon-metrik tablosu CSV (saatte 5 istek)

Tam URL
https://fonoloji.com/v1/funds.csv
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds.csv"

İstatistik & İçgörü

Günün piyasa özeti (gainers, losers, agregat)

Tam URL
https://fonoloji.com/v1/summary/today
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/summary/today"

Kategori istatistikleri (1Y ortalama getiri sıralı)

Tam URL
https://fonoloji.com/v1/categories
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/categories"

Kategori detayı + içindeki fonlar

Tam URL
https://fonoloji.com/v1/categories/X
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/categories/X"

Portföy yönetim şirketleri performans tablosu

Tam URL
https://fonoloji.com/v1/management-companies
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/management-companies"

Tek şirketin tüm fonları + performansı

Tam URL
https://fonoloji.com/v1/management-companies/X
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/management-companies/X"

Şirket-bazında ağırlıklı performans skoru

Tam URL
https://fonoloji.com/v1/management-companies/X/score
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/management-companies/X/score"

Fon arama (kod veya ad)

Tam URL
https://fonoloji.com/v1/search
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/search"

En çok kazanan/kaybedenler (period=1d|1w|1m|3m|1y|ytd)

Tam URL
https://fonoloji.com/v1/insights/movers
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/insights/movers"

Para akışı liderleri (inflow/outflow)

Tam URL
https://fonoloji.com/v1/insights/flow
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/insights/flow"

Risk skoru dağılımı (1-7 ölçek)

Tam URL
https://fonoloji.com/v1/insights/risk-distribution
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/insights/risk-distribution"

Kategori × varlık sınıfı exposure ısı haritası

Tam URL
https://fonoloji.com/v1/insights/exposure-heatmap
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/insights/exposure-heatmap"

Risk-getiri scatter — (volatility, return_1y) tüm fonlar

Tam URL
https://fonoloji.com/v1/insights/risk-return
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/insights/risk-return"

Fon günlük getiri ısı haritası verisi

Tam URL
https://fonoloji.com/v1/insights/heatmap/PHE
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/insights/heatmap/PHE"

Pearson korelasyon matrisi (codes=AAA,BBB,…)

Tam URL
https://fonoloji.com/v1/insights/correlation
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/insights/correlation"

MA 30/200 kesişim sinyalleri (rising/falling)

Tam URL
https://fonoloji.com/v1/insights/trend
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/insights/trend"

Risk profile-tabanlı portföy önerisi

Tam URL
https://fonoloji.com/v1/insights/portfolio-recommendation
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/insights/portfolio-recommendation"

Hisseler

BIST listesi — şirket adı, sektör, son fiyat

Tam URL
https://fonoloji.com/v1/stocks/list
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/stocks/list"

Hisse tarayıcı (sıralı, filtreli)

Tam URL
https://fonoloji.com/v1/stocks/screener
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/stocks/screener"

Tek hisse detayı (fiyat, F/K, fonlardaki ağırlığı)

Tam URL
https://fonoloji.com/v1/stocks/AKBNK
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/stocks/AKBNK"

Anlık + son kapanış fiyatı

Tam URL
https://fonoloji.com/v1/stocks/AKBNK/price
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/stocks/AKBNK/price"

Fiyat grafiği verisi (period=1d|5d|1mo|3mo|6mo|1y|5y)

Tam URL
https://fonoloji.com/v1/stocks/AKBNK/chart
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/stocks/AKBNK/chart"

Hisse KAP bildirimleri

Tam URL
https://fonoloji.com/v1/stocks/AKBNK/disclosures
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/stocks/AKBNK/disclosures"

En güncel finansal rapor + temel kalemler

Tam URL
https://fonoloji.com/v1/stocks/AKBNK/rapor-latest
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/stocks/AKBNK/rapor-latest"

Belirli dönem finansal rapor (donem=2024Q4 vb.)

Tam URL
https://fonoloji.com/v1/stocks/AKBNK/rapor/2025-Q1
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/stocks/AKBNK/rapor/2025-Q1"

Aracı kurum tavsiyeleri (AL/TUT/SAT + hedef)

Tam URL
https://fonoloji.com/v1/stocks/AKBNK/recommendations
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/stocks/AKBNK/recommendations"

Hisse performans haritası verisi

Tam URL
https://fonoloji.com/v1/stocks/AKBNK/heatmap
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/stocks/AKBNK/heatmap"

Hisse performans haritası görseli (PNG)

Tam URL
https://fonoloji.com/v1/stocks/AKBNK/heatmap-image
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/stocks/AKBNK/heatmap-image"

PNG döner. Cache'te yoksa 503 + Retry-After; ısınması için /fon/<kod> sayfası bir kez ziyaret edilmeli.

Logo dosya envanteri (toplu indirme için)

Tam URL
https://fonoloji.com/v1/stock-logos
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/stock-logos"

Piyasa & Ekonomi

Fon piyasası gainers/losers (1d/1w/1m)

Tam URL
https://fonoloji.com/v1/market/movers
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/market/movers"

BIST gainers/losers (gün içi)

Tam URL
https://fonoloji.com/v1/market/stock-movers
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/market/stock-movers"

Hisse günün performans sıralamasında kaçıncı

Tam URL
https://fonoloji.com/v1/market/movers/rank/AKBNK
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/market/movers/rank/AKBNK"

BIST mum formasyonu tarayıcısı (TradingView Candle.*)

Tam URL
https://fonoloji.com/v1/market/patterns
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/market/patterns"

Canlı endeksler (BIST100, USD/TRY, EUR/TRY, gümüş)

Tam URL
https://fonoloji.com/v1/market/live
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/market/live"

AI günlük piyasa özeti (DB cache, readonly)

Tam URL
https://fonoloji.com/v1/market/digest
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/market/digest"

DB'den okur — taze üretim yapmaz. Yoksa 404.

Anlık altın fiyatları (gram, çeyrek, ons, …)

Tam URL
https://fonoloji.com/v1/gold/live
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/gold/live"

Fonlar vs altın karşılaştırma matrisi

Tam URL
https://fonoloji.com/v1/gold/compare
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/gold/compare"

TÜİK enflasyon (TÜFE) zaman serisi

Tam URL
https://fonoloji.com/v1/economy/cpi
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/economy/cpi"

Son KAP bildirimleri (kategori filtreli)

Tam URL
https://fonoloji.com/v1/disclosures/recent
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/disclosures/recent"

KAP'a en çok bildirim açan fonlar

Tam URL
https://fonoloji.com/v1/kap/trending-funds
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/kap/trending-funds"

Hisse Tarayıcı (Screener)

BIST hisse tarayıcı — F/K, PD/DD, FAVÖK, temettü, ROE, borç filtreleri (tüm parametreler aşağıda)

Tam URL
https://fonoloji.com/v1/screener/bist
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/screener/bist"

BIST sektör listesi (filter dropdown'ı için)

Tam URL
https://fonoloji.com/v1/screener/bist/sectors
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/screener/bist/sectors"

Araçlar

Çoklu fon portföyü için risk/getiri/exposure analizi

Tam URL
https://fonoloji.com/v1/tools/portfolio-xray
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/tools/portfolio-xray"

İki fon arasındaki portföy çakışması (a=AAA&b=BBB)

Tam URL
https://fonoloji.com/v1/tools/fund-overlap
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/tools/fund-overlap"

En doğru NAV tahminine sahip fonlar

Tam URL
https://fonoloji.com/v1/estimate-leaderboard
cURL
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/estimate-leaderboard"

Screener filter parametreleri

/v1/screener/bist endpoint'i için query parametreleri. Hepsi opsiyonel; birden fazlası AND ile birleşir.

pe_maxF/K oranı tavanı (örn. 8 → ucuz)
pe_minF/K oranı tabanı
pb_maxPD/DD tavanı (örn. 1.5)
ev_ebitda_maxFD/FAVÖK tavanı (banka hariç)
dividend_yield_minTemettü verimi tabanı, yüzde (örn. 8 → %8)
dividend_payout_maxDağıtım oranı tavanı, yüzde
dividend_payout_streak_minArdışık temettü ödeyen yıl tabanı
dividend_growth_streak_minArdışık temettü artışı yıl tabanı
debt_to_equity_maxBorç/özkaynak tavanı (örn. 1)
roe_minROE (özkaynak kârlılığı) tabanı, yüzde
roa_minROA (aktif kârlılığı) tabanı, yüzde
current_ratio_minCari oran tabanı (örn. 1.5)
market_cap_minPiyasa değeri tabanı, milyon TL (örn. 5000)
sectorSektör adı (Finance, Process Industries, Utilities, ...)
sort_bySıralama: market_cap, pe_ratio, pb_ratio, dividend_yield, return_on_equity, debt_to_equity
sort_orderasc / desc (default: desc)
limit1-200 (default: 50)
Örnek
# Yüksek temettülü, sürdürülebilir, 5+ milyar TL piyasa değeri
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/screener/bist?dividend_yield_min=8&dividend_payout_max=80&dividend_payout_streak_min=3&market_cap_min=5000&sort_by=dividend_yield&sort_order=desc"

# F/K düşük + ROE yüksek + borç kontrollü değer hisseleri
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/screener/bist?pe_max=8&pb_max=1.5&debt_to_equity_max=1&roe_min=15&sort_by=pe_ratio&sort_order=asc"

Rate limit başlıkları

Her yanıtta döneriz:

x-ratelimit-limitDakika başına izin verilen istek sayısı (plana göre)
x-ratelimit-remainingBu pencerede kalan istek
x-ratelimit-resetPencerenin sıfırlanmasına kalan saniye
x-ratelimit-limit-monthlyAylık toplam kota
x-ratelimit-remaining-monthlyBu ay kalan istek
x-ratelimit-limit-dailyGünlük toplam kota
retry-after429/503 durumunda bekleme süresi (saniye)
x-cacheGörsel/AI: HIT (cache'ten) veya MISS (taze üretildi, cache'lendi)

Hata kodları

KodAnlamı
200Başarılı
400Eksik veya geçersiz parametre
401API anahtarı eksik veya geçersiz
403Hesap pasife alınmış (iletişime geçin)
404Fon/kategori/AI özet bulunamadı
429Dakika/günlük/aylık kota aşımı — retry-after'a bakın
503Görsel cache henüz boş — Retry-After saniye sonra tekrar deneyin (cache site ziyaretinde otomatik ısınır)
5xxSunucu hatası — otomatik raporlanır, 5sn sonra tekrar deneyin