ISO 4217 Währungscodes: Der vollständige Leitfaden für Entwickler

Wenn Sie jemals ein Zahlungssystem entwickelt, eine Wechselkurs-API integriert oder Preise in mehreren Währungen angezeigt haben, sind Sie bereits auf ISO 4217 Währungscodes gestoßen — ob Sie es wussten oder nicht. Diese dreistelligen Codes wie USD, EUR, JPY und GBP sind die universelle Sprache des Geldes in der Softwareentwicklung. Zu verstehen, wie sie funktionieren, woher sie kommen und wie man sie korrekt verwendet, ist für jeden Entwickler, der Finanzanwendungen erstellt, unerlässlich.

Dieser Leitfaden deckt alles ab, was Sie wissen müssen: die Struktur der Währungscodes, eine Referenzliste der meistgenutzten Währungen der Welt, den Umgang mit Untereinheiten und Sondercodes sowie die Integration mit der Finexly API-Dokumentation für Echtzeit-Wechselkurse.

Was ist ISO 4217?

ISO 4217 ist ein internationaler Standard, der von der Internationalen Organisation für Normung (ISO) veröffentlicht wurde und Codes zur Darstellung von Weltwährungen definiert. Erstmals 1978 eingeführt, wird er heute universell in Bankensystemen, Finanzsoftware, E-Commerce-Plattformen, Zahlungsdienstleistern und Wechselkurs-APIs verwendet.

Der Standard dient drei wesentlichen Zwecken:

• Mehrdeutigkeiten beseitigen — „Dollar" kann den US-Dollar, kanadischen Dollar, australischen Dollar oder Dutzende andere bedeuten. USD, CAD, AUD sind eindeutig.
• Automatisierte Verarbeitung ermöglichen — Sowohl alphabetische als auch numerische Codes ermöglichen Systemen mit unterschiedlicher Zeichensatz-Unterstützung die zuverlässige Verarbeitung von Währungsdaten.
• Internationale Interoperabilität unterstützen — Jedes konforme System kann Finanzdaten ohne benutzerdefinierte Zuordnungen austauschen.

Der Standard wird von der SIX Group im Auftrag der ISO und des Schweizerischen Verbands für Normierung gepflegt.

Die Code-Struktur verstehen

Alphabetische Codes (Alpha-3)

Jeder alphabetische ISO 4217 Code besteht aus genau drei Großbuchstaben ASCII. Die Struktur ist bewusst gewählt:

• Erste zwei Buchstaben — Abgeleitet vom ISO 3166-1 alpha-2 Ländercode (z.B. US für die USA, JP für Japan, GB für Großbritannien)
• Dritter Buchstabe — Üblicherweise der erste Buchstabe des Währungsnamens (z.B. D für Dollar, Y für Yen, P für Pound)

USD = Vereinigte Staaten (US) + Dollar (D). JPY = Japan (JP) + Yen (Y). GBP = Großbritannien (GB) + Pfund (P).

Numerische Codes

Jede Währung hat auch einen dreistelligen numerischen Code (z.B. 840 für USD, 978 für EUR, 826 für GBP). Diese Codes sind besonders nützlich in Systemen, die keine lateinischen Zeichen verarbeiten.

Untereinheiten (Dezimalstellen)

ISO 4217 gibt auch die Anzahl der Dezimalstellen (Untereinheiten) für jede Währung an:

Referenztabelle der wichtigsten Weltwährungen

Amerika

Europa

Asien-Pazifik

Verwendung der Finexly API mit Währungscodes

Die Finexly API unterstützt mehr als 170 ISO 4217 Währungscodes. So rufen Sie Echtzeit-Wechselkurse ab:

cURL

curl "https://finexly.com/api/latest?base=USD&symbols=EUR,GBP,JPY,CAD,AUD" \
  -H "Authorization: Bearer IHR_API_SCHLUESSEL"

JavaScript

const BASE_CURRENCY = 'USD';
const TARGET_CURRENCIES = ['EUR', 'GBP', 'JPY', 'CNY', 'AUD'];

