Kullanım kılavuzu: Excel ve JSON
Her satırda aynı verinin üç biçimi var: Excel hücresi (yalnız sayı döner; formülü kopyalayın), CSV (Excel'de Veri → Web'den ile tablo), JSON (yazılımlar). Tarihler YYYY-AA-GG. Veri yoksa boş cevap ve 404 döner, sessizce sıfır dönmez.
Döviz kurları (TCMB, herkese açık)
| Ne | Excel hücresi | CSV | JSON |
|---|---|---|---|
| Bugünkü dolar kuru Son yayınlanan bülten (TCMB 15:30 sonrası günün bülteni). kod=EUR, GBP... tur=satis / efektif_alis / efektif_satis. | =SAYIYAÇEVİR(WEBHİZMETİ("https://otomasyon.kapitalfinans.com/api/kur/gun.txt?kod=USD")) | https://otomasyon.kapitalfinans.com/api/kur.csv | https://otomasyon.kapitalfinans.com/api/kur |
| Belirli günün kuru O gün bülten yoksa (hafta sonu, tatil) önceki son bülten. Birime bölünmüş değer (JPY gibi 100 birimlikler 1 birim için). | =SAYIYAÇEVİR(WEBHİZMETİ("https://otomasyon.kapitalfinans.com/api/kur/gun.txt?kod=USD&tarih=2026-09-25")) | https://otomasyon.kapitalfinans.com/api/kur.csv?tarih=2026-09-25 | https://otomasyon.kapitalfinans.com/api/kur?tarih=2026-09-25 |
| Aylık ortalama Bülten günlerinin aritmetik ortalaması. CSV/JSON'da kod verilmezse tüm dövizler. ondalik=2 ile hane. | =SAYIYAÇEVİR(WEBHİZMETİ("https://otomasyon.kapitalfinans.com/api/kur/ortalama.txt?kod=USD&yil=2026&ay=9")) | https://otomasyon.kapitalfinans.com/api/kur/ortalama.csv?yil=2026&ay=9 | https://otomasyon.kapitalfinans.com/api/kur/ortalama?kod=USD&yil=2026&ay=9 |
| Yıllık ortalama CSV/JSON yılın tüm aylarını ve yıllık satırı verir. | =SAYIYAÇEVİR(WEBHİZMETİ("https://otomasyon.kapitalfinans.com/api/kur/ortalama.txt?kod=USD&yil=2025")) | https://otomasyon.kapitalfinans.com/api/kur/ortalama.csv?kod=USD&yil=2025 | https://otomasyon.kapitalfinans.com/api/kur/ortalama?kod=USD&yil=2025 |
| Yıllar tablosu (2015'ten bugüne) Her yıl için ortalama, en düşük, en yüksek ve yıl sonu kuru. | tek sayı yok | https://otomasyon.kapitalfinans.com/api/kur/yillik.csv?kod=USD&bas=2015 | https://otomasyon.kapitalfinans.com/api/kur/yillik?kod=USD&bas=2015 |
| Dönem ortalaması (istediğiniz aralık) Örnek: yılbaşından bugüne. CSV/JSON günlük seriyi verir. | =SAYIYAÇEVİR(WEBHİZMETİ("https://otomasyon.kapitalfinans.com/api/kur/donem.txt?kod=USD&bas=2026-01-01&bit=2026-10-25")) | https://otomasyon.kapitalfinans.com/api/kur/seri.csv?kod=USD&bas=2026-01-01&bit=2026-10-25 | https://otomasyon.kapitalfinans.com/api/kur/seri?kod=USD&bas=2026-01-01&bit=2026-10-25 |
| Çapraz kur (EUR/USD gibi) kod1 / kod2, TCMB alış üzerinden. tur=satis olabilir. TRY yazılabilir. | =SAYIYAÇEVİR(WEBHİZMETİ("https://otomasyon.kapitalfinans.com/api/kur/capraz.txt?kod1=EUR&kod2=USD&tarih=2026-09-25")) | - | - |
| Tutar çevirimi Alış ve satışla TL karşılığı. | tek sayı yok | - | https://otomasyon.kapitalfinans.com/api/kur/cevir?tutar=1000&kod=EUR&tarih=2026-09-25 |
| Döviz kodları listesi Hangi kodlar var, ilk ve son tarih. | tek sayı yok | - | https://otomasyon.kapitalfinans.com/api/kur/kodlar |
Borsa (BIST, iç kullanım, anahtar gerekir)
BIST verisi lisans gereği herkese açılmaz. Adreslerin sonuna &anahtar=ANAHTAR ekleyin (anahtar sistem yöneticisinden). Kaynak Yahoo Finance, gecikmeli günlük kapanış. Piyasalar: BIST (615 hisse, 29 endeks), ABD (S&P 500 + S&P 100; endeksler SPX, OEX, DJI, IXIC), İngiltere (FTSE 100; sembol örneği HSBA.L), Japonya (Nikkei 225; sembol örneği 7203.T). Listelerde piyasa=ABD|ING|JPN|BIST süzgeci.
| Ne | Excel hücresi | CSV | JSON |
|---|---|---|---|
Son kapanış (hisse veya endeks)tarih= ile geçmiş gün. Endeksler: XU100, XU030, XUSIN, XBANK, SPX, DJI, IXIC, N225, FTSE. Yabancı hisse: AAPL, HSBA.L, 7203.T. JSON önceki kapanış ve yüzde değişimi de verir. | =SAYIYAÇEVİR(WEBHİZMETİ("https://otomasyon.kapitalfinans.com/api/borsa/son.txt?sembol=THYAO&anahtar=ANAHTAR")) | - | https://otomasyon.kapitalfinans.com/api/borsa/son?sembol=THYAO&anahtar=ANAHTAR |
| Dönem getirisi (%) Başlangıç ve bitiş kapanışları arasındaki yüzde değişim (temettü düzeltmesi yok). | =SAYIYAÇEVİR(WEBHİZMETİ("https://otomasyon.kapitalfinans.com/api/borsa/getiri.txt?sembol=XU100&bas=2026-01-01&bit=2026-10-25&anahtar=ANAHTAR")) | - | - |
| Günlük seri (açılış, yüksek, düşük, kapanış, hacim) En fazla 10 yıl geriye (geçmiş çekimi tamamlandıkça). | tek sayı yok | https://otomasyon.kapitalfinans.com/api/borsa/seri.csv?sembol=THYAO&bas=2026-01-01&bit=2026-10-25&anahtar=ANAHTAR | https://otomasyon.kapitalfinans.com/api/borsa/seri?sembol=THYAO&bas=2026-01-01&bit=2026-10-25&anahtar=ANAHTAR |
| Aylık özet (ortalama, en düşük, en yüksek, ay sonu, hacim) | tek sayı yok | https://otomasyon.kapitalfinans.com/api/borsa/aylik.csv?sembol=XU100&yil=2026&anahtar=ANAHTAR | https://otomasyon.kapitalfinans.com/api/borsa/aylik?sembol=XU100&yil=2026&anahtar=ANAHTAR |
| Hisse listesi ve sektörler Sembol, ad, sektör, piyasa, öncelik, son veri tarihi. piyasa=ABD gibi süzgeç. | tek sayı yok | https://otomasyon.kapitalfinans.com/api/borsa/hisseler.csv?anahtar=ANAHTAR | https://otomasyon.kapitalfinans.com/api/borsa/hisseler?anahtar=ANAHTAR |
| Sektör listesi Sektör adı, hisse sayısı, semboller. | tek sayı yok | - | https://otomasyon.kapitalfinans.com/api/borsa/sektorler?anahtar=ANAHTAR |
Bir sektörün hisseleri ve son kapanışlarıtarih= ile geçmiş gün. | tek sayı yok | - | https://otomasyon.kapitalfinans.com/api/borsa/sektor?ad=Bankacılık&anahtar=ANAHTAR |
| Endeks listesi ve son kapanışlar | tek sayı yok | - | https://otomasyon.kapitalfinans.com/api/borsa/endeksler?anahtar=ANAHTAR |
Excel'de kullanım
- Tek hücre: yukarıdaki formülü hücreye yapıştırın (Windows masaüstü Excel; web ve Mac sürümlerinde WEBHİZMETİ yoktur). İngilizce Excel:
=VALUE(WEBSERVICE("...")). Ondalık ayracı sorun çıkarırsa adrese&ayrac=virgulekleyip=WEBHİZMETİ("...")*1kullanın. - Tablo: Veri → Veri Al → Web'den, CSV adresini yapıştırın. Sütunlar ayrılmadıysa Verileri Dönüştür → Sütunları Böl → Sınırlayıcıya göre → Noktalı virgül. Kapat ve Yükle; sonra Veri → Tümünü Yenile.
- Hücre değerine bağlı adres:
=SAYIYAÇEVİR(WEBHİZMETİ("https://otomasyon.kapitalfinans.com/api/kur/gun.txt?kod="&A1&"&tarih="&METNEÇEVİR(B1;"yyyy-aa-gg")))gibi birleştirin.
Sistem
| Ne | Adres |
|---|---|
| Sağlık | https://otomasyon.kapitalfinans.com/saglik |
| Görev durumu (anahtar) | https://otomasyon.kapitalfinans.com/gorev/durum?anahtar=ANAHTAR |
| Görev tetikleme (anahtar, POST) | https://otomasyon.kapitalfinans.com/gorev/kur_gunluk, kur_gecmis, borsa_gunluk, borsa_gecmis, hisse_listesi, yabanci_liste |
Zamanlama (Türkiye saati): kurlar her gün 15:45 ve 17:15; borsa kapanışları 19:15 (BIST, Avrupa) ve 02:30 (ABD, Japonya); hisse listeleri pazartesi 06:30 ve 06:45. Her çekim günlüğe yazılır (özet sayfası).