exchangerate.dev1. Kaynak sınıfları
Kamuya açık source alanı bir veri sınıfını tanımlar, bir tedarikçiyi değil. live, bankalararası işlem haftası boyunca kısa aralıklarla güncellenebilen, gösterge niteliğindeki spot piyasa verisidir. ecb_daily, normalde her iş gününde bir kez yayımlanan Avrupa Merkez Bankası referans kurudur. market_daily, ECB tarafından belirlenen referans kuru bulunmayan para birimleri için piyasa veri akışının günlük kapanış kurunu saklar.
Birden fazla para birimi içeren yanıt, kuru verilen her para birimi için bir sources eşlemesi içerir. En üst düzeydeki source temkinlidir: o yanıtta bulunan en az güncel sınıfı bildirir.
Kaynak: ECB euro referans döviz kurları.
2. Zaman ve piyasa durumu
data_updated_at, temel alınan gözlemin en son yazıldığı zamandır. timestamp, API yanıtının oluşturulduğu zamandır. Veri yaşını hesaplamak için ilkini, istek zamanlamasını denetlemek için ikincisini kullanın.
market_session, bankalararası işlem haftasında open, New York saatiyle cuma 17:00 kapanışından sonra New York saatiyle pazar 17:00'ye kadar weekend, hafta sonu dışındaki bilinen bir kapanışta ise interbank_closed olur. Hafta sonu yanıtı, işlem haftasının son gözlemini taşıyabilir; bu etiket hafta sonunda yeni bir kotasyon olduğu anlamına gelmez.
3. Baz para birimini değiştirme ve türetilmiş çapraz kurlar
Kurlar, çağrıyı yapanların desteklenen herhangi bir baz para birimini isteyebilmesi için normalleştirilir. Bir parite doğrudan gözlemlenmediğinde API, mevcut bileşen pariteler üzerinden üçgenleme yaparak kuru hesaplar. Türetilmiş değerler derived_symbols içinde belirtilir; tek pariteli yanıtlar, geçerli olduğunda derived ve bir derivation_bps_max sınırı da sunar.
Çapraz kur, bileşen paritelerinin en az güncel kaynağını devralır. Türetilmiş bir kuru kabul edemeyen uygulamalar, para birimi çiftinden çıkarım yapmak yerine türetme alanlarını kontrol etmelidir.
4. Geçmiş gözlemler
Günlük geçmiş, belirlenen referans kurları ile piyasa kapanış kurlarını birleştirir. Başlıca para birimlerinin verileri 1999'a kadar uzanır; yaklaşık 30'u ECB tarafından belirlenen referans kurlarını, diğer 113'ü piyasa kapanış kurlarını kullanır ve başlangıç tarihleri pariteye göre değişir. Yeni bir referans kurunun belirlenmediği hafta sonu veya tatil gününde önceki bir gözlem ileri taşınabilir ve is_forward_filled: true olarak etiketlenir. API, yayımlanmamış bir referans kurunu uydurmaz.
5. Doğrulama ve yayımlama
- Para birimi tanımlayıcıları, fiyatlandırmadan önce ISO tarzı büyük harfli kodlara normalleştirilir.
- Kaynak ve güncelleme zamanı alanları, istemci tarafından çıkarılmak yerine gözlemle birlikte iletilir.
- Canlı gözlemler bulunmadığında veya çok eski olduğunda, canlı olarak etiketlenmek yerine mevcut bir günlük referans sınıfına geçilir.
- Her plan aynı kaynağı kullanır; Free ve anahtarsız çağrı yapanlar canlı kurları 15 dakika gecikmeli alır.
- Yayımlanan araştırmalar ölçüm aralığını, örnek sayısını, yöntemi ve sınırlamaları içermelidir.
6. Sınırlamalar
Bunlar gösterge niteliğindeki referans kurlardır, işlem yapılabilir alış/satış kotasyonları değildir. Banka, kart kuruluşu, aracı kurum, ödeme sağlayıcısı veya nakit döviz satıcısının makasını ve ücretini içermezler. Mutabakat, ödeme gerçekleştirme, düzenlemeye tabi alım satım veya resmi kayıt kaynağı olarak kullanılmamalıdırlar. Kapsam ve güncellik; para birimine, kaynak kullanılabilirliğine, piyasa kapanışlarına ve referans kurumun yayımlama takvimine göre değişebilir.
7. Güncellik karşılaştırma standardı
Bir sıralama yayımlamadan önce protokolü yayımlarız. Tekrarlanabilir döviz kuru API güncellik karşılaştırması, gözlem aralığını, zaman damgası gerekliliklerini, metrikleri, hariç tutma koşullarını ve asgari örneklem büyüklüğünü tanımlar. Bunun makine tarafından okunabilir protokolü şu anda sağlayıcı sonuçları içermez; sonuçlar yalnızca belirtilen kanıt eşiği karşılandıktan sonra eklenecektir.
Değişiklik günlüğü
1.1 · 9 Ekim 2026: Free gecikmesi ve günlük piyasa kapanış kurları netleştirildi.
1.0 · 16 Temmuz 2026: İlk kamuya açık metodoloji, kaynakların anlamları, piyasa seansı kuralları, türetme politikası, geçmiş veri davranışı, sınırlamalar ve karşılaştırma yayımlama standardı.
Düzeltmeler: hello@exchangerate.dev