Endpunkte

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:

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

Beispielantwort:

{
    "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
        }
    }
}

{info} Antworten enthalten einen Cache-Control: private, max-age=86400-Header (24 Stunden).

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):

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

Beispielantwort:

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

Beispielanfrage (nur Kurs):

curl -s -H "X-API-Key: IHR_API_SCHLUESSEL" "https://api.rateflow.com/v1/rates/pair/EUR/USD"
{
    "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

{warning} Historischer Zugriff erfordert einen Pro- oder Business-Plan. Pro-Pläne sind auf 1 Jahr Geschichte begrenzt; Business-Pläne haben unbegrenzte Geschichte. Kostenlose Pläne erhalten einen 403 plan-upgrade-required-Fehler.

Beispielanfrage:

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

Beispielantwort:

{
    "success": true,
    "data": {
        "base": "EUR",
        "target": "USD",
        "date": "2026-03-01",
        "rate": 1.0794
    }
}

{info} Gibt den historischen Kurs für das angeforderte from/to-Paar am angegebenen Datum zurück. Nicht unterstützte Währungen ergeben 422 unsupported-currency; ein unterstütztes Paar ohne Kurs für dieses Datum ergibt 404 no-data-available.

{info} Historische Antworten enthalten einen Cache-Control: private, max-age=604800, immutable-Header (7 Tage).

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:

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

Beispielantwort:

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

{info} Antworten enthalten einen Cache-Control: private, max-age=2592000-Header (30 Tage).

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:

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

Beispielantwort:

{
    "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:

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

Beispielantwort:

{
    "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)