GET /fx

GET /fx              # najnowszy snapshot
GET /fx/YYYY-MM-DD   # snapshot historyczny dla wskazanej daty

Odpowiedź

{
  "date": "2026-05-27",
  "base": "EUR",
  "rates": {
    "USD": 1.085,
    "GBP": 0.84
  }
}

Znaczenie pól

• date — data publikacji przez EBC tego fixingu.
• base — zawsze "EUR". EBC publikuje wyłącznie kursy EUR-relative; kursy krzyżowe (np. USD/GBP) są poza zakresem Stawki.
• rates[CCY] — jednostek CCY za 1 EUR. Posortowane alfabetycznie.

Jeśli potrzebujesz GBP za 100 €, oblicz 100 * rates["GBP"].

Co jest uwzględnione

Pełna lista referencyjna EBC: główne i krzyżowe waluty, które EBC publikuje każdego dnia roboczego o 16:00 CET. Waluty, których EBC przestaje publikować, wypadają z listy tego samego dnia; nowe pojawiają się w dniu, w którym EBC zaczyna je publikować.

Zachowanie cache’u

• Najnowszy (/fx) — Cache-Control: public, max-age=3600, stale-while-revalidate=86400. Ta sama koperta co /rates.
• Historyczny (/fx/YYYY-MM-DD) — Cache-Control: public, max-age=31536000, immutable. Snapshoty są stabilne na zawsze.

Błędy

Status	Body	Przyczyna
404	{"error": "no fx data yet"}	Endpoint najnowszych danych, na tym deployu nie uruchomił się jeszcze żaden cron.
404	{"error": "fx snapshot not found"}	Endpoint historyczny, brak snapshotu dla wskazanej daty — najczęściej weekendy, święta państwowe lub daty przed rozpoczęciem publikacji przez EBC.
401	{"error": "INVALID_KEY"}	Brakujący lub nieprawidłowy token bearer.
429	{"error": "RATE_LIMITED"} lub {"error": "QUOTA_EXCEEDED"}	Zobacz limity i kwoty.

Harmonogram publikacji EBC

EBC nie publikuje w weekendy, w święta TARGET2 ani 1 stycznia. Pobranie historyczne dla jednej z tych dat zwróci 404; sam wycofaj się do poprzedniego dnia roboczego lub spodziewaj się 404 i obsłuż brakujący dzień w swoim kodzie.