API-Dokumentation

Überblick

Lume Exchange Rates verbindet Kursvergleich, Umrechnung und historische Trends für Reisen, internationale Preise und Produkte.

Die konfigurierte Quelle ist Externer Wechselkursanbieter. Antworten nennen Quelle und Veröffentlichungszeit. Verfügbare Währungen stammen aus tatsächlichen Daten.

Schnellstart

Lesen Sie zuerst den Währungskatalog und wählen Sie dann anchor und targets. Feldnamen und Währungscodes sind in allen Sprachen gleich.

curl --request GET 'https://lumeexchangerates.com/v1/quotes?anchor=USD&targets=EUR,JPY'

const response = await fetch('/v1/quotes?anchor=USD&targets=EUR,JPY', {
  credentials: 'same-origin'
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { meta, anchor, data } = await response.json();
console.log(anchor, meta.as_of, data);

Das Browserbeispiel läuft unter demselben Ursprung. cURL- und Serveranfragen an private Websites benötigen Zugriffsrechte; die URL umgeht keine Anmeldung.

Zugriff und Authentifizierung

Zugriff über Website-Berechtigungen und Browser-Sitzung. Kunden-API-Schlüssel, Kunden-Bearer-Authentifizierung und eine öffentliche Cross-Origin-API sind noch nicht verfügbar. Die Anbieter-App-ID bleibt auf dem Server.

Authorization: Token wird nur vom Lume Exchange Rates-Server für Externer Wechselkursanbieter verwendet und authentifiziert keine Kunden. Die Zugriffskontrolle kann HTML oder Weiterleitungen liefern: Prüfen Sie HTTP-Status und Content-Type.

Endpunkte

/v1 bietet kompakte Abfragen; /api liefert die Verträge für aktuelle Kurse, Verlauf und Umrechnung der Website. Standardwerte und Antwortformate unterscheiden sich.

GET /v1/currencies

Alle Symbole mit aktuellen Kursen und Anbieternamen. Einschließlich verfügbarer Alternativwährungen und Metalle.

Parameter: —

curl --request GET 'https://lumeexchangerates.com/v1/currencies'

Die Werte und Datumsangaben zeigen das Antwortformat, keine aktuellen Kurse. Listen können gekürzt sein. Aktuelle Daten erhalten Sie im API-Explorer.

{
  "meta": {
    "mode": "provider",
    "source": "Externer Wechselkursanbieter",
    "source_url": "https://openexchangerates.org/",
    "as_of": "2026-01-01T00:00:00.000Z",
    "fetched_at": "2026-01-01T00:00:05.000Z",
    "currency_count": 3,
    "includes_alternative": true,
    "refresh_interval_seconds": 300,
    "provider_plan": "Unlimited",
    "notice": "Illustrative response; not live rates."
  },
  "data": [
    {
      "code": "USD",
      "name": "United States Dollar"
    },
    {
      "code": "EUR",
      "name": "Euro"
    },
    {
      "code": "JPY",
      "name": "Japanese Yen"
    }
  ]
}

GET /v1/quotes

Basissymbol; Standardwert ist USD. Jedes aktuelle Anbietersymbol wird akzeptiert.

curl --request GET 'https://lumeexchangerates.com/v1/quotes?anchor=USD&targets=EUR,JPY'

Die Werte und Datumsangaben zeigen das Antwortformat, keine aktuellen Kurse. Listen können gekürzt sein. Aktuelle Daten erhalten Sie im API-Explorer.

{
  "meta": {
    "mode": "provider",
    "source": "Externer Wechselkursanbieter",
    "source_url": "https://openexchangerates.org/",
    "as_of": "2026-01-01T00:00:00.000Z",
    "fetched_at": "2026-01-01T00:00:05.000Z",
    "currency_count": 3,
    "includes_alternative": true,
    "refresh_interval_seconds": 300,
    "provider_plan": "Unlimited",
    "notice": "Illustrative response; not live rates."
  },
  "anchor": "USD",
  "data": [
    {
      "currency": "EUR",
      "value": 0.9
    },
    {
      "currency": "JPY",
      "value": 150
    }
  ]
}

Beispiel: /v1/quotes?anchor=EUR&targets=USD,JPY. value sind Zieleinheiten je Basiseinheit. Doppelte targets werden entfernt. Leere, kleingeschriebene oder nicht verfügbare Symbole liefern 400.

GET /v1/exchange

Nicht negativer numerischer Betrag für die Umrechnung.

curl --request GET 'https://lumeexchangerates.com/v1/exchange?from=USD&to=EUR&quantity=100'

Die Werte und Datumsangaben zeigen das Antwortformat, keine aktuellen Kurse. Listen können gekürzt sein. Aktuelle Daten erhalten Sie im API-Explorer.

{
  "meta": {
    "mode": "provider",
    "source": "Externer Wechselkursanbieter",
    "source_url": "https://openexchangerates.org/",
    "as_of": "2026-01-01T00:00:00.000Z",
    "fetched_at": "2026-01-01T00:00:05.000Z",
    "currency_count": 3,
    "includes_alternative": true,
    "refresh_interval_seconds": 300,
    "provider_plan": "Unlimited",
    "notice": "Illustrative response; not live rates."
  },
  "data": {
    "from": "USD",
    "to": "EUR",
    "quantity": 100,
    "rate": 0.9,
    "result": 90
  }
}

Beispiel: /v1/exchange?from=USD&to=EUR&quantity=100. Geben Sie from und to immer an. Diese ältere GET-Route verwendet standardmäßig KRW als Ziel. Leere Werte, negative Zahlen, NaN, Unendlich und Ergebnisüberläufe liefern 400.

GET /api/rates/latest

Zuletzt veröffentlichter Kurs

Parameter: —

curl --request GET 'https://lumeexchangerates.com/api/rates/latest'

Die Werte und Datumsangaben zeigen das Antwortformat, keine aktuellen Kurse. Listen können gekürzt sein. Aktuelle Daten erhalten Sie im API-Explorer.

{
  "meta": {
    "provider": "Externer Wechselkursanbieter",
    "kind": "latest_published",
    "provider_timestamp": 1767225600,
    "published_at": "2026-01-01T00:00:00.000Z",
    "expected_interval_seconds": 300,
    "lag_seconds": 5,
    "stale": false,
    "timezone": "Asia/Seoul",
    "fetched_at": "2026-01-01T00:00:05.000Z",
    "persistent_storage": false
  },
  "data": {
    "base": "USD",
    "rates": {
      "USD": 1,
      "EUR": 0.9,
      "JPY": 150
    }
  }
}

GET /api/currencies

Währung

curl --request GET 'https://lumeexchangerates.com/api/currencies?lang=en'

Die Werte und Datumsangaben zeigen das Antwortformat, keine aktuellen Kurse. Listen können gekürzt sein. Aktuelle Daten erhalten Sie im API-Explorer.

{
  "meta": {
    "provider": "Externer Wechselkursanbieter",
    "kind": "latest_published",
    "provider_timestamp": 1767225600,
    "published_at": "2026-01-01T00:00:00.000Z",
    "expected_interval_seconds": 300,
    "lag_seconds": 5,
    "stale": false,
    "timezone": "Asia/Seoul",
    "fetched_at": "2026-01-01T00:00:05.000Z",
    "persistent_storage": false
  },
  "data": [
    {
      "code": "USD",
      "name": "US Dollar"
    },
    {
      "code": "EUR",
      "name": "Euro"
    }
  ]
}

Währungsnamen werden mit Intl.DisplayNames lokalisiert. Unbekannte Anlagen behalten ihren Code. Es werden nur Symbole der aktuellen Daten ausgegeben.

GET /api/rates/history

Historische Tageskurse liefert /v1/history, Zeiträume liefert /v1/series.

curl --request GET 'https://lumeexchangerates.com/api/rates/history?from=USD&to=EUR&period=1W'

Die Werte und Datumsangaben zeigen das Antwortformat, keine aktuellen Kurse. Listen können gekürzt sein. Aktuelle Daten erhalten Sie im API-Explorer.

{
  "meta": {
    "kind": "utc_daily",
    "from": "USD",
    "to": "EUR",
    "period": "1W",
    "provider": "Externer Wechselkursanbieter",
    "persistent_storage": false
  },
  "data": [
    {
      "time": "2026-01-01",
      "value": 0.9
    },
    {
      "time": "2026-01-02",
      "value": 0.91
    }
  ]
}

1W beginnt vor sieben Tagen; 1M, 3M und 1Y sind Kalenderzeiträume. Tagesdaten enden gestern; der laufende UTC-Tag bleibt ausgeschlossen. Monatsenden und Schaltjahre werden angepasst. Längere Zeiträume werden nach Kalendermonaten aufgeteilt, sortiert zusammengeführt und dedupliziert.

{
  "meta": {
    "kind": "intraday",
    "persistent_storage": false
  },
  "data": []
}

Ohne Erfassungsdienst liefert 1D HTTP 200 mit leerer Liste. Das ist weder ein Fehler noch Minutendaten. In historischen Zeiträumen nicht verfügbare Währungen können fehlschlagen.

GET /api/rates/previous

Vorheriger UTC-Tag

curl --request GET 'https://lumeexchangerates.com/api/rates/previous?from=USD&to=EUR'

Die Werte und Datumsangaben zeigen das Antwortformat, keine aktuellen Kurse. Listen können gekürzt sein. Aktuelle Daten erhalten Sie im API-Explorer.

{
  "meta": {
    "kind": "utc_daily",
    "reference_date": "2026-01-01",
    "reference_timestamp": "2026-01-01T23:59:59Z"
  },
  "data": {
    "from": "USD",
    "to": "EUR",
    "rate": 0.9,
    "rates": {
      "USD": 1,
      "EUR": 0.9
    }
  }
}

Verglichen wird mit der Referenz des vorherigen UTC-Tages. reference_timestamp ist das logische Tagesende, nicht die tatsächliche Veröffentlichungszeit. Prozentänderung: (aktuell − Referenz) / Referenz × 100.

POST /api/convert

Währungsrechner

curl --request POST 'https://lumeexchangerates.com/api/convert' \
  --header 'Content-Type: application/json' \
  --data '{"amount":100,"from":"USD","to":"EUR"}'

Die Werte und Datumsangaben zeigen das Antwortformat, keine aktuellen Kurse. Listen können gekürzt sein. Aktuelle Daten erhalten Sie im API-Explorer.

{
  "meta": {
    "provider": "Externer Wechselkursanbieter",
    "kind": "latest_published",
    "provider_timestamp": 1767225600,
    "published_at": "2026-01-01T00:00:00.000Z",
    "expected_interval_seconds": 300,
    "lag_seconds": 5,
    "stale": false,
    "timezone": "Asia/Seoul",
    "fetched_at": "2026-01-01T00:00:05.000Z",
    "persistent_storage": false
  },
  "data": {
    "amount": 100,
    "from": "USD",
    "to": "EUR",
    "rate": 0.9,
    "result": 90
  }
}

Senden Sie amount als JSON-Zahl; die Zeichenfolge "100" liefert 400. Symbole müssen im aktuellen Snapshot existieren. Dieser Endpunkt rechnet nur und führt keine Überweisung oder Transaktion aus.

GET /v1/history

Historische Tageskurse liefert /v1/history, Zeiträume liefert /v1/series.

curl --request GET 'https://lumeexchangerates.com/v1/history?date=2026-01-01&anchor=EUR&targets=USD,JPY'

Die Werte und Datumsangaben zeigen das Antwortformat, keine aktuellen Kurse. Listen können gekürzt sein. Aktuelle Daten erhalten Sie im API-Explorer.

{
  "meta": {
    "date": "2026-01-01",
    "published_at": "2026-01-01T23:00:00Z",
    "partial_day": false
  },
  "anchor": "EUR",
  "data": [
    {
      "currency": "USD",
      "value": 1.1
    }
  ]
}

GET /v1/series

Historische Tageskurse liefert /v1/history, Zeiträume liefert /v1/series.

curl --request GET 'https://lumeexchangerates.com/v1/series?start=2026-01-01&end=2026-01-07&anchor=USD&targets=EUR'

Die Werte und Datumsangaben zeigen das Antwortformat, keine aktuellen Kurse. Listen können gekürzt sein. Aktuelle Daten erhalten Sie im API-Explorer.

{
  "meta": {
    "start": "2026-01-01",
    "end": "2026-01-02",
    "timezone": "UTC",
    "count": 2
  },
  "anchor": "USD",
  "data": [
    {
      "date": "2026-01-01",
      "rates": [
        {
          "currency": "EUR",
          "value": 0.9
        }
      ]
    },
    {
      "date": "2026-01-02",
      "rates": [
        {
          "currency": "EUR",
          "value": 0.91
        }
      ]
    }
  ]
}

OHLC über /v1/candles erfordert die Berechtigung des Datenanbieters. Prüfen Sie /v1/capabilities; der konfigurierte Tarif bestimmt die Verfügbarkeit.

{
  "timezone": "UTC",
  "date_bounds": "inclusive",
  "max_days": 366,
  "upstream_chunk": "calendar_month"
}

GET /v1/candles

OHLC über /v1/candles erfordert die Berechtigung des Datenanbieters. Prüfen Sie /v1/capabilities; der konfigurierte Tarif bestimmt die Verfügbarkeit.

curl --request GET 'https://lumeexchangerates.com/v1/candles?start=2026-01-01T00%3A00%3A00Z&period=1d&anchor=USD&targets=EUR'

Die Werte und Datumsangaben zeigen das Antwortformat, keine aktuellen Kurse. Listen können gekürzt sein. Aktuelle Daten erhalten Sie im API-Explorer.

{
  "meta": {
    "start": "2026-01-01T00:00:00Z",
    "end": "2026-01-01T23:59:59Z",
    "period": "1d"
  },
  "anchor": "USD",
  "data": [
    {
      "currency": "EUR",
      "open": 0.9,
      "high": 0.92,
      "low": 0.89,
      "close": 0.91,
      "average": 0.905
    }
  ]
}

{
  "source": "provider_ohlc",
  "synthetic": false,
  "cross_rate_ohlc": false,
  "max_age": {
    "1m": "1h",
    "5m": "24h",
    "15m": "24h",
    "30m": "32d",
    "1h": "32d"
  },
  "alignment_minutes": {
    "5m": 5,
    "15m": 15,
    "30m": 30,
    "1h": 30,
    "12h": 30,
    "1d": 30
  },
  "calendar_alignment": {
    "1w": "00:00 UTC",
    "1mo": "YYYY-MM-01T00:00:00Z"
  }
}

GET /v1/capabilities

Verfügbarkeit

Parameter: —

curl --request GET 'https://lumeexchangerates.com/v1/capabilities'

Die Werte und Datumsangaben zeigen das Antwortformat, keine aktuellen Kurse. Listen können gekürzt sein. Aktuelle Daten erhalten Sie im API-Explorer.

{
  "data": {
    "latest": true,
    "currencies": true,
    "conversion": "latest_snapshot",
    "historical": "verified_on_request",
    "time_series": true,
    "ohlc": false,
    "refresh_interval_seconds": 300,
    "customer_api_keys": false
  }
}

OHLC über /v1/candles erfordert die Berechtigung des Datenanbieters. Prüfen Sie /v1/capabilities; der konfigurierte Tarif bestimmt die Verfügbarkeit.

Daten und Genauigkeit

Richtkurse sind keine Bankangebote oder garantierten Transaktionspreise. Umrechnungen nutzen einen gemeinsamen Datenstand; erst bei Anzeige oder Abrechnung runden.

rate = rates[to] / rates[from]
result = amount * rate

Kurse behalten ihre Gleitkommagenauigkeit ohne Abschneiden auf feste Dezimalstellen. Runden Sie erst für die Anzeige oder nach Ihrer Buchhaltungsrichtlinie.

Alle Kurse gelten für eine Ursprungseinheit, auch JPY. Multiplizieren Sie bei Bedarf erst zur Anzeige mit 100. Berücksichtigen Sie binäre JavaScript-Rundungsfehler und legen Sie Dezimal- und Rundungsregeln für die Abrechnung fest.

Zeitangaben

UNIX-Zeitstempel sind UTC-Sekunden, ISO-Zeitstempel verwenden Z. UTC-Tagesdaten können vom lokalen Datum abweichen. Die Website verwendet die Browserzeitzone. meta.timezone ist nur ein Anzeigehinweis und ändert die Zeitstempelbedeutung nicht.

Fehler

{
  "error": {
    "code": "INVALID_CURRENCY",
    "message": "Symbol not available in latest provider data"
  }
}

message kann fehlen. Verzweigen Sie nach HTTP-Status und error.code. Korrigieren Sie Eingaben zuerst. Bei 429 oder temporärem 503 verwenden Sie begrenztes exponentielles Backoff mit Zufallsstreuung. Retry-After wird nicht garantiert.

Limits und Cache

Aktuelle Daten werden gecacht; derzeit ist ein Fünf-Minuten-Intervall konfiguriert. /api: 90 Anfragen pro Minute und IP, direkt instanzlokal und mit Redis instanzübergreifend. /v1 setzt künftige Plankontingente noch nicht durch.

Antworten verwenden Cache-Control: no-store. Browser- und serverseitiger Anbietercache unterscheiden sich. Verwenden Sie Snapshots anhand ihrer Veröffentlichungszeit erneut. Bei Ausfällen kann der letzte gültige Stand zurückkommen: stale oder as_of prüfen. Direkte Worker-Caches sind nicht dauerhaft.

{
  "endpoints": [
    "/v1/history",
    "/v1/series",
    "/v1/candles",
    "/v1/capabilities"
  ],
  "requests_per_ip_per_minute": 60,
  "cache": "in_process",
  "completed_history_cache_seconds": 3600,
  "current_day_cache_seconds": 60
}

Verfügbarkeit

OHLC über /v1/candles erfordert die Berechtigung des Datenanbieters. Prüfen Sie /v1/capabilities; der konfigurierte Tarif bestimmt die Verfügbarkeit.

OHLC über /v1/candles erfordert die Berechtigung des Datenanbieters. Prüfen Sie /v1/capabilities; der konfigurierte Tarif bestimmt die Verfügbarkeit.

API-Explorer

Führen Sie die Anfrage aus, um die echte JSON-Antwort zu sehen.