Borsa MCP: Türk Finans Piyasaları için MCP Sunucusu

Borsa MCP: Türk Finans Piyasaları için MCP Sunucusu

Borsa İstanbul (BIST) ve ABD (US) hisseleri, TEFAS fonları, kripto paralar ve döviz/emtia verilerine LLM'ler üzerinden erişim sağlayan FastMCP sunucusu. KAP, Yahoo Finance, BtcTurk, Coinbase, Doviz.com ve TCMB gibi kaynaklardan 75 araçla kapsamlı finansal analiz.

⚠️ Önemli Uyarılar

• LLM'ler halüsinasyon yapabilir - Verileri mutlaka doğrulayın
• Yatırım tavsiyesi değildir - Profesyonel danışmanlık alın
• Eğitim amaçlıdır - Sorumluluk size aittir

🚀 5 Dakikada Başla (Remote MCP)

✅ Kurulum Gerektirmez! Hemen Kullan!

🔗 Remote MCP Adresi: https://borsamcp.fastmcp.app/mcp

Claude Desktop ile Kullanım (Ücretli abonelik gerekir)

1. Claude Desktop'ı açın
2. Settings → Connectors → Add Custom Connector
3. Bilgileri girin:
   • Name: Borsa MCP
   • URL: https://borsamcp.fastmcp.app/mcp
4. Add butonuna tıklayın
5. Hemen kullanmaya başlayın! 🎉

Google Antigravity ile Kullanım

1. Agent session açın ve editörün yan panelindeki "…" dropdown menüsüne tıklayın
2. MCP Servers seçeneğini seçin - MCP Store açılacak
3. Üstteki Manage MCP Servers butonuna tıklayın
4. View raw config seçeneğine tıklayın
5. mcp_config.json dosyasına aşağıdaki yapılandırmayı ekleyin:

{
  "mcpServers": {
    "borsa-mcp": {
      "serverUrl": "https://borsamcp.fastmcp.app/mcp",
      "headers": {
        "Content-Type": "application/json"
      }
    }
  }
}

💡 İpucu: Remote MCP sayesinde Python, uv veya herhangi bir kurulum yapmadan doğrudan Google Antigravity üzerinden Türk finans piyasalarına erişebilirsiniz!

Örnek Sorular:

GARAN hissesinin son 1 aylık performansını analiz et
XU100 endeksinin bugünkü durumunu göster
Bitcoin'in TRY fiyatını kontrol et

🎯 Temel Özellikler

75 Araç ile Kapsamlı Finansal Analiz:

• 📈 BIST Hisseleri: 758 şirket, finansal tablolar, teknik analiz, analist raporları, KAP haberleri
• 🆕 BIST Hisse Tarayıcı: 15 hazır preset ve 50+ filtre kriteri ile BIST hisse tarama (high_dividend, low_pe, high_roe vb.)
• 🇺🇸 US Hisse Senetleri: S&P 500, Nasdaq, Dow Jones şirketleri, finansal tablolar, Buffett analizi, sektör karşılaştırması
• 🔍 US Stock Screener: 23 hazır preset ile ABD hisse, ETF ve yatırım fonu tarama (large_cap, growth_stocks, dividend_stocks vb.)
• 🆕 Tarih Aralığı: Belirli tarihler arası geçmiş veri sorgulaması (örn: "2024-01-01" - "2024-12-31")
• 🎯 Pivot Points: 3 direnç & 3 destek seviyesi hesaplama (klasik pivot formülü)
• 📊 BIST Endeksleri: XU100, XBANK, XK100 ve tüm endeksler için tam destek
• 💡 Değer Yatırımı: Warren Buffett analizi ve konsolide finansal sağlık araçları (ROE, ROIC, Altman Z-Score, 75-85% daha hızlı)
• 💰 TEFAS Fonları: 800+ fon, performans analizi, portföy dağılımı, karşılaştırma
• ₿ Kripto Paralar: BtcTurk (TRY) ve Coinbase (USD/EUR) ile Türk ve global piyasalar
• 💱 Döviz & Emtia: USD, EUR, altın, petrol ve 28+ varlık takibi (Doviz.com)
• 📅 Ekonomik Takvim: TR, US, EU ve 30+ ülke için makroekonomik veriler
• 📉 TCMB Enflasyon: TÜFE/ÜFE resmi enflasyon verileri ve hesaplama araçları
• ☪️ Katılım Finans: İslami finans uygunluk verileri
• ⚡ LLM Optimizasyonu: Hızlı işleme ve domain-spesifik araç seçimi
• 🚀 FastMCP 2.14: Response Caching (10 araç, 1 saat TTL) ve Background Tasks (5 uzun analiz aracı)

📑 İçindekiler

💻 Gelişmiş Kurulum (İsteğe Bağlı)

Not: Remote MCP kullanıyorsanız bu adımları atlayabilirsiniz!

5ire ve Diğer MCP İstemcileri için Local Kurulum

Bu bölüm, Borsa MCP'yi 5ire gibi diğer MCP istemcileriyle local olarak kullanmak isteyenler içindir.

