CurrencyRateAPI

Schnellstart-Tool

Sie möchten die API testen, ohne die gesamte Dokumentation durchzulesen? Gehen Sie zum Control Panel, dort finden Sie das Schnellstart-Tool – eine einfache Möglichkeit, alle verfügbaren Endpunkte mit einem einzigen Klick auszuprobieren.

Klicken Sie auf die Schaltfläche unten, um sich kostenlos zu registrieren und das Schnellstart-Tool zu nutzen.

Erste Schritte

Wichtige Begriffe und Konzepte, die Sie für die Arbeit mit der Currency Rate API benötigen:

API-Antwort

Die von CurrencyRateAPI bereitgestellten Wechselkurse sind standardmäßig in Euro angegeben. Alle Daten werden im Standard-JSON-Format zurückgegeben und können problemlos mit jeder Programmiersprache verarbeitet werden.

Beispielantwort:
Nachfolgend finden Sie eine Beispiel-API-Antwort mit einer Reihe gängiger Weltwährungen, alle relativ zur EUR-Währung und mit einem Zeitstempel, zu dem sie empfangen wurden.

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

Wie oben dargestellt, enthält die API-Antwort für Echtzeit-Wechselkurse mehrere Schlüsselfelder:

• success Zeigt an, ob die Anfrage erfolgreich war.
• base Gibt den 3-stelligen Code der für diese Anfrage verwendeten Basiswährung zurück.
• date Gibt das tatsächliche Datum zurück, für das die Wechselkurse angegeben werden (Format JJJJ-MM-TT).
• rates enthält die Liste der angeforderten Währungen und ihrer aktuellen Wechselkurse.
• last_update_unix zeigt den Zeitstempel (im Unix-Format) der zuletzt verfügbaren Daten im System an.

Verfügbare Endpunkte

CurrencyRateAPI umfasst mehrere API-Endpunkte, die jeweils spezifische Funktionen bieten. Die Verfügbarkeit bestimmter Endpunkte hängt von Ihrem Abonnementplan ab.

• Endpunkt der Währungsliste. Dieser Endpunkt gibt die vollständige Liste aller unterstützten Währungen zurück. /api/codes (Alternative: /api/currencies)
• Endpunkt der aktuellen Kurse. Dieser Endpunkt liefert Echtzeit-Wechselkursdaten für alle unterstützten Währungen. /api/latest
• Endpunkt der historischen Zinssätze. Dieser Endpunkt liefert historische Wechselkursdaten für ein bestimmtes Datum. /api/YYYY-MM-DD (Alternative: /api/history?date=YYYY-MM-DD). Historische Daten sind ab dem 4. Januar 1999 verfügbar.

Wechselkursmethodik

Um die Genauigkeit und Konsistenz der Daten zu gewährleisten, befolgt CurrencyRateAPI eine strenge Methodik für die Verwaltung und Bereitstellung von Wechselkursen:

• Mittelmarktzinsen: Standardmäßig liefert die API mid -Zinssätze. Diese stellen das arithmetische Mittel zwischen den Marktpreisen für Kauf ( bid ) und Verkauf ( ask ) bzw. die offiziellen Referenzzinssätze der Zentralbanken dar.
• Abschluss des Tagesgeschäfts (EOD): Die von der API bereitgestellten historischen Kurse werden zum Ende des Tages in UTC (Koordinierte Weltzeit) finalisiert.
• Kreuzkursberechnung: Für Währungspaare, die nicht direkt aus unseren Quellen verfügbar sind, berechnet das System automatisch hochpräzise Kreuzkurse unter Verwendung der wichtigsten globalen Währungen als Brücke (Dreh- und Angelpunkt).
• Intelligenter Ausweichmechanismus: Falls für ein angefordertes Datum keine Daten verfügbar sind (z. B. aufgrund von Marktschließungen an Wochenenden oder Feiertagen), sucht das System automatisch nach dem aktuellsten gültigen Kurs innerhalb eines gleitenden 8-Tage-Fensters .
• Hohe Präzision: Um Rundungsfehler bei Finanzberechnungen zu vermeiden, werden Wechselkurse mit bis zu 18 Dezimalstellen gespeichert und verarbeitet.

