Kullanım KılavuzuUser Guide

Paranın nerede daha çok kazandığını tek ekranda gör. Bu kılavuz ParaAlfa'yı nasıl kullanacağını sade bir dille anlatır. See where your money earns the most, all on one screen. This guide explains how to use ParaAlfa in plain language.

ParaAlfa nedir?What is ParaAlfa?

ParaAlfa, "param nerede daha iyi kazanır?" sorusunu tek yerde cevaplayan bir araçtır. TEFAS yatırım fonlarını, banka mevduat faizlerini ve senin kendi portföyünü aynı ölçüyle karşılaştırır — hepsi güncel, gerçek verilerle. ParaAlfa answers one question in one place: "where does my money earn more?" It compares TEFAS investment funds, bank deposit rates and your own portfolio — side by side, with fresh, real data.

Ne yapabilirsin?What you can do

Nasıl başlarım?Getting started

1. Kayıt ol. E-posta ve şifrenle bir hesap oluştur (ya da Google ile — açıksa).Sign up. Create an account with your email and password (or with Google — if enabled).
2. E-postanı doğrula. Gelen kutuna düşen linke tıkla.Confirm your email. Click the link sent to your inbox.
3. Giriş yap. Artık fonları, faizleri ve portföyünü görebilirsin.Log in. Now you can see funds, rates and your portfolio.

Portföyümü takip etTrack your portfolio

Portföyüm sekmesinde yatırımlarını eklersin ve hepsinin güncel durumunu tek bakışta görürsün.In the My Portfolio tab you add your investments and see everything at a glance.

1. Fon kodu + tutar gir (örn. TP2, 10.000 ₺).Enter a fund code + amount (e.g. TP2, 10,000 ₺).
2. İstersen alış tarihini ekle — o günkü fiyattan gerçek getirin hesaplanır.Optionally add the purchase date — your real return is calculated from that day's price.
3. Net kazancını gör: güncel değer, stopaj ve stopaj sonrası kazanç otomatik gelir.See your net gain: current value, tax and after-tax profit appear automatically.
4. Aynı fona ekleme yap: bir fondan tekrar alırsan satırdaki ＋ Alım ekle ile hızlıca eklersin. Aynı fonun tüm alımları tek satırda toplanır (ağırlıklı ort. maliyet + birleşik net kazanç); satırı açınca alımları tek tek görürsün.Add to the same fund: buying more? Use ＋ Add buy on the row. All buys of a fund fold into one row (weighted average cost + combined net gain); expand it to see each buy.

Ayrıca değer geçmişi grafiği, aylık kazanç ve "aynı para mevduatta/dolarda olsaydı" kıyası da burada.You also get a value-history chart, monthly gains, and a "what if it were in a deposit/USD instead" comparison.

Sepetler: Portföyünü adlandırılmış sepetlere (örn. "Emeklilik", "Acil Fon") bölebilirsin. Üstteki sekmelerden yeni sepet oluştur, adını kendin koy; her fon tek bir sepette durur, sepetler arası taşıyabilirsin. Her sepetin kendi kâr/zararını ayrı görürsün. Sepeti silersen fonlar silinmez — Ana Sepet'e döner.Baskets: Split your portfolio into named baskets (e.g. "Retirement", "Emergency"). Create one from the top tabs and name it yourself; each fund lives in a single basket and can be moved between them. You see each basket's own profit/loss. Deleting a basket never deletes funds — they move back to the Main Basket.

