Kod waluty – co to jest i jak sprawdzić oznaczenia walut?

Kod waluty to trzyliterowe oznaczenie jednostki pieniężnej zgodne ze standardem ISO 4217, na przykład PLN dla polskiego złotego lub EUR dla euro. Można go sprawdzić w codziennych tabelach kursowych NBP albo za pomocą publicznego API. W artykule wyjaśniamy także, czym kod różni się od symbolu i jak unikać typowych pomyłek przy oznaczaniu walut.

Co to jest kod waluty?

Międzynarodowy system oznaczeń pieniężnych opiera się na trzyliterowych kodach ustalonych przez Międzynarodową Organizację Normalizacyjną oraz zapisanych w standardzie ISO 4217. Każda waluta ma dokładnie jeden taki kod, dlatego łatwo ją zidentyfikować bez podawania pełnej nazwy krajowej.

Oprócz wersji trzyliterowej istnieje również kod numeryczny. Na przykład polski złoty ma oznaczenie PLN oraz liczbę 985, dolar amerykański to USD i 840, a euro to EUR i 978. Ten zapis liczbowy bywa pomocny w systemach informatycznych i dokumentach księgowych, ponieważ nie koliduje z symbolami graficznymi.

W standardzie ISO 4217 określa się także wykładnik E, czyli liczbę cyfr po separatorze dziesiętnym. Dla większości walut wynosi on 2, ale są wyjątki – jen japoński (JPY) ma E równe 0, co oznacza brak miejsc dziesiętnych w typowych transakcjach, a dinar bahrajński (BHD) ma E równe 3.

Jak sprawdzić kod waluty w tabelach NBP?

Narodowy Bank Polski publikuje codziennie tabele kursowe, które zawierają zarówno nazwy walut, jak i ich trzyliterowe kody. W tabeli A i B podawane są kursy średnie, natomiast w tabeli C znajdują się kursy kupna i sprzedaży. Dzięki temu oznaczenie waluty można potwierdzić w dokumencie o charakterze urzędowym.

Przykładowe oznaczenia wraz z kursami średnimi według stanu na 13 sierpnia 2026 roku przedstawia poniższa tabela:

W tabeli C z 12 sierpnia 2026 roku, opublikowanej jako dokument nr 156/C/NBP/2026, kurs kupna euro wynosił 4,2599 zł, a sprzedaży 4,3459 zł. Dla dolara amerykańskiego różnica między kursem kupna a sprzedaży również była wyraźna – 3,6874 zł wobec 3,7618 zł. To pokazuje, że kod waluty w obu typach tabel pozostaje identyczny, choć wartości kursowe się różnią.

Tabela A, B i C – czym się różnią?

Tabela A obejmuje waluty o znaczeniu globalnym i lokalnym, a jej kursy średnie są najczęściej cytowane w mediach. Tabela B dotyczy walut mniej płynnych lub notowanych w specyficzny sposób. Tabela C zawiera natomiast kursy kupna i sprzedaży, które stosuje się między innymi w kantorach i bankach.

Niezależnie od typu tabeli, kody walut pozostają zapisane w formacie ISO 4217, co ułatwia ich porównywanie między różnymi źródłami.

Jak sprawdzić kod waluty przez API NBP?

Publiczne Web API NBP działa pod adresem bazowym https://api.nbp.pl/api/ i od 1 sierpnia 2025 roku wymaga wyłącznie połączeń HTTPS. Komunikacja polega na wysyłaniu żądań HTTP GET, a odpowiedź standardowo zwracana jest w formacie JSON. Można też zażądać formatu XML za pomocą parametru ?format=xml lub nagłówka Accept.

Kod waluty w zapytaniu podaje się trzyliterowym symbolem, na przykład EUR, USD albo CHF. Do pobrania kursu średniego euro z dzisiejszego dnia stosuje się adres: https://api.nbp.pl/api/exchangerates/rates/a/eur/. Parametry table, code i date muszą być zgodne z zasadami API.

Dla wygody można skorzystać z kilku gotowych wzorców zapytań:

• tabela kursów z dzisiaj – /api/exchangerates/tables/a/today/
• pięć ostatnich tabel – /api/exchangerates/tables/a/last/5/
• kurs dolara amerykańskiego z wybranego dnia – /api/exchangerates/rates/a/usd/2026-08-12/
• kurs franka szwajcarskiego z zakresu dat – /api/exchangerates/rates/a/chf/2026-08-01/2026-08-12/

Pojedyncze zapytanie nie może obejmować zakresu dłuższego niż 93 dni. Daty należy podawać w formacie RRRR-MM-DD zgodnym ze standardem ISO 8601. Przy braku danych dla prawidłowego zakresu serwis zwraca błąd 404 Not Found, a przy źle zbudowanym żądaniu – 400 Bad Request.

Jak ustawić format odpowiedzi?

Domyślnym formatem jest JSON, więc zapytanie bez dodatkowych parametrów zwróci właśnie taki dokument. Jeśli chcesz otrzymać XML, możesz dodać do adresu ?format=xml albo wysłać nagłówek Accept: application/xml. Podobnie działa nagłówek Accept: application/json dla formatu JSON.

W przypadku przekroczenia limitu zwracanych danych serwis również informuje o błędzie 400, co pomaga dostosować zakres zapytania do dozwolonej liczby rekordów.

Symbol waluty a kod waluty – jaka jest różnica?

Symbol to znak graficzny, na przykład $, €, £ albo ¥. Nie ma charakteru urzędowego i często oznacza kilka różnych walut. Kod trzyliterowy jest jednoznaczny i stosowany w systemach finansowych, tabelach kursowych oraz raportach księgowych.

Przykład z dolarem dobrze wyjaśnia problem – symbol $ używany jest zarówno dla dolara amerykańskiego, kanadyjskiego, australijskiego, jak i nowozelandzkiego. Z kolei znak ¥ odnosi się zarówno do jena japońskiego, jak i chińskiego juana. W takich przypadkach tylko kod USD, CAD, AUD, NZD, JPY albo CNY nie pozostawia wątpliwości.

Niektóre symbole bywają jednak czytelne lokalnie – forint węgierski zapisuje się jako Ft, korona czeska jako Kč, a izraelski szekel jako ₪. Mimo to na fakturze czy w przelewie międzynarodowym lepiej podać trzyliterowy kod ISO 4217.

Jak unikać pomyłek w oznaczeniach walut?

Przy prowadzeniu dokumentacji finansowej warto zawsze weryfikować kod z oficjalnym rejestrem ISO 4217 lub tabelą NBP. Dzięki temu zmniejszasz ryzyko błędów przy importowaniu faktur do systemów księgowych, gdzie kod dokumentu musi być jednoznaczny.

W systemach e-faktur i programach do księgowości pola walut bywają wypełniane automatycznie na podstawie kodu. Gdy pole zawiera tylko symbol graficzny, może dojść do zerowego kursu dokumentu albo błędnego przeliczenia. Dlatego warto stosować zapis taki jak EUR 978 albo USD 840.

Kod ISO 4217 zawsze wskazuje dokładnie jedną walutę, podczas gdy symbol graficzny nie jest unikatowy – dlatego w dokumentach o charakterze finansowym stosuje się trzyliterowe oznaczenia.

W praktyce wystarczy zapamiętać kody najczęściej używane w danym kraju i regionie, a w razie wątpliwości sprawdzić aktualną tabelę kursową Narodowego Banku Polskiego.