Instrukcja pobierania kursów walut

Uwaga! Ważna aktualizacja API: przejście wyłącznie na HTTPS od 1 sierpnia 2025 r.

Od 1 sierpnia 2025 r. cała komunikacja z API.nbp.pl musi odbywać się za pośrednictwem protokołu HTTPS. Protokół http od tego dnia nie będzie już wspierany przy dostępie do naszych usług API. Zmiana ta jest częścią naszego stałego zaangażowania w zwiększanie bezpieczeństwa i ochronę danych podczas transmisji.

Wymagane działania

Aby zapewnić nieprzerwany dostęp do naszych usług API.nbp.pl od 1 sierpnia 2025 r., należy zaktualizować Państwa integrację, aby korzystała z punktów końcowych HTTPS. Dziękujemy za zrozumienie i współpracę podczas tej ważnej aktualizacji, którą realizujemy w celu zwiększenia bezpieczeństwa naszych usług.

Pobieranie plików XML zawierających dane o kursach walut NBP

Pliki w formacie XML z kursami walut NBP umieszczone są na stronie internetowej static.nbp.pl w folderze:

/dane/kursy/xml/*.xml

Dodatkowo w lokalizacji tej znajduje się plik:

https://static.nbp.pl/dane/kursy/xml/dir.txt

zawierający listę nazw plików (bez rozszerzenia .xml) z tabelami kursów walut. Zawiera on dane tylko z bieżącego roku. Dane z lat poprzednich umieszczone są w plikach dir2002.txt, dir2003.txt … dir2022.txt.

Nazwy wszystkich plików mają taki sam format:

‘xnnnzrrmmdd.xml’

gdzie poszczególne litery oznaczają:

x – litera określająca typ tabeli:

a – tabela kursów średnich walut obcych;
b – tabela kursów średnich walut niewymienialnych;
c – tabela kursów kupna i sprzedaży;
h – tabela kursów jednostek rozliczeniowych.

nnn – trzyznakowy (liczbowy) numer tabeli w roku;

z – litera ‘z’ (element stały)

rrmmdd – data publikacji/obowiązywania tabeli w formacie (bez odstępów): dwie ostatnie cyfry numeru roku, dwie cyfry numeru miesiąca oraz dwie cyfry numeru dnia.

.xml – standardowe rozszerzenie nazwy pliku w formacie XML.

Przykład pobrania z serwisu internetowego NBP pliku XML z tabelą A kursów średnich opublikowaną 5 lutego 2010 r.

W pliku dir2010.txt szukamy według daty:
A zatem szukany plik znajduje się pod adresem:

Aktualne (ostanie) pliki z tabelami kursów A, B i C dostępne są również pod następującymi nazwami (odpowiednio): LastA.xml, LastB.xml, LastC.xml.

Dobre praktyki

Zasady wyliczania i ogłaszania bieżących kursów walut obcych określa uchwała nr 51/2002 Zarządu Narodowego Banku Polskiego z dnia 23 września 2002 r. w sprawie sposobu wyliczania i ogłaszania bieżących kursów walut obcych (Dz. Urz. NBP z 2017 r., poz. 15),
Standardowo należy pobrać plik dir.txt (po terminie jego aktualizacji) uzyskując w ten sposób listę nazw wszystkich dostępnych plików tabel kursów walut w kolejności chronologicznej.
Zasady korzystania z danych publikowanych na stronie NBP można znaleźć w Regulaminach NBP.

Zobacz również

Informacja o terminach publikacji kursów walut NBP

NBP Web API – Pobieranie kursów walut oraz cen złota w formacie XML oraz JSON