Döviz metodolojisi

Döviz kümesi, Avrupa Merkez Bankası’nın yayımladığı orta piyasa kurlarına karşı 50 canlı döviz çifti içerir. Veri yolu kasıtlı olarak basittir: ECB günlük referans kurlarını yayımlar; açık kaynaklı Frankfurter API bunları JSON olarak yeniden yayımlar; sonucu bir saat için Next.js ISR ile önbelleğe alırız. Tescilli spread yok, sağlayıcılar arasında toplama yok, “bizim fiyatlandırmamız” katmanı yok.

Veri kaynağı: ECB günlük referans kurları

Avrupa Merkez Bankası, her TARGET iş günü saat 16:00 CET’te avro karşısında ~32 para birimi için referans döviz kurlarını yayımlar. Bunlar, AB merkez bankaları arasındaki bir konsertasyon sonucunda türetilen orta piyasa kurlarıdır; işlem yapılabilir değil ancak kanonik referans ölçütüdürler.

EUR dışındaki çiftler için (USD → GBP, JPY → TRY) EUR üzerinden üçgenleme yaparız: USD/EUR × EUR/GBP, USD/GBP verir. Üçgenleme cebirsel olarak kesindir ve Frankfurter’ın dahili olarak hesapladığı şeydir.

Önbelleğe alma stratejisi

Döviz kurları günde en fazla bir kez güncellenir (ECB hafta sonu kurları yayımlamaz), bu nedenle 1 saatlik önbellek cömert. Next.js artımlı statik yenileme kullanırız:

• Bir döviz sayfasına ilk istek: sunucu Frankfurter’ı getirir, işler, önbelleğe alır.
• 1 saat içindeki sonraki istekler: önbelleğe alınmış HTML, 100 ms altında.
• 1 saatten sonra: bir sonraki istek eski sayfayı anında alır, arka planda yenileme tetikler.

Bu, gördüğünüz kurun en fazla bir saat eski olduğu anlamına gelir. Perakende dönüşüm için bu önemsizdir — banka spreadleri cevabı bir saatlik kaymadan çok daha fazla değiştirir. Yüksek hassasiyetli bağlamlarda (algoritmik ticaret, büyük havale transferleri) kurları herhangi bir genel referanstan değil bankanızdan alın.

Gerçekte alacağınız spread ve kur karşılaştırması

Orta piyasa kuru, iki bankanın işlem yapacağı kurdur. Perakende müşteri olarak siz bu kuru alamazsınız. Gerçek maliyetiniz üzerine bir spread içerir:

• Kart ağları (Visa, Mastercard): genellikle orta piyasanın %0,2-1 üzerinde.
• Kendi spreadini ekleyen çıkarıcı bankalar: ABD’de yaygın; ağ kuruna %1-3 eklenir.
• ATM ve POS terminallerinde döviz dönüşüm ücretleri (DCC): %3-8 spread. Yurt dışında ana para biriminizde ödeme yapmanız istenirse her zaman reddedin.
• Uzman döviz sağlayıcıları (Wise, Revolut): orta piyasanın %0,3-1 üzerinde, DCC yok. Perakende seçeneklerinin referans kurunun en yakınındadır.
• Havale için geleneksel bankalar: %2-5 spread. Yaygın perakende seçeneklerinin en kötüsü.

Algoritma ayrıntıları: kur çözümleme ve üçgenleme

Her döviz isteği tek bir çarpmaya çözümlenir. İlginç kısım, istenen tabanın EUR olmadığı durumlarda doğru birim başına kura nasıl ulaşıldığıdır.

1. Her iki dövizi de ISO 4217 üç harfli kodlara normalleştirin ve desteklenen listeye karşı doğrulayın (~32 döviz — ECB referans serisindeki her kod artı küçük bir çapraz kur seti).
2. Frankfurter önbelleğinden en son EUR tabanlı kur setini alın (ISR aracılığıyla 1 saatlik TTL). Yük, 1 EUR = X hedef olarak belirtilen { "USD": 1.0865, "GBP": 0.8479, ... } eşlemesidir.
3. Hiçbir taraf EUR değilse üçgenleme yapın. JPY → TRY için: oran_JPY_TRY = oran_EUR_TRY / oran_EUR_JPY. Üçgenleme, gerçek aritmetikte cebirsel olarak kesindir; bölmenin kayan nokta hatası < 10⁻¹⁵, herhangi bir anlamlı perakende spreadinin çok altındadır.
4. Dönüşümü hesaplayın. çıktı = girdi × oran_kaynaktan_hedefe. Görüntüleme, döviz tarzı çıktılar için 4 ondalık basamağa ve büyük para birimi sembolleriyle eşleştirildiğinde 2 ondalık basamağa yuvarlanır.
5. Yanıt meta verilerini damgalayın: rateDate (ECB yayım tarihi, örn. 2026-05-13) ve source(“Frankfurter aracılığıyla ECB”).

Kaynaklar ve referanslar

Bu aracın yayımladığı her kur, nihayetinde saat 16:00 CET’te yayımlanan ECB günlük referans serisine dayanır. Frankfurter, bu serinin şeffaf bir açık kaynak yeniden yayıncısıdır; önbelleğimiz yalnızca Cache-Control başlıklarına saygı gösterir. ISO 4217, para birimi kodu ad alanını yönetir. Başka yerlerde alıntılanan perakende spread rakamları BIS ve IMF referans verilerine dayanır — tam alıntılar aşağıdaki Kaynaklar bloğunda.

Varsayımlar ve sınırlamalar

• Yalnızca EUR eksenli üçgenleme. Her iki döviz de EUR dışındaysa ve ECB serisi belirli bir tarihte birini kapsamıyorsa, dönüştürücü farklı bir eksen denemek yerine en yakın önceki iş günü kurunu döndürür.
• Yalnızca hafta içi veri. ECB hafta sonları veya TARGET tatillerinde yayım yapmaz. Hafta sonu istekleri Cuma kurunu döndürür; rateDate alanı bunu işaretler.
• Canlı dakika dakika piyasa verisi yok. ECB referans kuru günlük orta tespit, akış kotu değil. Algoritmik ticaret bir Bloomberg veya Reuters beslemesi gerektirir; bu dönüştürücü bir piyasa veri servisi değil, referanstır.
• Spread modellemesi yok. Görüntülenen kur, sıfır alış/satış spredle orta piyasadır. Gerçek perakende dönüşüm genellikle ortanın %0,3-4 üzerinde öder; dönüştürücü taban fiyatı gösterir, satış fiyatını değil.
• Kripto para birimi yok. BTC, ETH ve stabilcoinler /crypto/ altında yer alır ve farklı metodoloji ile veri kaynağı kullanır.
• Geçmiş kurlar ECB kapsamıyla sınırlı (1999-günümüz). Euro öncesi döviz dönüşümü (DEM, FRF, ITL) ayrı sabit dönüşüm oranı tablosu gerektirir.
• Hiperenflasyon aykırı değerleri gecikebilir. Rejim değişikliklerine sahip para birimleri (TRY, ARS, VES) bazen ECB’nin yeniden yayımlama döngüsü sırasında kısa süre eski kurları gösterir.

Yapmadıklarımız

Sağlayıcılar arasında kurları toplamıyoruz (bu nedenle şu anda kimin en iyi teklifi sunduğunu söyleyemeyiz). Döviz kümesinde kripto para çiftlerini desteklemiyoruz (bunlar /crypto/ altında). Kurumu işlemsel bir API ile desteklemiyoruz — Convertitive size sayıyı gösterir, bankanız veya sağlayıcınız gerçek para hareketini yönetir.