Kod waluty – co to jest i jak go sprawdzić?

Kod waluty to trzyliterowy identyfikator zapisany według standardu ISO 4217. Dla polskiego złotego jest to PLN, dla euro EUR, a dla dolara amerykańskiego USD. Sprawdzisz go w tabelach kursowych NBP, przez publiczne API NBP albo w kalkulatorze walutowym. W artykule wyjaśniamy też, dlaczego kod nie jest tym samym co symbol waluty.

Czym jest kod waluty?

Trzyliterowy identyfikator to skrót literowy, który jednoznacznie identyfikuje daną jednostkę monetarną na całym świecie. W codziennym obrocie pełni podobną rolę jak numer rachunku – zapobiega pomyłkom przy przelewach, księgowaniu i wymianie.

Standard ISO 4217 opracowała Międzynarodowa Organizacja Normalizacyjna. To tam przypisano trzyliterowe oznaczenia poszczególnym walutom, a dodatkowo każdej z nich nadano kod numeryczny. Przykładowo polski złoty ma oznaczenie PLN i numer 985, euro ma EUR i 978, a dolar amerykański USD i 840.

Pełna lista obejmuje również terytoria zamorskie i jednostki rozliczeniowe. Przykładem może być SDR oznaczany jako XDR i publikowany przez Międzynarodowy Fundusz Walutowy.

Jak zbudowany jest kod ISO 4217?

Kod składa się z trzech wielkich liter. Dwie pierwsze zwykle odnoszą się do kraju lub terytorium zgodnie z kodem ISO 3166, a trzecia bywa skojarzona z nazwą waluty. Dla walut ponadnarodowych reguła bywa inna – przykładem jest EUR, gdzie litery wskazują na Europę.

W tabeli znajdziesz popularne waluty wraz z kodami, symbolami oraz średnim kursem NBP opublikowanym 12 sierpnia 2026 roku. To pozwala szybko porównać oznaczenia i wartości.

Rzadziej spotykane waluty również mają swoje unikalne kody. Bat tajlandzki to THB, hrywna ukraińska UAH, korona islandzka ISK, a peso meksykańskie MXN.

Gdzie sprawdzić trzyliterowy kod?

Najwygodniejsze źródła to oficjalne tabele NBP oraz publiczne API serwisu api.nbp.pl. Obie metody korzystają z tych samych danych publikowanych codziennie przez Narodowy Bank Polski.

Jak sprawdzić kod w tabeli NBP?

W tabeli kursów średnich każda waluta ma przypisany kod literowy i nazwę. Wystarczy odnaleźć interesujący kraj lub jednostkę, aby odczytać trzyliterowy skrót. Tabela obejmuje między innymi hrywnę, peso chilijskie, ringgita, rupię indyjską i indonezyjską, a także wona południowokoreańskiego.

Do kursów kupna i sprzedaży służy tabela C. Przykładowo Tabela nr 156/C/NBP/2026 z 12 sierpnia 2026 roku obowiązuje od 13 sierpnia 2026 roku na podstawie uchwały Nr 44/2025 Zarządu NBP.

Jak skorzystać z publicznego API NBP?

Serwis api.nbp.pl udostępnia publiczne Web API. Od 1 sierpnia 2025 roku cała komunikacja musi odbywać się wyłącznie po HTTPS, a wcześniejszy HTTP nie jest już wspierany. Odpowiedź można otrzymać w formacie JSON albo XML.

Podstawowe parametry zapytań to:

• {table} – typ tabeli A, B lub C,
• {code} – trzyliterowy kod waluty według ISO 4217,
• {topCount} – maksymalna liczba zwracanych danych,
• {date} – data w formacie RRRR-MM-DD zgodnym z ISO 8601.

Do pobrania kursu pojedynczej waluty służy ścieżka https://api.nbp.pl/api/exchangerates/rates/{table}/{code}/. Przykład dla dzisiejszego kursu euro to https://api.nbp.pl/api/exchangerates/rates/a/eur/today/?format=json. Dla zakresu dat między {startDate} a {endDate} stosuje się ten sam wzorzec, na przykład https://api.nbp.pl/api/exchangerates/rates/a/gbp/2012-01-01/2012-01-31/.

Pojedyncze zapytanie do API NBP nie może obejmować przedziału dłuższego niż 93 dni.

Brak danych dla poprawnie określonego zakresu zwraca 404 Not Found, a nieprawidłowo sformułowane zapytanie – 400 Bad Request. Osoby sprawdzające notowania złota mogą też użyć ścieżki https://api.nbp.pl/api/cenyzlota.

Kalkulator walut i inne tabele

Kod waluty znajdziesz także w kalkulatorze walutowym, który przelicza kwoty na podstawie danych NBP. Wiele narzędzi księgowych pobiera te same identyfikatory, dlatego wynik powinien być spójny z tabelami banku centralnego. Historia przeliczeń obejmuje kursy od 1 stycznia 2002 roku.

Kod ISO 4217 na fakturze i w KSeF

Na dokumentach sprzedaży trzyliterowy kod ma znaczenie praktyczne. Jeśli program księgowy widzi wyłącznie kod, a nie ma przy nim kursu, może zgłosić błąd. Dotyczy to zwłaszcza faktur przesyłanych do KSeF.

W praktyce pojawia się komunikat „Dok. FVZ 0 – ujemny lub zerowy kurs waluty”. Oznacza to, że dokument dotarł bez poprawnego kursu przeliczenia. Samo wpisanie kodu, na przykład EUR, nie wystarczy – wymagany jest również kurs, po jakim przeliczono wartość na złote.

Czym różni się kod od symbolu?

Kod ISO 4217 jest jednoznaczny, a symbol nie zawsze. Ten sam znak graficzny $ reprezentuje dolara amerykańskiego, kanadyjskiego, australijskiego, nowozelandzkiego i singapurskiego. Z kolei ¥ oznacza zarówno chińskiego juana, jak i japońskiego jena.

Symbole bywają wygodne w menu restauracji lub na metkach, ale w dokumentach finansowych lepiej sprawdza się kod trzyliterowy. Dzięki temu unika się dwuznaczności między różnymi jednostkami monetarnymi o tej samej graficznej postaci.

Nie wszystkie waluty mają szeroko znane symbole graficzne. W takich sytuacjach kod pozostaje jedynym czytelnym sposobem identyfikacji, na przykład CLP dla peso chilijskiego czy PHP dla peso filipińskiego.