• Python Kurulumu: Sisteminizde Python 3.11 veya üzeri kurulu olmalıdır. Kurulum sırasında "Add Python to PATH" (Python'ı PATH'e ekle) seçeneğini işaretlemeyi unutmayın. Buradan indirebilirsiniz.
• Git Kurulumu (Windows): Bilgisayarınıza git yazılımını indirip kurun. "Git for Windows/x64 Setup" seçeneğini indirmelisiniz.
• uv Kurulumu:
  • Windows Kullanıcıları (PowerShell): Bir CMD ekranı açın ve bu kodu çalıştırın: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  • Mac/Linux Kullanıcıları (Terminal): Bir Terminal ekranı açın ve bu kodu çalıştırın: curl -LsSf https://astral.sh/uv/install.sh | sh
• Microsoft Visual C++ Redistributable (Windows): Bazı Python paketlerinin doğru çalışması için gereklidir. Buradan indirip kurun.
• İşletim sisteminize uygun 5ire MCP istemcisini indirip kurun.
• 5ire'ı açın. Workspace -> Providers menüsünden kullanmak istediğiniz LLM servisinin API anahtarını girin.
• Tools menüsüne girin. +Local veya New yazan butona basın.
  • Tool Key: borsamcp
  • Name: Borsa MCP
  • Command:

    uvx --from git+https://github.com/saidsurucu/borsa-mcp borsa-mcp
    

  • Save butonuna basarak kaydedin.
• Şimdi Tools altında Borsa MCP'yi görüyor olmalısınız. Üstüne geldiğinizde sağda çıkan butona tıklayıp etkinleştirin (yeşil ışık yanmalı).
• Artık Borsa MCP ile konuşabilirsiniz.

Claude Desktop için Local Kurulum

Not: Remote MCP daha kolay bir seçenektir. Sadece local kurulum yapmak istiyorsanız bu adımları izleyin.

1. Ön Gereksinimler: Python, uv, (Windows için) Microsoft Visual C++ Redistributable'ın sisteminizde kurulu olduğundan emin olun. Detaylı bilgi için yukarıdaki "5ire için Kurulum" bölümündeki ilgili adımlara bakabilirsiniz.

2. Claude Desktop Settings -> Developer -> Edit Config.

3. Açılan claude_desktop_config.json dosyasına mcpServers altına ekleyin. UYARI: // ile başlayan yorum satırını silmelisiniz:

   {
     "mcpServers": {
       // ... (varsa diğer sunucularınız) ...
       "Borsa MCP": {
         "command": "uvx",
         "args": [
           "--from", "git+https://github.com/saidsurucu/borsa-mcp",
           "borsa-mcp"
         ]
       }
     }
   }
   

4. Claude Desktop'ı kapatıp yeniden başlatın.

🛠️ Kullanılabilir Araçlar (MCP Tools)

Bu FastMCP sunucusu LLM modelleri için aşağıdaki araçları sunar:

Temel Şirket & Finansal Veriler

• find_ticker_code: Güncel BIST şirketleri arasında ticker kodu arama.
• get_sirket_profili: Detaylı şirket profili.
• get_bilanco: Bilanço verileri (yıllık/çeyreklik).
• get_kar_zarar_tablosu: Kar-zarar tablosu (yıllık/çeyreklik).
• get_nakit_akisi_tablosu: Nakit akışı tablosu (yıllık/çeyreklik).
• get_finansal_veri: Geçmiş OHLCV verileri (hisse senetleri ve endeksler için). YENİ: Belirli tarih aralığı desteği (örn: start_date="2024-01-01", end_date="2024-12-31") veya dönem modu (1mo, 1y vb.).

Gelişmiş Analiz Araçları

• get_analist_tahminleri: Analist tavsiyeleri, fiyat hedefleri ve trendler.
• get_temettu_ve_aksiyonlar: Temettü geçmişi ve kurumsal işlemler.
• get_hizli_bilgi: Hızlı finansal metrikler (P/E, P/B, ROE vb.).
• get_kazanc_takvimi: Kazanç takvimi ve büyüme verileri.
• get_teknik_analiz: Kapsamlı teknik analiz ve göstergeler.
• get_pivot_points: Günlük pivot noktaları ile 3 direnç ve 3 destek seviyesi hesaplama.
• get_sektor_karsilastirmasi: Sektör analizi ve karşılaştırması.

KAP & Haberler

• get_kap_haberleri: Son KAP haberleri ve resmi şirket duyuruları.
• get_kap_haber_detayi: Detaylı KAP haber içeriği (Markdown formatında).

BIST Endeks Araçları

• get_endeks_kodu: Güncel BIST endeks listesinde endeks kodu arama.
• get_endeks_sirketleri: Belirli endeksteki şirketlerin listesi.

🆕 BIST Hisse Tarayıcı Araçları (Borsa İstanbul Tarama)

• screen_bist_stocks: BIST hisselerini filtrele - 15 hazır preset veya 50+ özel filtre kriteri ile kapsamlı tarama
• get_bist_screener_presets: Mevcut 15 preset listesi ve açıklamaları (high_dividend, low_pe, high_roe vb.)
• get_bist_screener_filters: Özel filtre alanları ve operatörlerin dokümantasyonu

