Bir SDK'ya ihtiyacın yoktur. fetch her tarayıcıda, Node, Deno, Bun ve edge çalışma ortamlarında yerleşik olarak gelir. CORS açıktır ve sızdırılabilecek bir anahtar bulunmaz; bu sayede API'yi doğrudan istemci kodundan çağırabilirsin.

Hızlı Başlangıç

Bir kur al ve dönüştür:

const res = await fetch("https://api.frankfurter.dev/v2/rate/usd/eur");
const data = await res.json();
const total = 100 * data.rate;

Yanıt tek bir düz nesnedir: {"date": "2026-07-17", "base": "USD", "quote": "EUR", "rate": 0.8739}. fetch HTTP hatalarında da resolve olur, bu yüzden res.ok kontrolü yap; geçersiz bir para birimi kodu JSON mesajıyla birlikte 422 döndürür.

Intl ile Biçimlendirme

Para birimi sembollerini elle yerleştirme. Intl.NumberFormat her yerel ayarda (locale) her para biriminin sembolünü, konumunu ve ondalık basamak sayısını bilir:

const res = await fetch("https://api.frankfurter.dev/v2/rate/usd/eur");
const { rate } = await res.json();

const eur = new Intl.NumberFormat("en", {
  style: "currency",
  currency: "EUR",
});
eur.format(100 * rate); // "€87.39"

Semboller ve Ondalık Basamaklar

Alt birimler veya semboller için harici bir meta veri tablosu tutmana gerek yoktur. Biçimlendiriciye sor:

const yen = new Intl.NumberFormat("en", {
  style: "currency",
  currency: "JPY",
});

yen.resolvedOptions().maximumFractionDigits; // 0, the yen has no subunits
yen.formatToParts(1).find((part) => part.type === "currency").value; // "¥"

Frankfurter'ın sunduğu tüm para birimlerine kodları ve sembolleriyle göz at.

Aynı Anda Birden Fazla Hedef Kur

/v2/rates her hedef kur için bir satır içeren düz bir dizi döndürür. Object.fromEntries ile bunu bir nesneye dönüştür. Tüm para birimlerini almak için quotes parametresini atla.

const api = "https://api.frankfurter.dev";
const res = await fetch(`${api}/v2/rates?base=usd&quotes=eur,gbp,jpy`);
const rows = await res.json();

const rates = Object.fromEntries(rows.map((row) => [row.quote, row.rate]));
// { EUR: 0.8739, GBP: 0.74388, JPY: 162.33 }

Resmi Bir Kaynağı Sabitle

Varsayılan olarak tüm kaynakların harmanını alırsın. AB KDV'si için AMB gösterge kuru gibi mevzuatın belirli bir merkez bankasının yayınladığı kuru zorunlu kıldığı durumlarda tek bir kurumu sabitlemek için providers parametresini ekle.

const api = "https://api.frankfurter.dev";
const res = await fetch(`${api}/v2/rate/usd/eur?providers=ecb`);

Tüm kaynaklara göz at. Sabitlenen bir kaynak kendi yayın takvimini izler; bu nedenle en güncel kuru, harmanlanmış güncel kurun bir gün gerisinde kalabilir.

Canlı Dene

Tarayıcıdan ayrılmadan playground üzerinde sorgular oluştur ve yanıtları gör.