Hazır Sepetler: "🧩 Hazır sepet" ile 20 hazır arketip açılır (Rahat, Orta Riskli, Emeklilik, Katılım, Hisse Ağırlık…). Sana Uygun sekmesinde 3 kısa soruyu (amaç, vade, risk tepkisi) yanıtla → profiline en uygun sepetler sebebiyle önerilir. Fonlar güven skoruyla seçilir (deterministik), her karta güncel bir piyasa notu eklenir. Tutarı sen belirle → oranlara göre otomatik kurulur.Ready-made baskets: "🧩 Ready basket" opens 20 archetypes (Relaxed, Medium Risk, Retirement, Participation, Equity-heavy…). In the For You tab, answer 3 short questions (goal, horizon, risk reaction) → the best-fitting baskets are recommended with reasons. Funds are picked by confidence score (deterministic), each card carries a current market note. You set the amount → it's built automatically by ratio.

Fonları inceleExplore funds

Ana ekran fonları risk grubuna göre sıralar: Düşük (1–2), Orta (3–4), Yüksek (5–6–7). Üstteki sekmelerden zaman aralığını (günlük → yıllık) seçersin.The main screen ranks funds by risk group: Low (1–2), Mid (3–4), High (5–6–7). Pick the time window (daily → yearly) from the top tabs.

Bir fona tıkla → sağdan açılan panelde: getiri grafiği, fonun neye yatırdığı (portföy dağılımı) ve BİST/altın/dolar/mevduat ile kıyas.Tap a fund → a side panel opens with its return chart, what it invests in (allocation), and a comparison vs stocks/gold/USD/deposits.

Beğendiğin fonları ★ favorilere ekle; Favoriler sekmesinden ya da Telegram'dan takip et.Add funds you like to ★ favorites and follow them from the Favorites tab or Telegram.

Akıllı öneriler — en güvenilir fonlarSmart picks — the most reliable funds

Binlerce fon arasından hangisine güveneceğini bulmak zor. Öneriler tam bunun için: sistem her gün, her risk grubunda (düşük · orta · yüksek) öne çıkan fonları bir güven filtresinden geçirip en güvenilir olanları seçer ve sana sunar.Picking which of thousands of funds to trust is hard. That's what Recommendations are for: every day the system runs the standout funds in each risk group (low · mid · high) through a confidence filter and surfaces the most reliable ones for you.

Güven filtresi tek bir getiri sayısına bakmaz; fon büyüklüğü, yatırımcı sayısı, para akışı ve getiri istikrarını birlikte değerlendirir — böylece "bir günlük parlayan" fonlar değil, tutarlı olanlar öne çıkar.The filter doesn't look at a single return figure; it weighs fund size, investor count, money flow and return stability together — so it's the consistent funds that rise to the top, not one-day flashes.

Her öneri, yapay zekâ destekli sade bir analiz ile açıklanır: fon ne yapıyor, neden öne çıktı, hangi risk profiline uygun. Sayılar deterministik kod ile hesaplanır (uydurma yok); yapay zekâ yalnızca bu analizi okunaklı bir dille yazar.Each pick comes with an AI-assisted plain-language analysis: what the fund does, why it stands out, which risk profile it fits. The numbers are computed deterministically (nothing invented); AI only writes that analysis in readable prose.

Banka faizleriBank rates

Banka Faizleri sekmesinde bankaların TL mevduat oranlarını görürsün. Tutar ve vade girersen o kademedeki gerçek oran hesaplanır (çünkü oran tutara ve vadeye göre değişir).In the Bank Rates tab you see banks' deposit rates. Enter an amount and term to get the real rate for that tier (rates change by amount and term).

İki oran ayrı gösterilir: standart (tabela) ve varsa kampanya (yeni müşteri/yeni para, koşullu). Resmî bankasından çekilen oranlar "resmî" rozetiyle işaretlidir.Two rates are shown separately: standard and, if any, promo (new customer/new money, conditional). Rates pulled from the bank's own site carry an "official" badge.

Ne kazandırırdı?What would it have earned?

Hesapla sekmesi geçmişe bakar: bir tutar + bir tarih gir, araçları seç (dolar, euro, altın, mevduat, BİST, enflasyon, kripto, fon…) → bugüne kadar ne kazandırırdı, tek grafikte.The Calculate tab looks back in time: enter an amount + a date, pick instruments (USD, EUR, gold, deposit, BIST, inflation, crypto, a fund…) → see what each would have earned until today, in one chart.

