Zum Inhalt springen
RateFlowAPI

Endpunkte

Endpunkte

Auf dieser Seite

Alle Endpunkte erfordern einen X-API-Key-Header. Siehe Authentifizierung.

Erfolgreiche Antworten verwenden eine einheitliche Hülle: "success": true und ein data-Objekt. Fehlerantworten geben stattdessen "success": false mit einem error-Objekt zurück. Siehe Fehler.


Aktuelle Kurse

Rufen Sie die aktuellsten Wechselkurse für eine Basiswährung ab.

GET /v1/rates/latest
Parameter Typ Erforderlich Beschreibung
base Query Nein Basiswährungscode (z.B. EUR, USD). Standard ist EUR

Beispielanfrage:

Shell
curl -s -H "X-API-Key: IHR_API_SCHLUESSEL" "https://api.rateflowapi.com/v1/rates/latest?base=EUR"

Beispielantwort:

JSON
{
    "success": true,
    "data": {
        "base": "EUR",
        "updated_at": "2026-03-29T15:00:00Z",
        "rates": {
            "USD": 1.0821,
            "GBP": 0.8569,
            "JPY": 162.45,
            "CHF": 0.9612
        }
    }
}

Paarumrechnung

Erhalten Sie den Wechselkurs zwischen zwei Währungen, mit optionaler Betragsumrechnung.

GET /v1/rates/pair/{from}/{to}
Parameter Typ Erforderlich Beschreibung
from Pfad Ja Quellwährungscode
to Pfad Ja Zielwährungscode
amount Query Nein Umzurechnender Betrag (0 < Betrag < 1.000.000.000.000)

Beispielanfrage (mit Betrag):

Shell
curl -s -H "X-API-Key: IHR_API_SCHLUESSEL" "https://api.rateflowapi.com/v1/rates/pair/EUR/USD?amount=100"

Beispielantwort:

JSON
{
    "success": true,
    "data": {
        "base": "EUR",
        "target": "USD",
        "rate": 1.0821,
        "amount": 100,
        "converted": 108.21
    }
}

Beispielanfrage (nur Kurs):

Shell
curl -s -H "X-API-Key: IHR_API_SCHLUESSEL" "https://api.rateflowapi.com/v1/rates/pair/EUR/USD"
JSON
{
    "success": true,
    "data": {
        "base": "EUR",
        "target": "USD",
        "rate": 1.0821
    }
}

Historische Kurse

Rufen Sie Wechselkurse für ein bestimmtes vergangenes Datum ab.

GET /v1/rates/history/{from}/{to}/{date}
Parameter Typ Erforderlich Beschreibung
from Pfad Ja Basiswährungscode
to Pfad Ja Zielwährungscode
date Pfad Ja Datum im Format JJJJ-MM-TT

Wie weit die Daten zurückreichen. Die verfügbare Historie hängt von der Währung ab. Die rund 30 Währungen des Referenzkurs-Sets der Europäischen Zentralbank (EZB) haben eine tägliche Historie bis zum 4. Januar 1999. Alle anderen unterstützten Währungen haben Historie ab dem 5. Juni 2026. Eine Anfrage für ein Datum vor dem ersten verfügbaren Tag einer Währung ergibt 404 no-data-available, sofern Ihr Tarif dieses Datum erlaubt.

Beispielanfrage:

Shell
curl -s -H "X-API-Key: IHR_API_SCHLUESSEL" "https://api.rateflowapi.com/v1/rates/history/EUR/USD/2026-03-01"

Beispielantwort:

JSON
{
    "success": true,
    "data": {
        "base": "EUR",
        "target": "USD",
        "requested_date": "2026-03-01",
        "date": "2026-02-27",
        "carried_forward": true,
        "rate": 1.0794
    }
}
Feld Beschreibung
requested_date Das angefragte Datum. Wird immer zurückgegeben.
date Der Tag, an dem der zurückgegebene Kurs tatsächlich veröffentlicht wurde.
carried_forward true, wenn date vor requested_date liegt (siehe unten), false bei einem direkten Treffer.
rate Einheiten von to je einer Einheit von from am Tag date.

