v1 API'si v2 lehine deprecated durumda, ama çalışmaya devam edecek.

Frankfurter güncel kurları, geçmiş verileri ve zaman serilerini almak için endpoint'ler sunar.

Güncel kurlar

Son iş gününün kurlarını al. Kurlar her gün 16:00 CET civarında güncellenir.

curl https://api.frankfurter.dev/v1/latest

base parametresiyle baz para birimini değiştir. Varsayılan değer EUR.

curl https://api.frankfurter.dev/v1/latest?base=USD

Yanıtı belirli hedef para birimleriyle sınırla.

curl https://api.frankfurter.dev/v1/latest?symbols=CHF,GBP

Geçmiş kurlar

Belirli bir tarihteki kurları al.

curl https://api.frankfurter.dev/v1/1999-01-04

Baz para birimini değiştir ve hedef para birimlerini filtrele.

curl https://api.frankfurter.dev/v1/1999-01-04?base=USD&symbols=EUR

Not: Frankfurter tarihleri UTC olarak saklar. Farklı bir saat dilimindeysen, istediğinden farklı bir takvim gününü sorguluyor olabilirsin. Ayrıca bugünün verileri kesin değildir; yeni kurlar yayımlandıkça güncellenir.

Zaman serisi verileri

Bir dönemin kurlarını al.

curl https://api.frankfurter.dev/v1/2000-01-01..2000-12-31

Günümüze kadarki kurları al.

curl https://api.frankfurter.dev/v1/2024-01-01..

İpucu: Yanıt boyutunu küçültmek ve performansı artırmak için para birimlerini filtrele.

curl https://api.frankfurter.dev/v1/2024-01-01..?symbols=USD

Mevcut para birimleri

Desteklenen para birimi kodlarını ve tam adlarını al.

curl https://api.frankfurter.dev/v1/currencies

Döviz dönüştürme

Kuru al, dönüşümü kendi kodunda hesapla.

function convert(from, to, amount) {
  fetch(`https://api.frankfurter.dev/v1/latest?base=${from}&symbols=${to}`)
    .then((resp) => resp.json())
    .then((data) => {
      const convertedAmount = (amount * data.rates[to]).toFixed(2);
      alert(`${amount} ${from} = ${convertedAmount} ${to}`);
    });
  }

convert("EUR", "USD", 10);