API ve MCP
Kimlik doğrulama yok, CORS açık. IP başına dakikada 60 istek (aşılınca 429 + Retry-After; kalan hak X-RateLimit-Remaining başlığında). Veri günde bir güncellenir; yanıtlar 5 dk önbelleklenebilir. Getiriler %, tutarlar TL. Ticari olmayan kullanım içindir (PolyForm Noncommercial), yatırım tavsiyesi değildir.
REST (JSON)
| GET | /api/v1/funds?kind=yat&q=altın&sort=y1&limit=10 | Fon ara, filtrele, sırala. kind: yat | bes | byf | gyf | all; type, founder, min_size, active=0, order, offset |
| GET | /api/v1/funds/AFT?history=365 | Fon detayı: getiriler, endeks kıyası, risk, varlık dağılımı, KAP hisse portföyü; history = günlük fiyat geçmişi (gün) |
| GET | /api/v1/stocks/THYAO?min_weight=1 | Hisseyi tutan fonlar: ağırlık ve tahmini TL pozisyon |
| GET | /api/v1/compare?codes=AFT,TCD | 2-10 fon: getiriler ve 1 yıllık günlük getiri korelasyonu |
| GET | /api/v1/scans/en-cok-kazandiran-hisse-fonlari | Hazır tarama sonucu |
| GET | /api/v1/openapi.json | OpenAPI 3.1 belgesi |
| POST | /mcp | MCP sunucusu (Streamable HTTP, durumsuz) |
Sıralama alanları: d1, w1, m1, m3, m6, ytd, y1, y2, y3, y5, size, investors, flow_m1, volatility (d1…y5 getiri vadeleri, flow_m1 = 1 aylık tahmini net giriş).
curl 'https://fon.yourapiservice.com/api/v1/funds?kind=yat&type=Hisse%20Senedi&sort=y1&limit=5' curl 'https://fon.yourapiservice.com/api/v1/funds/AFT?history=30'
MCP sunucusu
Claude, ChatGPT, Cursor gibi MCP destekleyen asistanlara fon verisini araç olarak ekler. Adres: https://fon.yourapiservice.com/mcp (Streamable HTTP, oturumsuz).
search_funds· Fon ara ve sırala (kod/ad, tür, tip, kurucu, getiri vadesi, büyüklük…)get_fund· Fon detayı, isteğe bağlı fiyat geçmişifunds_holding_stock· Bir hisseyi tutan fonlarcompare_funds· 2-10 fonu karşılaştırrun_scan· Hazır taramalardan birini çalıştır
Claude Code
claude mcp add --transport http tefas-fon https://fon.yourapiservice.com/mcp
JSON yapılandırması (Claude Desktop, Cursor, …)
{
"mcpServers": {
"tefas-fon": {
"type": "http",
"url": "https://fon.yourapiservice.com/mcp"
}
}
}Elle deneme
curl -X POST https://fon.yourapiservice.com/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_fund","arguments":{"code":"AFT"}}}'Sitenin kendi istemcisinin kullandığı /api/funds/* ve /api/holdings uçları sıkıştırılmış/iç biçimdir ve haber vermeden değişebilir; dış kullanım için /api/v1 kullanın.