async function getExchangeRates() {
  const symbols = TARGET_CURRENCIES.join(',');
  const url = `https://finexly.com/api/latest?base=${BASE_CURRENCY}&symbols=${symbols}`;

  const response = await fetch(url, {
    headers: { 'Authorization': 'Bearer IHR_API_SCHLUESSEL' }
  });

  const data = await response.json();
  return data.rates;
}

getExchangeRates().then(rates => {
  console.log(`1 USD = ${rates.EUR} EUR`);
  console.log(`1 USD = ${rates.JPY} JPY`);
});

Python

import requests

API_KEY = "IHR_API_SCHLUESSEL"
BASE = "USD"
TARGETS = ["EUR", "GBP", "JPY", "CNY", "BRL"]

response = requests.get(
    "https://finexly.com/api/latest",
    params={"base": BASE, "symbols": ",".join(TARGETS)},
    headers={"Authorization": f"Bearer {API_KEY}"}
)

data = response.json()
for code, rate in data["rates"].items():
    print(f"1 {BASE} = {rate} {code}")

Währungsformatierung nach Locale

function formatCurrency(amount, currencyCode, locale = 'de-DE') {
  return new Intl.NumberFormat(locale, {
    style: 'currency',
    currency: currencyCode,
  }).format(amount);
}

console.log(formatCurrency(1234.56, 'USD', 'en-US')); // $1,234.56
console.log(formatCurrency(1234.56, 'EUR', 'de-DE')); // 1.234,56 €
console.log(formatCurrency(1234.56, 'GBP', 'en-GB')); // £1,234.56
console.log(formatCurrency(1500, 'JPY', 'ja-JP'));     // ¥1.500

Häufige Entwicklerfehler mit Währungscodes

Fehler 1: Währungen als Gleitkommazahl speichern

# ❌ FALSCH — Gleitkomma-Fehler werden Probleme verursachen
total = 19.99 * 1.20  # 23.988000000000003

# ✅ RICHTIG — verwenden Sie ganze Zahlen in Untereinheiten
price_cents = 1999  # 19,99 € als Cent gespeichert

Fehler 2: Annehmen, dass alle Währungen 2 Dezimalstellen haben

// ❌ FALSCH
formatJPY(1500)  // "1500.00 JPY" — FALSCH

// ✅ RICHTIG
new Intl.NumberFormat('ja-JP', { style: 'currency', currency: 'JPY' }).format(1500); // ¥1.500

Häufig gestellte Fragen

Was ist der Unterschied zwischen einem Währungscode und einem Währungssymbol? Ein Währungscode ist ein standardisierter dreistelliger Bezeichner (z.B. USD) gemäß ISO 4217, während ein Währungssymbol eine typografische Kurzform ist (z.B. $, €, £). Symbole variieren je nach Locale. Währungscodes sind immer eindeutig.

Wie viele ISO 4217 Währungscodes gibt es? Ab 2026 gibt es etwa 180 aktive Währungscodes. Finexly unterstützt mehr als 170 davon für Echtzeit-Wechselkursabfragen.

Kann ich Währungscodes mit dem kostenlosen Finexly-Plan verwenden? Ja — der kostenlose Plan bietet Zugang zu allen unterstützten ISO 4217 Währungscodes mit bis zu 1.000 API-Anfragen pro Monat.

Warum hat der Japanische Yen (JPY) keine Dezimalstellen? Der Yen wurde anders dezimalisiert als die meisten Währungen. Obwohl er technisch eine Untereinheit namens „Sen" hat (1/100 Yen), werden Sen in der Praxis nicht mehr verwendet.

Welchen Währungscode soll ich für den Euro in allen Eurozone-Ländern verwenden? Verwenden Sie immer EUR — es ist derselbe Währungscode, egal ob die Transaktion in Deutschland, Frankreich, Spanien, Italien oder einem anderen Eurozone-Land stattfindet.

Bereit, Echtzeit-Wechselkurse in Ihr Projekt zu integrieren? Holen Sie sich Ihren kostenlosen Finexly API-Schlüssel — keine Kreditkarte erforderlich. Starten Sie mit 1.000 kostenlosen Anfragen pro Monat und greifen Sie auf Echtzeit-Kurse für mehr als 170 ISO 4217 Währungen zu. Upgraden Sie, wenn Sie wachsen.