Türkiye odaklı finans, muhasebe veya raporlama ürünü geliştiriyorsanız TCMB verisi çoğu zaman ilk bakılacak kaynaklardan biridir. Fakat TCMB tarafında iki farklı kullanım ihtiyacı vardır: günlük kur bülteni okumak ve geniş ekonomik zaman serileriyle çalışmak.
Bu yazıda API Deposu'ndaki TCMB EVDS ve TCMB Günlük Kurlar XML kayıtlarını birlikte ele alıyoruz. Amaç hangi üründe hangi kaynağın daha sade, daha sürdürülebilir veya daha kapsamlı olduğunu netleştirmek.
Hızlı karar tablosu
| İhtiyaç | Önerilen kaynak | Neden |
|---|---|---|
| Bugünün döviz kurunu göstermek | TCMB Günlük Kurlar XML | Basit ve anahtarsız okuma |
| Tarihli kur arşivi okumak | TCMB Günlük Kurlar XML | Tarihli XML dosyalarıyla çalışır |
| Ekonomik seri analizi yapmak | TCMB EVDS | Geniş zaman serisi kapsamı |
| Grafik, rapor ve veri keşfi | TCMB EVDS | Kategori ve seri yapısı daha güçlü |
2026 testi: günlük XML ve tarihli arşiv
27 Ekim 2026 itibarıyla iki adres de HTTP 200 döndü:
curl -s https://www.tcmb.gov.tr/kurlar/today.xml
curl -s https://www.tcmb.gov.tr/kurlar/202610/27102026.xmltoday.xml yanıtındaki kök eleman Tarih_Date idi; Tarih="27.10.2026", Date="10/27/2026" ve Bulten_No="2026/203" alanları vardı. Her para birimi Currency düğümünde Kod, CurrencyCode, Unit, ForexBuying, ForexSelling, BanknoteBuying ve BanknoteSelling alanlarıyla geliyordu. Tarihli arşiv yolu da aynı şemayı döndürdü.
import { XMLParser } from "fast-xml-parser";
const parser = new XMLParser({
ignoreAttributes: false,
attributeNamePrefix: "@",
});
const xml = await fetch("https://www.tcmb.gov.tr/kurlar/today.xml").then(
(response) => {
if (!response.ok) throw new Error(`TCMB: ${response.status}`);
return response.text();
},
);
const document = parser.parse(xml);
const bulletin = document.Tarih_Date;
const currencies = Array.isArray(bulletin.Currency)
? bulletin.Currency
: [bulletin.Currency];
const usd = currencies.find(
(currency: { "@Kod": string }) => currency["@Kod"] === "USD",
);Önemli ayrıntılar:
today.xmlher zaman “bugünün” dosyası olmayabilir; hafta sonu ve resmi
tatilde son iş günü bülteni kalır. Tarih ve Bulten_No alanlarını saklayın.
- Tarihli arşiv yolu
YYYYMM/DDMMYYYY.xmlbiçimindedir; örneğin
202610/27102026.xml. Üretimde bugünün dosyasını tahmin etmek yerine today.xml kullanın, geçmiş günler için arşiv yolunu deneyin.
- XML'i tarayıcıda parse etmek yerine backend'inizde işleyin; CORS ve XML
ayrıştırma farklarını tek yerde yönetin.
Günlük kur XML ne zaman yeterli?
TCMB Günlük Kurlar XML, kur göstergesi, basit çevirici, fiyat ekranı veya muhasebe yardımcı aracı için yeterli olabilir. today.xml aktif bülteni verir; tarihe göre arşiv dosyaları da belirli path yapısıyla okunabilir.
Bu kaynakla çalışırken iş günü davranışını hesaba katın. Hafta sonu veya resmi tatilde yeni bülten yayınlanmayabilir; tarihe göre dosya bulunamadığında uygulamanın 404 durumunu normal bir sonuç gibi yönetmesi gerekir. Kullanıcıya "son yayınlanan bülten" bilgisini göstermek güveni artırır.
EVDS ne zaman gerekli?
TCMB EVDS, sadece kur değil; faiz, enflasyon, para ve makroekonomik göstergeler gibi daha geniş zaman serileri gerektiğinde anlamlıdır. Ekonomi paneli, akademik analiz aracı, iç raporlama veya veri görselleştirme ürünü yapıyorsanız EVDS daha doğru katmandır.
EVDS entegrasyonu günlük XML'e göre daha fazla modelleme ister. Kategori, seri kodu, tarih aralığı, çıktı formatı ve API anahtarı gibi kararları netleştirmeniz gerekir. Bu yüzden EVDS'i uygulamanın her yerine doğrudan çağırmak yerine küçük bir veri servisinin arkasına koymak daha sağlıklıdır.
Üretim mimarisi
Kur verisini UI'da doğrudan API yanıtından okumayın. Kendi modelinizde source, seriesCode, date, currency, buyingRate, sellingRate, fetchedAt gibi alanları ayırın. Böylece günlük XML ile başlayan bir ürün ileride EVDS veya başka resmi kaynakla genişleyebilir.
Cache stratejisi de ürün tipine göre ayrılmalıdır. Bugünkü kur kartı için kısa veya gün sonuna kadar cache yeterli olabilir. Tarihli arşiv verisi ise değişmeyeceği varsayımıyla daha uzun saklanabilir. Ekonomik seri ekranlarında sorgu parametreleri cache anahtarına dahil edilmelidir.
Hata yönetimi
Eksik veri geldiğinde sıfır kur basmak en tehlikeli hatalardan biridir. Kur yoksa hesaplama yapılmamalı, kullanıcıya veri bulunamadığı açıkça gösterilmelidir. Finansal ekranlarda eski veri gösterilecekse bu durum "son güncelleme" etiketiyle belirtilmelidir.
Ayrıca API anahtarı gereken EVDS çağrılarında anahtarın frontend'e çıkmadığından emin olun. Backend üzerinden çağırmak, anahtarı korumak ve rate limit davranışını merkezi yönetmek için daha doğru bir yaklaşımdır.
Veri sunumu ve kullanıcı güveni
Kur ve ekonomik seri verisi gösteren ürünlerde kaynak şeffaflığı önemlidir. Kullanıcıya sadece sayı göstermek yerine kaynak, tarih, seri adı ve mümkünse veri yayın zamanı gösterilmelidir. Özellikle muhasebe ve raporlama ekranlarında "hangi kur kullanıldı" sorusu sonradan denetlenebilir olmalıdır.
Grafik ekranlarında eksik günleri sıfır gibi çizmek yerine boş veri olarak işlemek gerekir. Hafta sonu, resmi tatil veya yayın yapılmayan günlerde dosya bulunmaması hata olmayabilir. Uygulama bu ayrımı bilmezse kullanıcıya yanlış finansal eğilim gösterebilir.
EVDS ile çalışırken seri kodlarını konfigürasyon gibi yönetin. Kodlar UI içine gömülürse yeni seri eklemek veya eski seriyi değiştirmek gereksiz deploy gerektirir. Daha iyi model, backend tarafında onaylı seri listesini tutmak ve UI'a sadece anlamlı etiketleri göstermektir.
İlgili API Deposu kayıtları
Kaynaklar
Sık Sorulan Sorular
›TCMB EVDS ile günlük kur XML arasındaki fark nedir?
Günlük kur XML akışı tek iş için sade bir kaynaktır: güncel veya arşivlenmiş döviz bülteni okumak. EVDS ise daha geniş ekonomik zaman serileri ve analiz ihtiyacı için kullanılır.
›TCMB EVDS API anahtarı gerektirir mi?
EVDS entegrasyonunda API anahtarı kullanılır ve katalog notuna göre anahtar header üzerinden gönderilmelidir. Günlük kur XML akışı ise basit okuma senaryolarında anahtarsız erişilebilir.
›Muhasebe ürünü için hangi kaynak daha uygun?
Sadece günlük döviz kuru gerekiyorsa TCMB günlük XML daha basittir. Çoklu ekonomik seri, tarih aralığı veya analiz gerekiyorsa EVDS daha doğru kaynaktır.
›Kur verisi üretimde nasıl cache'lenmeli?
Günlük kur bülteni sık değişen bir veri değildir; iş günü ve yayın saati dikkate alınarak cache kullanılmalıdır. Tarihli arşiv dosyaları daha uzun süre saklanabilir.
›TCMB günlük kur XML bugünkü kuru mu verir?
today.xml genellikle son yayınlanan bülteni verir; hafta sonu veya resmi tatilde tarih bugün olmayabilir. Dosyadaki Tarih ve Bulten_No alanlarını okuyup kullanıcıya 'son yayınlanan bülten' etiketiyle gösterin.
›TCMB kur verisi için API anahtarı gerekir mi?
Günlük kur XML için anahtar gerekmez. EVDS web servisi ise kullanıcı/API anahtarı gerektirir; anahtarı frontend'e koymayın, backend üzerinden çağırın.
Yazar ve editoryal inceleme bilgisi
Mert Murat, API Deposu'nu kurdu ve sürdürüyor. Katalogdaki 400'ü aşkın herkese açık API kaydını sağlayıcıların resmî dokümantasyonuna karşı doğruluyor, uygun olanlarda endpoint'leri çalıştırarak test ediyor ve blogdaki rehberleri yazıyor. Düzeltme ve önerileri iletisim@apideposu.com adresine iletebilirsiniz.
İnceleme yöntemi: Temel iddialar, bağlantı verilen sağlayıcı belgeleri ve ilgili API Deposu katalog kayıtlarıyla karşılaştırıldı. Editoryal politikayı incele
Hazırlanışı: Taslak aşamasında yapay zekâ desteği kullanılabilir. Yayımdan önce her iddia, yazıda bağlantı verilen resmî sağlayıcı belgelerine ve katalog kayıtlarına karşı bir editör tarafından kontrol edilir; doğrulanamayan bilgi yayımlanmaz.



