Yatırım tavsiyesi değildir. Tüm rakamlar TEFAS'ın halka açık verisinden üretilmiştir; kararların sorumluluğu sana aittir.
Fonoloji
FinolojifinolojiFonun ötesinde: tüm finans tek yerde.BIST · KRİPTO · DÖVİZ · ALTIN · TEMETTÜBIST 10010.842,63▲ +1,24%Finoloji'yi Aç →
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.

BIST hisse piyasa verisi API üzerinden sunulmaz. Borsa İstanbul piyasa verisinin yeniden dağıtımı (redistribution) lisans gerektirdiği için (Borsa İstanbul Veri Dağıtım Sözleşmesi), BIST hisseleri için canlı fiyat, günlük % değişim, önceki kapanış, hacim ve fiyat/mum grafiği alanları döndürülmez; /stocks/:ticker/price ve/chart uçları 451 döner. Kullanılabilir: hisse kodu + ismi, temel veriler (F/K, PD/DD, FAVÖK, temettü, piyasa değeri, ROE), analist hedef fiyat & tavsiyeleri, fonlardaki ağırlık. Fon verileri (NAV dahil) etkilenmez.

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 hisse listesi — kod + şirket adı

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

Hisse tarayıcı (F/K, PD/DD, temettü, ROE… — fiyat/değişim döndürmez)

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

Tek hisse detayı (F/K, analist konsensüsü, fonlardaki ağırlık)

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

BIST için sunulmaz — 451 (piyasa verisi lisansı)

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

BIST için sunulmaz — 451 (piyasa verisi lisansı)

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 gün içi hareket edenler — kod/isim (fiyat/değişim döndürmez)

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