API-Endpunkte

Frankfurter bietet Endpunkte für aktuelle Kurse, historische Daten und Zeitreihen.

Aktuelle Kurse

Kurse des letzten Arbeitstags abrufen. Sie werden täglich gegen 16 Uhr MEZ aktualisiert.

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

Basiswährung mit dem Parameter base ändern. Der Standard ist EUR.

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

Antwort auf bestimmte Zielwährungen beschränken.

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

Historische Kurse

Kurse für ein bestimmtes Datum abrufen.

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

Basiswährung ändern und Zielwährungen filtern.

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

Hinweis: Frankfurter speichert Datumsangaben in UTC. Wenn du eine andere Zeitzone nutzt, fragst du womöglich ein anderes Datum ab als gedacht. Daten für heute sind außerdem nicht endgültig und ändern sich, sobald neue Kurse veröffentlicht werden.

Zeitreihen

Kurse über einen Zeitraum abrufen.

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

Kurse bis heute abrufen.

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

Tipp: Filtere die Währungen, damit die Antwort kleiner und schneller wird.

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

Verfügbare Währungen

Unterstützte Währungskürzel und ihre vollständigen Namen abrufen.

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

Währungsumrechnung

Wechselkurs abrufen und im Code umrechnen.

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);