In this Article
Währungsumrechnung wirkt wie ein gelöstes Problem mit einer API davor. Komplikationen treten zum ersten Mal auf, wenn sich Finanzabteilung und Produktteam bei einer Zahl nicht einig sind. Die Ursache ist fast immer, dass sie unterschiedliche Kurse verwenden und beide glauben, ihr Kurs sei der Kurs.
Dieser Leitfaden trennt die vier Kursarten, erklärt, woher jede stammt, und gibt dir eine Regel an die Hand, mit der du später eine begründete Wahl treffen kannst.
Wichtige Fakten
- Es gibt keinen einheitlichen Wechselkurs. Währungen werden außerbörslich gehandelt, daher ist jeder veröffentlichte Kurs die Sicht einer Quelle zu einem bestimmten Zeitpunkt.
- Vier Kursarten werden regelmäßig verwechselt, und die falsche zu verwenden ist die häufigste Ursache für Abstimmungsdifferenzen in einem Finanzsystem.
- Zentralbank-Referenzkurse werden einmal täglich veröffentlicht und sind stabil sowie zitierfähig. Das macht sie zur richtigen Wahl für die Buchhaltung und zur falschen für die Preisgestaltung.
- Der Kurs, den dein Kunde zahlt, enthält eine Marge, daher stimmt ein Mittelkurs nie mit einem Kartenauszug überein. Ihn als Preis darzustellen, führt zu Support-Tickets.
- Speichere immer Kurs, Quelle und Zeitstempel zusammen mit jedem umgerechneten Betrag, sonst lässt sich die Umrechnung später nicht reproduzieren.
Warum gibt es keinen einheitlichen Wechselkurs?
Weil wichtige Währungen außerbörslich zwischen Institutionen statt an einer zentralen Börse gehandelt werden. Es gibt keine Schlussglocke und keinen offiziellen Kursdruck, daher ist jede veröffentlichte Zahl die Aggregation einer bestimmten Quelle zu einem bestimmten Zeitpunkt.
Das hat eine direkte Konsequenz für Software: Zwei APIs, die im Abstand von einer Sekunde abgefragt werden, können zu Recht unterschiedliche Zahlen zurückgeben, und keine davon ist fehlerhaft. Das daraus entstehende Abstimmungsproblem löst du nicht, indem du eine bessere Quelle findest. Du löst es, indem du festlegst, welche Quelle für welchen Zweck maßgeblich ist, und diese Entscheidung bei jedem gespeicherten Betrag dokumentierst.
Welche Kursarten gibt es?
Vier mit unterschiedlichen Zwecken, und jede Wechselkurs-API gibt eine davon zurück. Wir nennen das das 4-teilige Kursmodell.
| Art | Was sie ist | Verwendung |
|---|---|---|
| 1. Mittelkurs | Mittelwert zwischen Geld- und Briefkurs über wichtige Handelsplätze hinweg | Anzeige, Analysen, interner Vergleich |
| 2. Zentralbank-Referenzkurs | Ein täglich veröffentlichter Referenzkurs, der zu einer festgelegten Zeit fixiert wird | Buchhaltung, Steuern, Verträge, alles Prüfbare |
| 3. Transaktionskurs | Was ein Zahlungsanbieter oder Kartennetzwerk tatsächlich berechnet, einschließlich Marge | Abgleich mit tatsächlichen Abrechnungen |
| 4. Garantierter Kurs | Ein von einem Anbieter für einen Zeitraum festgeschriebener Kurs mit einer Marge für diese Garantie | Preisgestaltung im Checkout, bei der sich der Gesamtbetrag nicht ändern darf |
Der klassische Fehler besteht darin, im Checkout einen Mittelkurs anzuzeigen und zum Transaktionskurs abzurechnen. Der Kunde sieht eine Zahl und es wird ihm eine andere berechnet. Die Differenz ist vollständig vorhersehbar und vollständig vermeidbar.
Wie sollte ein Kurs ausgewählt und gespeichert werden?
| Zweck | Verwende diesen Kurs, wenn | Vermeide ihn, wenn |
|---|---|---|
| Finanzberichterstattung | Zentralbank-Referenzkurs, datiert | Du untertägige Genauigkeit brauchst, die Referenzkurse nicht bieten |
| Nutzern angezeigte Produktpreise | Garantierter Kurs oder Transaktionskurs, mit ausgewiesener Marge | Du den Mittelkurs verwendest, der nicht mit der Belastung übereinstimmt |
| Analysen und Dashboards | Mittelkurs, durchgängig, aus einer Quelle | Du Quellen zwischen Diagrammen mischst, was künstliche Abweichungen erzeugt |
| Historischer Vergleich | Der zum jeweiligen Zeitpunkt gespeicherte Kurs | Du die Historie zum heutigen Kurs neu umrechnest, was die Vergangenheit umschreibt |
Eine Speicherregel deckt die meisten Probleme ab: Speichere bei jedem umgerechneten Betrag den ursprünglichen Betrag, die Währung, den Kurs, die Quelle und den Zeitstempel dauerhaft. Systeme, die nur den umgerechneten Wert speichern, können nicht beantworten, warum sich eine Zahl geändert hat, und diese Frage kommt irgendwann immer.
Welche Rolle spielt die Datenerhebung, und wo liegen die Grenzen?
Verwende für Referenzkurse offizielle Quellen. Zentralbanken veröffentlichen sie offen und in maschinenlesbarer Form. Eine Finanzwebsite nach einer Zahl zu scrapen, die eine Zentralbank als API veröffentlicht, hat nur Nachteile: geringere Zuverlässigkeit, schlechtere Herkunftsnachweise und ein unnötiges Problem mit Nutzungsbedingungen.
Für Marktdaten gelten Lizenzen. Live-Kurse für Institutionen sind ein lizenziertes Produkt mit Bedingungen für die Weiterverbreitung, genauso wie Börsendaten für Aktien. Ein kostenloser Anzeigedatenstrom ist nur selten für den Weiterverkauf oder die kundenseitige Nutzung lizenziert.
Krypto-Paare sind ein anderes Problem. Sie werden an vielen Handelsplätzen zu tatsächlich unterschiedlichen Preisen gehandelt. Ein einzelner Kurs ist daher eine redaktionelle Entscheidung darüber, welche Handelsplätze einbezogen und wie sie gewichtet werden. Sage, welche Entscheidung du getroffen hast.
Wo eine an ein Land gebundene Anfrage hilft, ist ein enger Anwendungsfall: Einige offizielle Portale und regionale Finanzwebsites beschränken oder lokalisieren den Zugriff nach Herkunft. DataImpulse Residential deckt das für $1 pro GB in 195 Ländern ab. Der Kurs selbst sollte vom offiziellen Herausgeber stammen.
Verwandt: Lizenzen für Marktdaten, ist Web Scraping legal.
Häufig gestellte Fragen
Warum geben zwei Währungs-APIs unterschiedliche Kurse zurück?
Weil wichtige Währungen außerbörslich und ohne zentrale Börse gehandelt werden, ist jeder veröffentlichte Kurs die Aggregation einer Quelle zu einem bestimmten Zeitpunkt. Zwei APIs, die im Abstand von einer Sekunde abgefragt werden, können zu Recht voneinander abweichen. Deshalb muss die maßgebliche Quelle je Zweck gewählt und dokumentiert werden.
Welchen Wechselkurs sollte ich für die Buchhaltung verwenden?
Einen Zentralbank-Referenzkurs, der mit seinem Datum gespeichert wird. Er wird einmal täglich zu einer festen Zeit veröffentlicht, ist stabil und zitierfähig und entspricht dem, was Prüfer erwarten. Für die Preisgestaltung im Checkout ist er die falsche Wahl, weil er nicht dem entspricht, was dem Kunden tatsächlich berechnet wird.
Warum berechnet die Bank meines Kunden einen anderen Betrag?
Weil der Mittelkurs keine Marge enthält, eine tatsächliche Transaktion aber schon. Kartennetzwerke und Zahlungsanbieter verwenden ihren eigenen Kurs zuzüglich einer Marge. Wer im Checkout den Mittelkurs anzeigt, garantiert damit eine Abweichung zwischen angezeigten und berechneten Beträgen.
Sollte ich Wechselkurse von Finanzwebsites scrapen?
Nein. Zentralbanken veröffentlichen Referenzkurse offen in maschinenlesbarer Form, und institutionelle Marktkurse sind lizenzierte Produkte mit Bedingungen für die Weiterverbreitung. Scraping liefert schlechtere Herkunftsnachweise und Zuverlässigkeit für Daten, die bereits ordnungsgemäß verfügbar sind.
Was sollte ich zusammen mit einem umgerechneten Betrag speichern?
Den ursprünglichen Betrag und die Währung, den angewendeten Kurs, die Quelle dieses Kurses und den Zeitstempel. Ohne alle fünf Angaben kann eine historische Zahl nicht reproduziert oder erklärt werden. Eine gespeicherte Historie zum aktuellen Kurs neu umzurechnen, schreibt frühere Berichte stillschweigend um.
Erreiche offizielle Herausgeber aus der richtigen Region
Einige offizielle und regionale Finanzportale lokalisieren oder beschränken den Zugriff nach Herkunft. DataImpulse Residential Proxys bieten an ein Land gebundene Ausgänge für $1 pro GB in 195 Ländern. Erstelle ein Konto und prüfe eine Quelle aus ihrer eigenen Region.
Verwandt: APIs für Börsendaten · öffentliche Datenportale · ist Web Scraping legal.
Zuletzt aktualisiert: 17. September 2026.