Geçmiş performans gelecek getiriyi göstermez; bu bir "olsaydı" kıyasıdır.Past performance doesn't predict future returns; this is a "what-if" comparison.

Makro & önerilerMacro & tips

Makro sekmesi enflasyon, faiz, dolar gibi göstergeleri ve dünya merkez bankalarının duruşunu gösterir — her göstergenin altında sade bir fon seçim ipucu vardır.The Macro tab shows indicators like inflation, rates and FX plus global central-bank stances — each with a simple fund-selection hint.

Öneriler ise her risk grubunda (düşük/orta/yüksek) öne çıkan fonları gün gün listeler. Otomatik ve tarafsızdır; tavsiye değildir.Recommendations list standout funds for each risk group (low/mid/high), day by day. Automatic and neutral; not advice.

Fonu nereden alırım?Where do I buy a fund?

ParaAlfa alım-satım yapmaz — bir karşılaştırma ve takip aracıdır. Beğendiğin fonu incelerken "peki bunu nereden alırım?" diye düşünürsen, seçenekler şunlar:ParaAlfa doesn't trade — it's a compare-and-track tool. When you like a fund and wonder "where do I actually buy it?", here are your options:

Telegram botu & bildirimlerTelegram bot & alerts

Portföyünü Telegram'a bağlarsan, botla her şeyi telefonundan yapabilirsin.Link your portfolio to Telegram and do everything from your phone with the bot.

1. Panelde Ayarlar → Bildirimler → Telegram'a Bağla de, çıkan linke tıkla.In the panel go to Settings → Notifications → Connect Telegram and tap the link.
2. Bot açılınca /start ile bağlanırsın.When the bot opens, connect with /start.
3. Hangi bildirimleri istediğini aç/kapa ile seç.Choose which alerts you want with simple on/off toggles.

Bot komutlarıBot commands

Hangi bildirimler var?What alerts are there?

• Günlük özet — her gün veri gelince portföyünün durumu (grafik + kart).Daily summary — your portfolio when new data lands (chart + card).
• Hareket uyarısı — bir fon belirlediğin eşiğin üstünde oynayınca.Movement alert — when a fund moves beyond your chosen threshold.
• Favori takibi — favori fonlarının günlük getirisi.Favorites — the daily return of your favorite funds.

Geliştiriciler için: REST API & MCPFor developers: REST API & MCP

Paneldeki her sayı aynı zamanda koddan ve yapay zekâ asistanlarından erişilebilir — hepsi aynı günlük veriden. Bu bölüm isteğe bağlıdır; ParaAlfa'yı kullanmak için gerekmez.Every number in the panel is also reachable from code and from AI assistants — all from the same daily data. This section is optional; you don't need it to use ParaAlfa.

REST APIREST API

Fon sıralamaları, fon detayı, banka faizleri ve makro veriler herkese açık, salt-okunur uçlardan JSON olarak gelir (anahtar gerekmez). Canlı, denenebilir dokümantasyon: Swagger arayüzü.Fund rankings, fund detail, bank rates and macro data come as JSON from public, read-only endpoints (no key needed). Live, try-it docs: Swagger UI.

# En çok kazandıran düşük riskli fonlar (haftalık)
GET /api/rankings?group=12&window=7&limit=10

# 100.000 ₺, 92 gün için en iyi banka faizi
GET /api/bank-rate?amount=100000&maturity=92

# Fon detayı — getiri + dağılım + kıyas
GET /api/funds/PRY

# Top low-risk funds (weekly)
GET /api/rankings?group=12&window=7&limit=10

# Best bank rate for 100,000 ₺, 92 days
GET /api/bank-rate?amount=100000&maturity=92