Mevcut BIST Screener Presetleri:| Kategori | Presetler ||----------|-----------|| Piyasa Değeri | small_cap, mid_cap, large_cap || Değer Yatırımı | low_pe, high_roe, high_net_margin || Temettü | high_dividend || Momentum | high_upside, low_upside, high_return || Hacim | high_volume, low_volume || Yabancı | high_foreign_ownership || Analist | buy_recommendation, sell_recommendation |

50+ Filtre Kriteri (13 Kategori):| Kategori | Filtreler ||----------|-----------|| Değerleme (Güncel) | pe, pb, ev_ebitda, ev_sales || Değerleme (2025) | pe_2025, pb_2025, ev_ebitda_2025 || Değerleme (Tarihsel) | pe_hist_avg, pb_hist_avg || Kârlılık (Güncel) | roe, roa, net_margin, ebitda_margin || Kârlılık (2025) | roe_2025, roa_2025 || Temettü | dividend_yield, dividend_yield_2025, dividend_yield_5y_avg || Getiri (Göreceli) | return_1d, return_1w, return_1m, return_1y, return_ytd || Getiri (TL Bazlı) | return_1d_tl, return_1w_tl, return_1m_tl, return_1y_tl, return_ytd_tl || Piyasa | price, market_cap, market_cap_usd, float_ratio, float_market_cap, volume_3m, volume_12m || Yabancı | foreign_ratio, foreign_ratio_1w_change, foreign_ratio_1m_change || Analist | target_price, upside_potential || Endeks | bist30_weight, bist50_weight, bist100_weight || Sınıflandırma | sector, index, recommendation |

Katılım Finans

• get_katilim_finans_uygunluk: KAP Katılım finans uygunluk verileri ve katılım endeksi üyeliği.

Değer Yatırımı & Finansal Sağlık Araçları

Warren Buffett Değer Analizi:

• calculate_buffett_value_analysis: Tek çağrıda 4 Buffett metriği (Owner Earnings, OE Yield, DCF Fisher, Safety Margin) - Genel skor: STRONG_BUY/BUY/HOLD/AVOID

Finansal Sağlık Analizi (Konsolide):

• calculate_core_financial_health: 5 temel metrik tek çağrıda (ROE, ROIC, Borç Oranları, FCF Marjı, Kazanç Kalitesi) - Skor: STRONG/GOOD/AVERAGE/WEAK - 75-85% daha hızlı
• calculate_advanced_metrics: 2 gelişmiş metrik (Altman Z-Score iflas riski + Enflasyona göre düzeltilmiş reel büyüme) - Stabilite: SAFE/GREY/DISTRESS - 75-85% daha hızlı

Kapsamlı Analiz:

• calculate_comprehensive_analysis: 11 metrikte tam finansal sağlık değerlendirmesi (Likidite, Karlılık, Değerleme, Kompozit Skorlar)

US Hisse Senetleri Araçları (ABD Piyasası)

Temel US Araçları:

• search_us_stock: US şirket arama (S&P 500, Nasdaq, NYSE)
• get_us_company_profile: US şirket profili
• get_us_quick_info: US hızlı bilgi (P/E, P/B, ROE)
• get_us_stock_data: US geçmiş OHLCV verileri
• get_us_analyst_ratings: US analist tavsiyeleri
• get_us_dividends: US temettü geçmişi
• get_us_earnings: US kazanç takvimi
• get_us_technical_analysis: US teknik analiz
• get_us_pivot_points: US pivot noktaları

US Finansal Tablolar:

• get_us_balance_sheet: US bilanço (yıllık/çeyreklik)
• get_us_income_statement: US gelir tablosu
• get_us_cash_flow: US nakit akışı

US Finansal Analiz:

• calculate_us_buffett_analysis: US Buffett değer analizi (Owner Earnings, OE Yield, DCF, Safety Margin)
• calculate_us_core_health: US finansal sağlık (ROE, ROIC, Borç Oranları, FCF Marjı)
• calculate_us_advanced_metrics: US Altman Z-Score ve reel büyüme
• calculate_us_comprehensive: US kapsamlı analiz (11 metrik)

US Endeks Araçları:

• get_us_sector_comparison: GICS sektör karşılaştırması
• get_us_index_search: 28 US endeksi arama (S&P 500, Nasdaq-100, Dow Jones, Russell vb.)
• get_us_index_info: US endeks detayları ve performans verileri

🆕 US Stock Screener Araçları (ABD Hisse Tarama):

• screen_us_securities: ABD hisse, ETF ve yatırım fonu tarama - 23 hazır preset veya özel filtreler ile kapsamlı tarama
• get_us_screener_presets: Mevcut 23 preset listesi ve açıklamaları (large_cap, growth_stocks, dividend_stocks, tech_sector vb.)
• get_us_screener_filters: Özel filtre alanları ve operatörlerin dokümantasyonu