Endpunkte

Unterstützte Symbole Endpunkt

https://currencyrateapi.com/api/codes

Dieser Endpunkt gibt die vollständige Liste aller unterstützten Währungen zurück. Alternativ können Sie auch den Alias /api/currencies verwenden.

Eine für Menschen lesbare Liste aller unterstützten Währungen finden Sie auch auf unserer Seite „Unterstützte Währungen“ .

Basiswährungen: Standardmäßig geben einige andere Endpunkte (wie /latest und /{YYYY-MM-DD}) nur eine begrenzte Auswahl der wichtigsten globalen Währungen zurück, um den Datenverkehr zu minimieren. Diese „Basis“-Währungen sind:

USD, EUR, GBP, CHF, JPY, CAD, AUD, NZD, SEK, NOK, DKK, ISK, PLN, CZK, HUF, RON, HRK, RSD,
MKD, MDL, TRY, SGD, HKD, KRW, TWD, ILS, AED, SAR, QAR, KWD, BHD, OMR, ZAR

API-Antwort:

{
    "success": true,
    "currencies": {
        "EUR": {
            "entity": "EUROPEAN UNION",
            "currency": "Euro",
            "alphabetic_code": "EUR",
            "numeric_code": 978,
            "minor_unit": 2,
            "title": "Euro",
            "symbol": "€",
            "data_from": "1999-01-04"
        },
        "BTC": {
            "entity": "CRYPTOCURRENCY",
            "currency": "Bitcoin",
            "alphabetic_code": "BTC",
            "title": "Bitcoin",
            "symbol": "₿",
            "is_crypto": true,
            "data_from": "2024-03-02"
        },
        [...]
    }
}

Antwortobjekte:

Aktuelle Preise Endpunkt

https://currencyrateapi.com/api/latest?
    base=USD&
    quote=GBP,JPY,EUR

Anfrageparameter:

API-Antwort:

{
    "success": true,
    "base": "usd",
    "date": "2026-01-22",
    "rates": {
        "gbp": "0.74350935478637",
        "jpy": "158.00358051914",
        "eur": "0.8518613169776"
    },
    "last_update_unix": "1769067006"
}

Antwortobjekte:

Endpunkt der historischen Zinssätze

https://currencyrateapi.com/api/2025-08-25?
    base=EUR&
    quote=USD,GBP,CAD

Alternatives Format: /api/history?date=2025-08-25...

Anfrageparameter:

API-Antwort:

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

Antwortobjekte:

Beispielcode

PHP (cURL)

// Set API Endpoint (can be 'latest' or a date 'YYYY-MM-DD')
$endpoint = 'latest';

// Initialize CURL:
$ch = curl_init('https://currencyrateapi.com/api/'.$endpoint.'?base=USD"e=GBP,JPY');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Store the data:
$json = curl_exec($ch);
curl_close($ch);

// Decode JSON response:
$exchangeRates = json_decode($json, true);

// Access the exchange rate values, e.g. GBP:
echo $exchangeRates['rates']['GBP'];

JavaScript (fetch)

 // Set endpoint (can be 'latest' or a date 'YYYY-MM-DD')
const endpoint = 'latest';
const params = '?base=USD"e=GBP,JPY';

// Get exchange rates via the selected endpoint:
fetch('https://currencyrateapi.com/api/' + endpoint + params)
    .then(response => {
        return response.json();
    })
    .then(json => {

        // Exchange rate data is stored in json.rates
        console.log(json.rates.GBP);

        // Timestamp can be accessed in json.last_update_unix
        console.log(json.last_update_unix);
    })
    .catch(error => {
        console.error('Fetch error:', error);
    });