Endpointy API

Frankfurter oferuje endpointy dla aktualnych kursów, danych historycznych oraz szeregów czasowych.

Aktualne kursy

Pobierz kursy z ostatniego dnia roboczego. Są aktualizowane codziennie około godziny 16:00 CET.

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

Zmień walutę bazową za pomocą parametru base. Domyślną walutą jest EUR.

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

Ogranicz odpowiedź do wybranych walut docelowych.

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

Kursy historyczne

Pobierz kursy dla określonej daty.

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

Zmień walutę bazową i filtruj waluty docelowe.

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

Uwaga: Frankfurter zapisuje daty w strefie UTC. Przy innej strefie czasowej możesz odpytać o inny dzień niż zamierzony. Dane z bieżącego dnia nie są ostateczne i mogą ulec zmianie po publikacji nowych kursów.

Szeregi czasowe

Pobierz kursy z wybranego przedziału czasowego.

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

Pobierz kursy aż do chwili obecnej.

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

Wskazówka: Filtruj waluty, aby odpowiedź była mniejsza i szybsza.

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

Dostępne waluty

Lista obsługiwanych symboli walut wraz z ich pełnymi nazwami.

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

Przeliczanie walut

Pobierz kurs walutowy i przelicz kwotę we własnym kodzie.

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