Mevcut Screener Presetleri:| Kategori | Presetler ||----------|-----------|| Değer Yatırımı | value_stocks, low_pe, undervalued || Büyüme | growth_stocks, momentum || Temettü | dividend_stocks, high_dividend_yield || Piyasa Değeri | large_cap, mid_cap, small_cap, blue_chip || Sektörler | tech_sector, healthcare_sector, financial_sector, energy_sector || Performans | top_gainers, top_losers, high_volume || ETF'ler | large_etfs, top_performing_etfs, low_expense_etfs || Yatırım Fonları | large_mutual_funds, top_performing_funds |

Akıllı Filtre Özellikleri:

• 🔄 Otomatik Alan Dönüşümü: ETF/yatırım fonu taramalarında equity alanları otomatik dönüştürülür (intradaymarketcap → fundnetassets, sector → primary_sector)
• 🇺🇸 Otomatik Region Filtresi: Custom filter kullanırken region=us otomatik eklenir

TEFAS Fon Araçları

• search_funds: Türk yatırım fonları arama (kategori filtreleme ve performans metrikleri ile).
• get_fund_detail: Kapsamlı fon bilgileri ve analitiği.
• get_fund_performance: Resmi TEFAS BindHistoryInfo API ile geçmiş fon performansı.
• get_fund_portfolio: Resmi TEFAS BindHistoryAllocation API ile fon portföy dağılımı.
• compare_funds: Resmi TEFAS karşılaştırma API ile çoklu fon karşılaştırması.

Fon Mevzuat Araçları

• get_fon_mevzuati: Türk yatırım fonları mevzuat rehberi (hukuki uyumluluk için).

BtcTurk Kripto Para Araçları (Türk Piyasası)

• get_kripto_exchange_info: Tüm kripto çiftleri, para birimleri ve borsa operasyonel durumu.
• get_kripto_ticker: Kripto çiftler için gerçek zamanlı fiyat verileri (çift veya kote para birimi filtresi ile).
• get_kripto_orderbook: Güncel alış/satış emirlerini içeren emir defteri derinliği.
• get_kripto_trades: Piyasa analizi için son işlem geçmişi.
• get_kripto_ohlc: Kripto grafikleri ve teknik analiz için OHLC verileri.
• get_kripto_kline: Çoklu zaman çözünürlükleri ile Kline (mum grafik) verileri.
• get_kripto_teknik_analiz: Türk kripto piyasaları için RSI, MACD, Bollinger Bantları ve al-sat sinyalleri ile kapsamlı teknik analiz.

Coinbase Global Kripto Para Araçları (Uluslararası Piyasalar)

• get_coinbase_exchange_info: Global işlem çiftleri ve para birimleri (USD/EUR piyasaları ile).
• get_coinbase_ticker: Uluslararası piyasalar için gerçek zamanlı global kripto fiyatları (USD/EUR).
• get_coinbase_orderbook: USD/EUR alış/satış fiyatları ile global emir defteri derinliği.
• get_coinbase_trades: Çapraz piyasa analizi için son global işlem geçmişi.
• get_coinbase_ohlc: USD/EUR kripto grafikleri için global OHLC verileri.
• get_coinbase_server_time: Coinbase sunucu zamanı ve API durumu.
• get_coinbase_teknik_analiz: Global kripto piyasaları için RSI, MACD, Bollinger Bantları ve al-sat sinyalleri ile kapsamlı teknik analiz.

Dovizcom Döviz & Emtia Araçları (Türk & Uluslararası Piyasalar)

• get_dovizcom_guncel: Güncel döviz kurları ve emtia fiyatları (USD, EUR, GBP, gram-altın, ons, BRENT, dizel, benzin, LPG).
• get_dovizcom_dakikalik: Gerçek zamanlı izleme için dakikalık veriler (60 veri noktasına kadar).
• get_dovizcom_arsiv: Teknik analiz ve trend araştırması için tarihsel OHLC verileri.

Dovizcom Ekonomik Takvim Araçları

• get_economic_calendar: Çoklu ülke ekonomik takvimi (TR,US varsayılan) - GDP, enflasyon, istihdam verileri ve makroekonomik olaylar.

TCMB Enflasyon Araçları

• get_turkiye_enflasyon: Resmi TCMB TÜFE/ÜFE enflasyon verileri - TÜFE: tüketici fiyatları (2005-2025, 245+ kayıt), ÜFE: üretici fiyatları (2014-2025, 137+ kayıt) - yıllık/aylık oranlar, tarih aralığı filtreleme, istatistiksel özet.
• get_enflasyon_hesapla: TCMB resmi enflasyon hesaplama API'si - iki tarih arası kümülatif enflasyon hesaplama, sepet değeri analizi, satın alma gücü kaybı/kazancı, ortalama yıllık enflasyon, TÜFE endeks değerleri.

🔍 Veri Kaynakları & Kapsam

KAP (Kamuyu Aydınlatma Platformu)

• Şirketler: 758 BIST şirketi (ticker kodları, adlar, şehirler, çoklu ticker desteği)
• Katılım Finans: Resmi katılım finans uygunluk değerlendirmeleri
• Güncelleme: Otomatik önbellek ve yenileme

