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:
curl -s -H "X-API-Key: IHR_API_SCHLUESSEL" "https://api.rateflowapi.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
}
}
}
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.rateflowapi.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.rateflowapi.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 |
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:
curl -s -H "X-API-Key: IHR_API_SCHLUESSEL" "https://api.rateflowapi.com/v1/rates/history/EUR/USD/2026-03-01"
Beispielantwort:
{
"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:
curl -s -H "X-API-Key: IHR_API_SCHLUESSEL" "https://api.rateflowapi.com/v1/currencies?locale=de"
Beispielantwort:
{
"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:
curl -s -H "X-API-Key: IHR_API_SCHLUESSEL" "https://api.rateflowapi.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.rateflowapi.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) |