{"openapi":"3.1.0","info":{"title":"TEFAS Fon Analiz API","version":"1.0.0","description":"TEFAS fonları (yatırım, BES, BYF, GYF): liste/arama, fon detayı, hisseyi tutan fonlar, karşılaştırma, hazır taramalar. Kimlik doğrulama yok; IP başına dakikada 60 istek. Veri günde bir güncellenir (TEFAS, KAP, Yahoo Finance). Yatırım tavsiyesi değildir. Ticari olmayan kullanım (PolyForm Noncommercial). Aynı araçlar MCP olarak da sunulur: POST /mcp."},"servers":[{"url":"https://fon.yourapiservice.com"}],"paths":{"/api/v1/funds":{"get":{"operationId":"searchFunds","summary":"Fonları ara, filtrele, sırala","parameters":[{"name":"kind","in":"query","required":false,"description":"Fon türü","schema":{"type":"string","enum":["yat","bes","byf","gyf","all"],"default":"all"}},{"name":"q","in":"query","required":false,"description":"Kod ya da adda geçen metin (Türkçe harf duyarsız)","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Fon tipi, kısmi (ör. Hisse Senedi, Para Piyasası)","schema":{"type":"string"}},{"name":"founder","in":"query","required":false,"description":"Kurucu PYŞ, kısmi (ör. İş Portföy)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Sıralama alanı","schema":{"type":"string","enum":["d1","w1","m1","m3","m6","ytd","y1","y2","y3","y5","size","investors","flow_m1","volatility"],"default":"size"}},{"name":"order","in":"query","required":false,"description":"Yön","schema":{"type":"string","enum":["desc","asc"],"default":"desc"}},{"name":"min_size","in":"query","required":false,"description":"En az büyüklük (TL)","schema":{"type":"number","minimum":0}},{"name":"active","in":"query","required":false,"description":"0: pasif/tasfiye fonlar dahil","schema":{"type":"string","enum":["1","0"],"default":"1"}},{"name":"limit","in":"query","required":false,"description":"Sayfa boyutu","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"description":"Atlanacak kayıt","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundList"}}}},"400":{"description":"Hata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Dakikada 60 istek sınırı aşıldı (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/funds/{code}":{"get":{"operationId":"getFund","summary":"Fon detayı","parameters":[{"name":"code","in":"path","required":true,"description":"TEFAS fon kodu (ör. AFT)","schema":{"type":"string"}},{"name":"history","in":"query","required":false,"description":"Günlük fiyat geçmişi (gün, 0 = yok)","schema":{"type":"integer","minimum":0,"maximum":1825,"default":0}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundDetail"}}}},"400":{"description":"Hata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Hata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Dakikada 60 istek sınırı aşıldı (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/stocks/{ticker}":{"get":{"operationId":"fundsHoldingStock","summary":"Hisseyi tutan fonlar (son KAP Portföy Dağılım Raporu)","parameters":[{"name":"ticker","in":"path","required":true,"description":"BIST hisse kodu (ör. THYAO)","schema":{"type":"string"}},{"name":"min_weight","in":"query","required":false,"description":"En az ağırlık (%)","schema":{"type":"number","minimum":0,"maximum":100,"default":0}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockFunds"}}}},"400":{"description":"Hata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Dakikada 60 istek sınırı aşıldı (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/compare":{"get":{"operationId":"compareFunds","summary":"2-10 fon: getiriler ve 1 yıllık korelasyon","parameters":[{"name":"codes","in":"query","required":true,"description":"Virgülle ayrılmış fon kodları (ör. AFT,TCD)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Compare"}}}},"400":{"description":"Hata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Dakikada 60 istek sınırı aşıldı (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/scans/{slug}":{"get":{"operationId":"runScan","summary":"Hazır tarama","parameters":[{"name":"slug","in":"path","required":true,"description":"en-cok-kazandiran-hisse-fonlari: Son 1 yılda en çok kazandıran hisse senedi fonları; dusuk-riskli-en-yuksek-getiri: Düşük riskli (1-3) en yüksek getirili fonlar; en-cok-para-girisi: Son 1 ayda en çok para girişi olan fonlar; en-cok-para-cikisi: Son 1 ayda en çok para çıkışı olan fonlar; en-buyuk-fonlar: En büyük yatırım fonları; altin-fonlari: Altın ve kıymetli maden fonları; doviz-fonlari: Döviz cinsi fonlar; en-cok-kazandiran-bes-fonlari: Son 1 yılda en çok kazandıran BES fonları; katilim-fonlari: Katılıma uygun fonlar; katilim-hisse-fonlari: Katılıma uygun hisse senedi fonları; katilim-bes-fonlari: Katılıma uygun BES fonları","schema":{"type":"string","enum":["en-cok-kazandiran-hisse-fonlari","dusuk-riskli-en-yuksek-getiri","en-cok-para-girisi","en-cok-para-cikisi","en-buyuk-fonlar","altin-fonlari","doviz-fonlari","en-cok-kazandiran-bes-fonlari","katilim-fonlari","katilim-hisse-fonlari","katilim-bes-fonlari"]}},{"name":"limit","in":"query","required":false,"description":"En fazla kayıt","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Scan"}}}},"404":{"description":"Hata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Dakikada 60 istek sınırı aşıldı (Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"FundSummary":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["yat","bes","byf","gyf"]},"type":{"type":"string"},"founder":{"type":"string"},"active":{"type":"boolean"},"price":{"type":"number"},"size":{"type":"number","description":"Portföy büyüklüğü, TL"},"investors":{"type":"integer"},"returns":{"type":"object","description":"Getiri, %. d1=1 gün, w1=1 hafta, m1..m6=ay, ytd=yılbaşından beri, y1..y5=yıl; veri yoksa null","additionalProperties":{"type":["number","null"]}},"flows":{"type":"object","description":"Tahmini net nakit akışı (TL): pay sayısı değişimi x fiyat","properties":{"w1":{"type":["number","null"]},"m1":{"type":["number","null"]},"m3":{"type":["number","null"]}}},"risk":{"type":"object","properties":{"score":{"type":["integer","null"],"description":"1-7, volatiliteden tahmini"},"volatility":{"type":["number","null"],"description":"Yıllık, %"},"max_drawdown_1y":{"type":["number","null"],"description":"Son 1 yıl en büyük düşüş, %"}}},"tags":{"type":"object","properties":{"fx":{"type":"boolean"},"islamic":{"type":"boolean"},"qualified":{"type":"boolean"},"stock_focus":{"type":"boolean"},"oks":{"type":"boolean"}}},"stock_pct":{"type":["number","null"],"description":"Hisse senedi oranı, %"},"url":{"type":"string"}}},"FundList":{"type":"object","properties":{"data_date":{"type":"string","format":"date"},"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/FundSummary"}}}},"FundDetail":{"allOf":[{"$ref":"#/components/schemas/FundSummary"},{"type":"object","properties":{"data_date":{"type":"string"},"date":{"type":"string"},"liquidation_notice":{"type":["string","null"]},"benchmarks":{"type":"object","additionalProperties":{"type":"object","properties":{"name":{"type":"string"},"returns":{"type":"object","description":"Getiri, %. d1=1 gün, w1=1 hafta, m1..m6=ay, ytd=yılbaşından beri, y1..y5=yıl; veri yoksa null","additionalProperties":{"type":["number","null"]}}}}},"allocation":{"type":"object","properties":{"date":{"type":["string","null"]},"items":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"pct":{"type":"number"}}}}}},"holdings":{"type":"object","properties":{"report":{"type":["string","null"]},"published":{"type":["string","null"]},"items":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"weight":{"type":"number"}}}}}},"history":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"price":{"type":"number"},"size":{"type":"number"},"investors":{"type":"integer"}}}}}}]},"StockFunds":{"type":"object","properties":{"ticker":{"type":"string"},"count":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"weight":{"type":"number"},"fund_size":{"type":["number","null"]},"est_position_tl":{"type":["number","null"]}}}}}},"Compare":{"type":"object","properties":{"missing":{"type":"array","items":{"type":"string"}},"funds":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"price":{"type":"number"},"returns":{"type":"object","description":"Getiri, %. d1=1 gün, w1=1 hafta, m1..m6=ay, ytd=yılbaşından beri, y1..y5=yıl; veri yoksa null","additionalProperties":{"type":["number","null"]}}}}},"correlation_1y":{"type":"object","properties":{"codes":{"type":"array","items":{"type":"string"}},"matrix":{"type":"array","items":{"type":"array","items":{"type":["number","null"]}}}}}}},"Scan":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"data_date":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/FundSummary"}}}}}}}