# Fund detail — return + allocation + benchmark
GET /api/funds/PRY

Portföy uçları (pozisyonlar, kazanç, bildirimler) kişiseldir ve giriş gerektirir. Kod içinden erişmek için Ayarlar → API anahtarları'ndan kendine özel bir anahtar üretirsin (anahtar yalnız üretildiği an bir kez gösterilir).Portfolio endpoints (positions, gains, alerts) are personal and need login. To reach them from code, create your own key in Settings → API keys (the key is shown only once, at creation).

MCP — Claude & ChatGPT entegrasyonuMCP — Claude & ChatGPT integration

MCP (Model Context Protocol) ile ParaAlfa'yı bir yapay zekâ asistanına bağlarsın; portföyünü ve fonları konuşarak yönetirsin. 19 araç vardır: sıralama, fon detayı, banka faizi, merkez bankası duruşu, TR makro, "ne kazandırırdı" hesabı, portföy ekle/çıkar ve daha fazlası.With MCP (Model Context Protocol) you connect ParaAlfa to an AI assistant and manage your portfolio and funds by chatting. There are 19 tools: rankings, fund detail, bank rates, central-bank stance, TR macro, the "what-if" calculator, add/remove positions and more.

• Claude Desktop / Claude Code: yerel stdio bağlantısı — MCP sunucusunu ekle, hazır.Claude Desktop / Claude Code: local stdio connection — add the MCP server and you're set.
• ChatGPT (web): uzak streamable-http uç — https://mcp.paraalfa.com/mcp. Kişisel API anahtarı zorunlu (üye olmayan / anahtarsız bağlanamaz).ChatGPT (web): remote streamable-http endpoint — https://mcp.paraalfa.com/mcp. A personal API key is required (non-members / keyless can't connect).

// Asistana sor — o doğru aracı çağırır:
"En çok kazandıran düşük riskli 5 fon?"
 → tefas_top(group="12", window=7)

"200 bin ₺'yi 6 ay bağlasam hangi banka?"
 → tefas_bank_rates(amount=200000, maturity=181)

"Portföyüme 15.000 ₺ TP2 ekle."
 → tefas_add_investment(fon="TP2", tutar=15000)

// Ask the assistant — it calls the right tool:
"Top 5 low-risk funds this week?"
 → tefas_top(group="12", window=7)

"Which bank for 200k ₺ locked 6 months?"
 → tefas_bank_rates(amount=200000, maturity=181)

"Add 15,000 ₺ of TP2 to my portfolio."
 → tefas_add_investment(fon="TP2", tutar=15000)

Araçlar: tefas_top tefas_fund tefas_search tefas_bank_rates tefas_macro tefas_cb_stance tefas_compare tefas_portfolio tefas_add_investment … — tam liste Swagger'da.Tools: tefas_top tefas_fund tefas_search tefas_bank_rates tefas_macro tefas_cb_stance tefas_compare tefas_portfolio tefas_add_investment … — full list in Swagger.

Gizlilik & güvenPrivacy & safety

• Portföyün ve verilerin sana özeldir — başka kullanıcılar göremez.Your portfolio and data are private — other users can't see them.
• Değerleri gizle modu: ekran görüntüsü/paylaşım için tutarları bulanıklaştırır.Hide values mode: blurs amounts for screenshots/sharing.
• Verini istediğin an CSV/JSON olarak indirebilir, hesabını silebilirsin.Export your data as CSV/JSON anytime, or delete your account.
• ParaAlfa yatırım tavsiyesi vermez; tüm sayılar bilgilendirme amaçlıdır.ParaAlfa gives no investment advice; all figures are informational.

SSS / FAQ

Kod ve yapay zekâ ile entegrasyon mu istiyorsun? REST API & MCP bölümüne bak; canlı uç referansı Swagger'da. Want to integrate with code or AI? See the REST API & MCP section; the live endpoint reference is in Swagger.