Tage ohne veröffentlichten Kurs. Die meisten Quellen veröffentlichen nur an Geschäftstagen; Wochenenden und Feiertage haben daher oft keinen eigenen Kurs. Liegt für das Paar am angefragten Datum kein Kurs vor, liefert die API den zuletzt gespeicherten Kurs aus den 7 Tagen davor und kennzeichnet die Antwort mit carried_forward: true sowie dem tatsächlichen Veröffentlichungstag in date. Das Beispiel oben fragt Sonntag, den 1. März 2026 an, für den kein Kurs vorliegt, und erhält den Kurs vom Freitag. Hat eine Quelle für diesen Tag veröffentlicht, wird der Kurs direkt mit carried_forward: false geliefert. Diese Regel gilt für jedes Datum gleich, ob aktuell oder historisch. Wurde in diesem 7-Tage-Fenster nichts für das Paar veröffentlicht, antwortet die API mit 404 no-data-available. Das Historienlimit des Tarifs gilt für requested_date.


Unterstützte Codes

Listen Sie alle unterstützten Währungscodes mit ihren lokalisierten Namen auf.

GET /v1/currencies
Parameter Typ Erforderlich Beschreibung
locale Query Nein Sprache für Namen: en (Standard) oder de

Beispielanfrage:

Shell
curl -s -H "X-API-Key: IHR_API_SCHLUESSEL" "https://api.rateflowapi.com/v1/currencies?locale=de"

Beispielantwort:

JSON
{
    "success": true,
    "data": {
        "currencies": {
            "EUR": "Euro",
            "USD": "US-Dollar",
            "GBP": "Britisches Pfund",
            "JPY": "Japanischer Yen",
            "CHF": "Schweizer Franken"
        }
    }
}

Erweitertes Paar

Erhalten Sie eine Paarumrechnung mit zusätzlichen Währungsmetadaten (Namen und Symbole).

GET /v1/rates/enriched/{from}/{to}
Parameter Typ Erforderlich Beschreibung
from Pfad Ja Quellwährungscode
to Pfad Ja Zielwährungscode
locale Query Nein Sprache für Namen: en (Standard) oder de

Beispielanfrage:

Shell
curl -s -H "X-API-Key: IHR_API_SCHLUESSEL" "https://api.rateflowapi.com/v1/rates/enriched/EUR/USD"

Beispielantwort:

JSON
{
    "success": true,
    "data": {
        "base": "EUR",
        "target": "USD",
        "rate": 1.0821,
        "base_detail": {
            "name": "Euro",
            "symbol": "€"
        },
        "target_detail": {
            "name": "US-Dollar",
            "symbol": "$"
        }
    }
}

Kontingent

Überprüfen Sie die aktuelle Ratenbegrenzungsnutzung und das verbleibende Kontingent Ihres Plans.

GET /v1/quota

Keine zusätzlichen Parameter erforderlich. Der API-Schlüssel bestimmt den Benutzer.

Beispielanfrage:

Shell
curl -s -H "X-API-Key: IHR_API_SCHLUESSEL" "https://api.rateflowapi.com/v1/quota"

Beispielantwort:

JSON
{
    "success": true,
    "data": {
        "plan": "Pro",
        "quota": {
            "base_limit": 50000,
            "effective_limit": 55000,
            "used": 12450,
            "remaining": 42550,
            "overflow_allowed": true,
            "overflow_percent": 10
        },
        "resets_at": "2026-04-01T00:00:00Z"
    },
    "meta": {
        "timestamp": "2026-03-29T15:00:00Z"
    }
}
Feld Beschreibung
plan Name Ihres aktuellen Plans
quota.base_limit Monatliches Anfragelimit Ihres Plans
quota.effective_limit Tatsächliches Limit (höher bei erlaubtem Overflow)
quota.used Anfragen in diesem Monat
quota.remaining Verbleibende Anfragen in diesem Monat
quota.overflow_allowed Ob Overflow über das Basislimit erlaubt ist
quota.overflow_percent Erlaubter Overflow-Prozentsatz (0-100)
resets_at ISO 8601-Zeitstempel der Kontingentrücksetzung (1. des nächsten Monats)