Yahoo Finance Entegrasyonu

• Endeks Desteği: Tüm BIST endeksleri (XU100, XBANK, XK100 vb.) için tam destek
• Zaman Dilimi: Tüm zaman damgaları Avrupa/İstanbul'a çevrilir
• Veri Kalitesi: Büyük bankalar ve teknoloji şirketleri en iyi kapsama sahiptir
• Tarih Aralığı Desteği: Belirli tarihler arası sorgulama (YYYY-MM-DD formatında, örn: "2024-01-01" - "2024-12-31")
• İki Sorgu Modu:
  • Dönem Modu: Period parametresi ile (1d, 1mo, 1y, vb.) - varsayılan
  • Tarih Modu: start_date ve end_date parametreleri ile belirli tarih aralığı

US Stock Market (Yahoo Finance)

• Kapsam: S&P 500, Nasdaq-100, Dow Jones ve NYSE'deki tüm şirketler
• Endeksler: 28 ana US endeksi (^GSPC, ^IXIC, ^DJI, Russell, sektör ETF'leri)
• Kategoriler: Large Cap, Tech, Blue Chip, Small Cap, Mid Cap, International
• Finansal Tablolar: Quarterly ve annual balance sheet, income statement, cash flow
• Değer Analizi: Buffett analizi için US 10Y Treasury (^TNX) ve Fed %2.5 enflasyon hedefi
• Güncelleme: Gerçek zamanlı piyasa verileri

US Stock Screener (yfscreen paketi)

• Varlık Türleri: Hisse senedi (equity), ETF ve yatırım fonları (mutual funds)
• Preset Sayısı: 23 hazır tarama şablonu (18 hisse + 3 ETF + 2 yatırım fonu)
• Filtre Alanları: 96+ hisse senedi, 29 ETF, 28 yatırım fonu filtre alanı
• Operatörler: eq (eşit), gt (büyük), lt (küçük), btwn (arasında)
• Özel Filtreler: Kullanıcı tanımlı filtreler ile gelişmiş tarama
• Akıllı Alan Dönüşümü: ETF/fund taramalarında equity alanları otomatik dönüştürülür
• Otomatik Region: Custom filter kullanırken region=us otomatik eklenir
• Sayfalama: Offset/limit ile büyük sonuç setlerinde navigasyon
• Performans: Yahoo Finance screener API entegrasyonu, hızlı sonuçlar

BIST Hisse Tarayıcı (borsapy paketi)

• Veri Kaynağı: İş Yatırım gelişmiş hisse arama (borsapy kütüphanesi)
• Preset Sayısı: 15 hazır tarama şablonu (piyasa değeri, değer, temettü, momentum, hacim, yabancı, analist)
• Filtre Kriteri: 50+ filtre (13 kategori: değerleme, kârlılık, temettü, getiri, piyasa, yabancı, analist, endeks)
• Operatörler: min (minimum), max (maximum) ile aralık filtreleme
• Özel Filtreler: Kullanıcı tanımlı filtreler ile gelişmiş tarama
• Otomatik Birim Dönüşümü: Piyasa değeri ve hacim için TL → milyon TL otomatik dönüşüm
• Sayfalama: Offset/limit ile büyük sonuç setlerinde navigasyon
• Performans: İş Yatırım API entegrasyonu, hızlı sonuçlar
• Güncelleme: Gerçek zamanlı BIST verileri

Mynet Finans (Hibrit Mod)

• Türk Özel Verileri: Kurumsal yönetim, ortaklık yapısı, bağlı şirketler
• KAP Haberleri: Gerçek zamanlı resmi duyuru akışı
• Endeks Kompozisyonu: Canlı endeks şirket listeleri

TEFAS (Türkiye Elektronik Fon Alım Satım Platformu)

• Fon Evreni: 800+ Türk yatırım fonu
• Resmi API: TEFAS BindHistoryInfo ve BindHistoryAllocation API'leri
• Kategori Filtreleme: 13 fon kategorisi (borçlanma, hisse senedi, altın vb.)
• Performans Metrikleri: 7 dönemlik getiri analizi (1 günlük - 3 yıllık)
• Portföy Analizi: 50+ Türk varlık kategorisi ile detaylı dağılım
• Güncellik: Gerçek zamanlı fon fiyatları ve performans verileri

Fon Mevzuatı

• Kaynak: fon_mevzuat_kisa.md - 80,820 karakter düzenleme metni
• Kapsam: Yatırım fonları için kapsamlı Türk mevzuatı
• İçerik: Portföy limitleri, fon türleri, uyumluluk kuralları
• Güncelleme: Dosya metadata ile son güncelleme tarihi

BtcTurk Kripto Para Borsası (Türk Piyasası)

• İşlem Çiftleri: 295+ kripto para işlem çifti (ana TRY ve USDT piyasaları dahil)
• Para Birimleri: 158+ desteklenen kripto para ve fiat para birimi (BTC, ETH, TRY, USDT vb.)
• API Endpoint: Resmi BtcTurk Public API v2 (https://api.btcturk.com/api/v2)
• Piyasa Verileri: Gerçek zamanlı ticker fiyatları, emir defterleri, işlem geçmişi, OHLC/Kline grafikleri
• Türk Odak: TRY çiftleri için optimize edilmiş (BTCTRY, ETHTRY, ADATRY vb.)
• Güncelleme Sıklığı: Borsa bilgileri için 1 dakika önbellek ile gerçek zamanlı piyasa verileri
• Veri Kalitesi: Milisaniye hassasiyetli zaman damgaları ile profesyonel seviye borsa verileri

Coinbase Global Kripto Para Borsası (Uluslararası Piyasalar)

• İşlem Çiftleri: 500+ global kripto para işlem çifti (ana USD, EUR ve GBP piyasaları dahil)
• Para Birimleri: 200+ desteklenen kripto para ve fiat para birimi (BTC, ETH, USD, EUR, GBP vb.)
• API Endpoint: Resmi Coinbase Advanced Trade API v3 ve App API v2 (https://api.coinbase.com)
• Piyasa Verileri: Gerçek zamanlı ticker fiyatları, emir defterleri, işlem geçmişi, OHLC/mum grafikleri, sunucu zamanı
• Global Odak: Uluslararası piyasalar için USD/EUR çiftleri (BTC-USD, ETH-EUR vb.)
• Güncelleme Sıklığı: Borsa bilgileri için 5 dakika önbellek ile gerçek zamanlı piyasa verileri
• Veri Kalitesi: Coinbase (NASDAQ: COIN) kurumsal seviye global likidite ile işletme düzeyinde borsa verileri
• Kapsam: Tam global piyasa kapsama, kurumsal seviye işlem verileri, çapraz piyasa arbitraj fırsatları
• Çapraz Piyasa Analizi: Türk kripto piyasaları (BtcTurk TRY çiftleri) ile global piyasaları (Coinbase USD/EUR çiftleri) karşılaştırma

Dovizcom Döviz & Emtia Platformu (Türk & Uluslararası Piyasalar)

• Varlık Kapsamı: 28+ varlık (ana para birimleri, kıymetli madenler, enerji emtiaları, yakıt fiyatları)
• Ana Para Birimleri: USD, EUR, GBP, JPY, CHF, CAD, AUD ile gerçek zamanlı TRY döviz kurları
• Kıymetli Madenler: Hem Türk (gram-altın, gümüş) hem uluslararası (ons, XAG-USD, XPT-USD, XPD-USD) çifte fiyatlandırma
• Enerji Emtiaları: BRENT ve WTI petrol fiyatları ile tarihsel trendler ve piyasa analizi
• Yakıt Fiyatları: Dizel, benzin ve LPG fiyatları (TRY bazlı) ile günlük fiyat takibi
• API Endpoint: Resmi doviz.com API v12 (https://api.doviz.com/api/v12)
• Gerçek Zamanlı Veri: Kısa vadeli analiz için 60 veri noktasına kadar dakikalık güncellemeler
• Tarihsel Veri: Teknik analiz ve trend araştırması için özel tarih aralıklarında günlük OHLC verileri
• Güncelleme Sıklığı: Güncel kurlar için 1 dakika önbellek ile gerçek zamanlı piyasa verileri
• Veri Kalitesi: Türkiye'nin önde gelen finansal bilgi sağlayıcısından profesyonel seviye finansal veriler
• Piyasa Odağı: Çapraz piyasa analizi için uluslararası USD/EUR karşılaştırmaları ile Türk TRY bazlı fiyatlandırma
• Kimlik Doğrulama: Güvenilir API erişimi için uygun başlık yönetimi ile Bearer token kimlik doğrulaması
• Kapsam: Döviz ticareti, kıymetli maden yatırımı, emtia analizi ve yakıt fiyat takibi için tam finansal piyasalar kapsamı

Dovizcom Ekonomik Takvim (Çoklu Ülke Desteği)

• Makroekonomik Olaylar: GDP, enflasyon, istihdam, sanayi üretimi, PMI, işsizlik oranları ve diğer piyasa etkili ekonomik göstergeler
• Ülke Kapsamı: 30+ ülke (TR, US, EU, GB, JP, DE, FR, CA, AU, CN, KR, BR vb.) için ekonomik veri takibi
• Çoklu Ülke Filtreleme: Virgülle ayrılmış ülke kodları ile esnek filtreleme (örn: "TR,US,DE")
• Varsayılan Davranış: Türkiye ve ABD ekonomik olayları (TR,US) varsayılan olarak gösterilir
• API Endpoint: Resmi Doviz.com Economic Calendar API (https://www.doviz.com/calendar/getCalendarEvents)
• Filtreleme Özellikleri: Ülke bazlı filtreleme, önem seviyesi seçimi (yüksek/orta/düşük), özelleştirilebilir tarih aralıkları
• Veri Detayları: Gerçek değerler, önceki dönem verileri, tahminler (mevcut olduğunda), dönem bilgileri Türkçe açıklamalar
• Güncelleme Sıklığı: Gerçek zamanlı ekonomik olay takibi ve uluslararası piyasa etkisi analizi
• Zaman Dilimi Desteği: Avrupa/İstanbul ana zaman dilimi ile Türk saati koordinasyonu
• Veri Kalitesi: Doviz.com'un özelleşmiş finansal veri ağından profesyonel seviye uluslararası makroekonomik bilgiler

TCMB Enflasyon Verileri (Resmi Merkez Bankası)

• Veri Kaynağı: Türkiye Cumhuriyet Merkez Bankası resmi enflasyon istatistikleri sayfaları
• Veri Türleri:
  • TÜFE: Tüketici Fiyat Endeksi (2005-2025, 245+ aylık kayıt)
  • ÜFE: Üretici Fiyat Endeksi - Yurt İçi (2014-2025, 137+ aylık kayıt)
• Güncelleme Sıklığı: Aylık (genellikle ayın ortasında resmi açıklama)
• Veri Kalitesi: Resmi TCMB kaynağından web scraping ile %100 güvenilir
• Performans: 2-3 saniye (1 saatlik cache ile optimize edilmiş)
• Filtreleme: Enflasyon türü seçimi, tarih aralığı (YYYY-MM-DD), kayıt sayısı limiti
• İstatistikler: Min/max oranlar, ortalamalar, son değerler otomatik hesaplama
• Son Veriler (Mayıs 2025):
  • TÜFE: %35.41 (yıllık), %1.53 (aylık)
  • ÜFE: %23.13 (yıllık), %2.48 (aylık)
• Ekonomik Analiz: ÜFE öncü gösterge olarak TÜFE hareketlerini öngörmede kullanılır

📊 Örnek Kullanım

# Şirket arama
GARAN hissesi için detaylı analiz yap

# Endeks analizi
XU100 endeksinin son 1 aylık performansını analiz et

# Tarih aralığı ile hisse analizi (YENİ!)
GARAN hissesinin 2024 yıl başından bugüne performansını analiz et

# Belirli dönem karşılaştırması (YENİ!)
THYAO'nun 2023 ve 2024 yıllarının ilk çeyreklerini karşılaştır

# Teknik analiz
ASELS için kapsamlı teknik analiz ve al-sat sinyalleri ver

# KAP haberleri
THYAO için son 5 KAP haberini getir ve ilkinin detayını analiz et

# Katılım finans
ARCLK'nın katılım finans uygunluğunu kontrol et

# Sektör karşılaştırması
Bankacılık sektöründeki ana oyuncuları karşılaştır: GARAN, AKBNK, YKBNK

# US hisse analizi
Apple (AAPL) hissesinin son 3 aylık performansını analiz et

# US finansal tablolar
Microsoft'un son yıllık bilançosunu getir

# US Buffett değer analizi
Amazon için Buffett değer analizi yap

# US endeks arama
Teknoloji sektörü endekslerini ara

# US sektör karşılaştırması
AAPL, MSFT, GOOGL şirketlerini sektör bazında karşılaştır

# US finansal sağlık analizi
Tesla için kapsamlı finansal sağlık analizi yap

# US hisse tarama (screener)
Büyük piyasa değerli (large cap) ABD hisselerini listele

# US değer hisseleri tarama
Düşük F/K oranına sahip (P/E < 15) değer hisselerini bul

# US yüksek temettü hisseleri
%5'ten fazla temettü veren ABD hisselerini ara

# US sektör bazlı tarama
Teknoloji sektöründeki büyük cap hisseleri listele

# US ETF tarama
10 milyar dolardan fazla AUM'a sahip büyük ETF'leri göster

# US özel filtre taraması
Piyasa değeri 100 milyar dolar üstü ve ROE > %20 olan hisseleri bul

# BIST hisse tarama (screener) - YENİ!
Yüksek temettü veren BIST hisselerini listele

# BIST düşük F/K tarama
F/K oranı 10'dan düşük BIST hisselerini bul

# BIST yüksek ROE tarama
ROE oranı %15'ten yüksek şirketleri ara

# BIST yabancı favorileri
Yabancı yatırımcı oranı %40'tan fazla olan hisseleri göster

# BIST momentum tarama
Yükseliş potansiyeli %20'den fazla olan hisseleri listele

# BIST özel filtre taraması
Piyasa değeri 10 milyar TL üstü ve temettü verimi %3'ten fazla olan hisseleri bul

# BIST analist tavsiyeleri
AL önerisi alan BIST hisselerini listele

# Fon arama ve analizi
"altın" fonları ara ve en iyi performans gösteren 3 tanesini karşılaştır

# Fon portföy analizi
AAK fonunun son 6 aylık portföy dağılım değişimini analiz et

# Fon mevzuat sorguları
Yatırım fonlarında türev araç kullanım limitleri nelerdir?

# Türk kripto para analizi
Bitcoin'in TRY cinsinden son 1 aylık fiyat hareketlerini analiz et

# Türk kripto piyasa takibi
BtcTurk'te en çok işlem gören kripto çiftleri listele ve fiyat değişimlerini göster

# Türk kripto emir defteri analizi
BTCTRY çiftinin emir defterini görüntüle ve derinlik analizini yap

# Global kripto para analizi
Bitcoin'in USD cinsinden Coinbase'deki son 1 aylık fiyat hareketlerini analiz et

# Global kripto piyasa takibi
Coinbase'de en popüler USD/EUR kripto çiftlerini listele ve global piyasa trendlerini göster

# Global kripto emir defteri analizi
BTC-USD çiftinin Coinbase emir defterini görüntüle ve global likidite analizini yap

# Çapraz piyasa kripto analizi
Bitcoin fiyatını Türk (BTCTRY) ve global (BTC-USD) piyasalarda karşılaştır

# Arbitraj fırsatı analizi
ETH fiyatlarını BtcTurk (ETHUSDT) ve Coinbase (ETH-USD) arasında karşılaştırarak arbitraj fırsatlarını tespit et

# BtcTurk kripto teknik analiz
BTCTRY çiftinin günlük teknik analizini yap ve al-sat sinyallerini değerlendir

# Coinbase global kripto teknik analiz  
BTC-USD çiftinin 4 saatlik teknik analizini yap ve RSI, MACD durumunu analiz et

# Çapraz piyasa teknik analiz karşılaştırması
Bitcoin'in hem Türk piyasasında (BTCTRY) hem global piyasada (BTC-USD) teknik analiz sinyallerini karşılaştır

# Global kripto teknik analiz
ETH-EUR çiftinin günlük Bollinger Bantları ve hareketli ortalama durumunu analiz et

# Döviz kuru analizi
USD/TRY kurunun güncel durumunu ve son 1 saatteki dakikalık hareketlerini analiz et

# Altın fiyat takibi
Gram altının TRY cinsinden güncel fiyatını al ve son 30 dakikadaki değişimini göster

# Uluslararası altın karşılaştırması
Türk gram altını ile uluslararası ons altın fiyatlarını karşılaştır

# Emtia fiyat analizi
Brent petrolün son 6 aylık OHLC verilerini al ve fiyat trendini analiz et

# Kıymetli maden portföy takibi
Altın, gümüş ve platinyum fiyatlarının güncel durumunu ve haftalık performansını karşılaştır

# Çapraz döviz analizi
EUR/TRY ve GBP/TRY kurlarının güncel durumunu karşılaştır ve arbitraj fırsatlarını değerlendir

# Yakıt fiyat takibi
Dizel, benzin ve LPG fiyatlarının güncel durumunu ve haftalık değişimlerini analiz et

# Yakıt fiyat karşılaştırması
Son 3 aylık dizel ve benzin fiyat trendlerini karşılaştır ve analiz et

# Haftalık ekonomik takvim (çoklu ülke)
Bu haftanın önemli ekonomik olaylarını TR,US,DE için listele ve piyasa etkilerini değerlendir

# Tek ülke ekonomik takip
Sadece Almanya'nın bu ayki ekonomik verilerini getir ve analiz et

# Çoklu ülke ekonomik karşılaştırma
TR,US,GB,FR,DE ülkelerinin bu haftaki tüm ekonomik verilerini karşılaştır

# Ekonomik veri analizi
Türkiye ve ABD'nin son çeyrek GDP büyüme verilerini karşılaştır ve trend analizini yap

# TCMB TÜFE enflasyon analizi
Son 2 yılın tüketici enflasyon verilerini getir ve trend analizini yap

# TCMB ÜFE enflasyon analizi  
Üretici enflasyonunun son 1 yılını analiz et ve TÜFE ile karşılaştır

# Enflasyon dönemsel analizi
2022-2024 yüksek enflasyon dönemini hem TÜFE hem ÜFE açısından analiz et

# TÜFE vs ÜFE karşılaştırması
Son 12 aylık TÜFE ve ÜFE verilerini karşılaştır ve fiyat geçişkenliğini analiz et

# Güncel enflasyon durumu
Son 6 aylık hem tüketici hem üretici enflasyon verilerini al ve Merkez Bankası hedefleriyle karşılaştır

# TCMB enflasyon hesaplayıcı analizi
2020'deki 100 TL'nin bugünkü satın alma gücünü hesapla

# Yüksek enflasyon dönemi analizi
2021-2024 yüksek enflasyon döneminde 1000 TL'nin değişimini hesapla ve kümülatif enflasyon etkisini analiz et

# Uzun dönemli satın alma gücü analizi
2010'dan bugüne 5000 TL'lik maaşın satın alma gücündeki değişimi hesapla

# Kısa dönemli enflasyon hesaplaması
Son 6 aylık enflasyon etkisini hesapla ve yıllık bazda projeksiyon yap

# Ekonomik kriz dönemleri karşılaştırması
2001, 2008 ve 2018 ekonomik krizlerinin enflasyon etkilerini karşılaştır

# Kontrat endeksleme hesaplaması
Kira sözleşmelerinin enflasyon ayarlaması için gerekli artış oranını hesapla

📜 Lisans

Bu proje MIT Lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakınız.