In this Article
Döviz dönüşümü, önünde bir API bulunan çözülmüş bir sorun gibi görünür. Karmaşıklıklar, finans ve ürün ekipleri bir sayı üzerinde ilk kez anlaşamadığında ortaya çıkar; bunun nedeni neredeyse her zaman farklı kurlar kullanmaları ve ikisinin de kendi kullandığının kur olduğuna inanmasıdır.
Bu rehber dört kur türünü birbirinden ayırır, her birinin nereden geldiğini açıklar ve sonradan savunabileceğiniz birini seçmeniz için bir kural sunar.
Temel Bilgiler
- Tek bir döviz kuru yoktur. Para birimleri tezgah üstü işlem görür; bu nedenle yayımlanan her kur, bir kaynağın belirli bir andaki görüşüdür.
- Dört kur türü düzenli olarak karıştırılır ve yanlış olanın kullanılması, finans sistemindeki mutabakat farklarının en yaygın nedenidir.
- Merkez bankası referans kurları günde bir kez yayımlanır; istikrarlı ve alıntılanabilir olmaları onları muhasebe için doğru, fiyatlandırma için ise yanlış seçenek yapar.
- Müşterinizin ödediği kur bir marj içerir; dolayısıyla piyasa ortası kur bir kart ekstresiyle asla eşleşmez ve onu fiyat olarak sunmak destek talepleri yaratır.
- Her dönüştürülmüş tutarla birlikte kuru, kaynağı ve zaman damgasını daima saklayın; aksi halde dönüşüm sonradan yeniden üretilemez.
Neden tek bir döviz kuru yoktur?
Çünkü başlıca para birimleri tek bir merkezi borsa yerine kurumlar arasında tezgah üstü işlem görür. Kapanış zili ve resmi bir fiyat yoktur; bu nedenle yayımlanan her rakam, belirli bir kaynağın belirli bir andaki derlemesidir.
Bunun yazılım açısından doğrudan bir sonucu vardır: bir saniye arayla sorgulanan iki API haklı olarak farklı sayılar döndürebilir ve ikisi de hatalı değildir. Bunun yarattığı mutabakat sorunu daha iyi bir kaynak bularak çözülmez. Hangi amaca hangi kaynağın yetkili olduğuna karar verip bu kararı saklanan her tutarla birlikte kaydederek çözülür.
Hangi kur türleri vardır?
Dört tür vardır; amaçları farklıdır ve her döviz kuru API’si bunlardan birini döndürür. Buna 4 parçalı kur modeli diyoruz.
| Tür | Nedir? | Şunun için kullanın |
|---|---|---|
| 1. Piyasa ortası | Başlıca piyasalardaki alış ve satış fiyatlarının orta noktası | Gösterim, analiz, dahili karşılaştırma |
| 2. Merkez bankası referansı | Belirli bir saatte sabitlenen, günlük yayımlanan referans | Muhasebe, vergi, sözleşmeler, denetlenebilir her şey |
| 3. İşlem kuru | Bir ödeme sağlayıcısının veya kart ağının marj dahil fiilen uyguladığı kur | Gerçek mutabakatlarla karşılaştırma |
| 4. Garantili kur | Bir sağlayıcının belli bir süre için kilitlediği, bu garanti için marj içeren kur | Toplamın değişmemesi gereken ödeme sayfası fiyatlandırması |
Klasik hata, ödeme sayfasında piyasa ortası kuru gösterip işlem kuru üzerinden mutabakat yapmaktır. Müşteri bir sayı görür, başka bir sayı tahsil edilir; aradaki fark tamamen öngörülebilir ve tamamen önlenebilirdir.
Bir kur nasıl seçilmeli ve saklanmalıdır?
| Amaç | Bu kuru şu durumda kullanın | Şu durumda kaçının |
|---|---|---|
| Finansal raporlama | Tarihli merkez bankası referansı | Referansların sağlamadığı gün içi kesinliğe ihtiyacınız varsa |
| Kullanıcılara gösterilen ürün fiyatlandırması | Marj açıklanmış garantili veya işlem kuru | Tahsilatla eşleşmeyecek piyasa ortası kuru kullanıyorsanız |
| Analiz ve panolar | Tutarlı biçimde, tek kaynaktan piyasa ortası | Grafikler arasında kaynakları karıştırıyorsanız; bu sahte değişkenlik yaratır |
| Geçmiş karşılaştırma | O anda saklanan kur | Geçmişi bugünün kuruyla yeniden dönüştürüyorsanız; bu geçmişi yeniden yazar |
Tek bir saklama kuralı sorunların çoğunu kapsar: her dönüştürülmüş tutarla birlikte orijinal tutarı, para birimini, kuru, kaynağı ve zaman damgasını kalıcı olarak saklayın. Yalnızca dönüştürülmüş rakamı saklayan sistemler, bir sayının neden değiştiğini yanıtlayamaz; bu soru da er ya da geç mutlaka gelir.
Veri toplama bu işin neresinde yer alır ve sınırlar nelerdir?
Referans kurlar için resmi kaynakları kullanın. Merkez bankaları bunları açıkça ve makine tarafından okunabilir biçimde yayımlar. Bir merkez bankasının API olarak yayımladığı sayı için finans sitesini taramak, yalnızca olumsuzluk getirir: daha düşük güvenilirlik, daha zayıf kaynak bilgisi ve ihtiyacınız olmayan bir kullanım koşulları sorunu.
Piyasa verilerinin lisansı vardır. Canlı kurumsal kurlar, tıpkı hisse senedi piyasa verileri gibi yeniden dağıtım koşulları olan lisanslı bir üründür. Ücretsiz bir görüntüleme akışı nadiren yeniden satış veya müşteriye yönelik kullanım için lisanslıdır.
Kripto çiftleri farklı bir sorundur. Gerçekten farklı fiyatlarla birçok piyasada işlem görürler; bu nedenle tek bir kur, hangi piyasaların dahil edileceği ve bunların nasıl ağırlıklandırılacağına dair editoryal bir tercihtir. Hangisini yaptığınızı belirtin.
Ülkeye sabitlenmiş bir isteğin yardımcı olduğu yer sınırlıdır: bazı resmi portallar ve bölgesel finans siteleri erişimi kaynağa göre kısıtlar veya yerelleştirir. DataImpulse residential, 195 ülkede GB başına $1 karşılığında bunu kapsar. Kurun kendisi resmi yayımcıdan gelmelidir.
Sıkça Sorulan Sorular
Neden iki döviz API’si farklı kurlar döndürür?
Başlıca para birimleri merkezi bir borsa olmadan tezgah üstü işlem gördüğü için yayımlanan her kur, bir kaynağın belirli bir andaki derlemesidir. Bir saniye arayla sorgulanan iki API haklı olarak farklı olabilir; bu yüzden yetkili kaynak amaca göre seçilmeli ve kaydedilmelidir.
Muhasebe için hangi döviz kurunu kullanmalıyım?
Tarihiyle birlikte saklanan bir merkez bankası referans kuru kullanın. Bu kur her gün belirli bir saatte bir kez yayımlanır, istikrarlı ve alıntılanabilirdir; denetçilerin beklediği de budur. Müşteriden fiilen tahsil edilen tutarla eşleşmeyeceği için ödeme sayfası fiyatlandırmasında yanlış seçimdir.
Müşterimin bankası neden farklı bir tutar tahsil ediyor?
Piyasa ortası kur marj içermezken gerçek bir işlem içerdiği için. Kart ağları ve ödeme sağlayıcıları kendi kurlarını bir marjla birlikte uygular; bu nedenle ödeme sayfasında piyasa ortası kuru göstermek, gösterilen ve tahsil edilen tutarlar arasında uyumsuzluğu garanti eder.
Finans sitelerinden döviz kurlarını taramalı mıyım?
Hayır. Merkez bankaları referans kurlarını makine tarafından okunabilir biçimde açıkça yayımlar; kurumsal piyasa kurları ise yeniden dağıtım koşulları olan lisanslı ürünlerdir. Tarama, zaten uygun şekilde mevcut olan veri için daha zayıf kaynak bilgisi ve güvenilirlik sağlar.
Dönüştürülmüş bir tutarla birlikte ne saklamalıyım?
Orijinal tutarı ve para birimini, uygulanan kuru, bu kurun kaynağını ve zaman damgasını saklayın. Beşinin tamamı olmadan geçmişteki bir rakam yeniden üretilemez veya açıklanamaz; saklanan geçmişi güncel kurla yeniden dönüştürmek de geçmiş raporları sessizce yeniden yazar.
Resmi yayımcılara doğru bölgeden ulaşın
Bazı resmi ve bölgesel finans portalları erişimi kaynağa göre yerelleştirir veya kısıtlar. DataImpulse residential proxies, 195 ülkede GB başına $1 karşılığında ülkeye sabitlenmiş çıkışlar sunar. Hesap oluşturun ve bir kaynağı kendi bölgesinden doğrulayın.
İlgili: hisse senedi piyasa verisi API’leri · kamu verisi portalları · web scraping yasal mı.
Son güncelleme: 17 Eylül 2026.