Währungsumrechner API (Convert) – Currency Converter API für Websites & Apps

Was ist eine Currency Converter API?

Eine Currency Converter API (Währungsumrechner‑API) ist ein Web‑Service, der dir über HTTPS aktuelle Wechselkurse liefert und daraus konvertierte Beträge berechnet — z. B.: „79,00 EUR“ → „75,xx CHF“. Der entscheidende Punkt ist: eine gute API gibt dir nicht nur „irgendeinen Kurs“, sondern ein konsistentes Conversion‑Ergebnis, das du im Frontend, Checkout oder Reporting zuverlässig verwenden kannst.

Gerade im deutschsprachigen Raum ist die Erwartungshaltung hoch: Preise sollen transparent sein, Rundungen sollen plausibel wirken, und Zeitpunkte („Stand des Kurses“) sollen nachvollziehbar sein. Wenn du das sauber löst, steigerst du nicht nur die technische Qualität, sondern oft auch Vertrauen, Kaufbereitschaft und Lead‑Qualität.

Convert‑Endpunkt: So sieht eine saubere Währungsumrechnung aus

Unten ist ein Beispiel‑Design für einen Convert‑Endpunkt. Wenn du Fieba nutzt, bekommst du die konkrete Base‑URL, Auth‑Methode und Limits je nach Setup. Wichtig für SEO & Developer Experience: klare Parameter, sprechende Feldnamen, und ein Response, der direkt in UI/Checkout verwendbar ist.

Request (Beispiel)

GET https://api.fieba.net/v1/convert?amount=79.00&from=EUR&to=CHF
Authorization: Bearer YOUR_API_KEY
Accept: application/json

Response (Beispiel)

{
  "amount": 79.00,
  "from": "EUR",
  "to": "CHF",
  "rate": 0.95,
  "result": 75.05,
  "as_of": "2026-01-09T12:00:00Z",
  "source": "FX data provider",
  "meta": {
    "precision": 2,
    "rounding": "HALF_UP"
  }
}

Fehlerfälle, die du (wirklich) brauchst

Ein häufiger Conversion‑Killer sind unklare Fehlermeldungen: Nutzer:innen sehen keine Preise oder der Checkout hängt. Gute APIs liefern klare Statuscodes + maschinenlesbare Fehler.

{
  "error": {
    "code": "INVALID_CURRENCY",
    "message": "Unsupported currency code. Use ISO 4217 (e.g., EUR, USD, CHF).",
    "hint": "Check the 'from'/'to' parameters and try again."
  }
}

Quickstart: In wenigen Minuten integriert

Die meisten Teams starten mit einem Convert‑Call in ihrer Backend‑Schicht (für Sicherheit und Cache‑Kontrolle) und geben nur das Ergebnis ans Frontend. Unten sind praxisnahe Snippets, die du direkt anpassen kannst.

cURL

curl -sS "https://api.fieba.net/v1/convert?amount=120.50&from=EUR&to=USD" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

JavaScript (fetch) – ideal für Prototypen

async function convertCurrency({ amount, from, to }) {
  const url = new URL("https://api.fieba.net/v1/convert");
  url.searchParams.set("amount", String(amount));
  url.searchParams.set("from", from);
  url.searchParams.set("to", to);

  const res = await fetch(url.toString(), {
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Accept": "application/json"
    }
  });

  if (!res.ok) {
    const err = await res.json().catch(() => ({}));
    throw new Error(err?.error?.message || `Request failed: ${res.status}`);
  }

  return res.json(); // { amount, from, to, rate, result, as_of, ... }
}

// Beispiel:
convertCurrency({ amount: 79, from: "EUR", to: "CHF" })
  .then(data => console.log("Result:", data.result, data.to))
  .catch(console.error);

Python (requests)

import requests

url = "https://api.fieba.net/v1/convert"
params = {"amount": 249.99, "from": "EUR", "to": "GBP"}
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}

resp = requests.get(url, params=params, headers=headers, timeout=10)
resp.raise_for_status()
data = resp.json()

print(f"{data['amount']} {data['from']} => {data['result']} {data['to']} (as_of {data['as_of']})")

PHP (serverseitig)

<?php
$amount = 99.00;
$from = "EUR";
$to = "CHF";

$url = "https://api.fieba.net/v1/convert?amount=" . urlencode($amount) .
       "&from=" . urlencode($from) . "&to=" . urlencode($to);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer YOUR_API_KEY",
  "Accept: application/json"
]);

$out = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($code < 200 || $code >= 300) {
  throw new Exception("Request failed: " . $code . " " . $out);
}

$data = json_decode($out, true);
echo $data["result"] . " " . $data["to"];
?>

Best Practices für präzise Umrechnung & bessere UX

Eine „gute“ Währungsumrechnung fühlt sich für Nutzer:innen einfach „richtig“ an. Das erreichst du nicht nur mit Daten, sondern mit sauberen Regeln. Hier sind die wichtigsten Prinzipien, die in echten Projekten für weniger Support‑Tickets, bessere Conversions und stabilere Systeme sorgen.

1) Trenne Berechnung und Anzeige

Lass die API die Berechnung liefern (rate, result, as_of), aber formatiere im Frontend oder in deinem Backend: Währungssymbol, Tausendertrennzeichen, lokale Darstellung (z. B. 1.234,56 vs. 1,234.56). So kannst du Locale‑Regeln pro Sprache sauber steuern.

2) Definiere Rundung und Precision explizit

Für Preisauszeichnungen in Shops oder Reise‑Budgets wirkt eine stabile Rundung vertrauenswürdiger als „wild schwankende Centbeträge“. Lege fest, ob du HALF_UP, HALF_EVEN oder eine andere Logik nutzt — und dokumentiere das intern.

3) Cache mit gesundem Menschenverstand

Wechselkurse müssen nicht bei jedem Page‑View neu geladen werden. Ein kurzer Cache (z. B. Minutenbereich) senkt Latenz, spart Kosten und verhindert Rate‑Limit‑Probleme. Wenn du Preise im Checkout zeigst, kannst du zusätzlich einen Hinweis „Stand: …“ anzeigen, um Transparenz zu erhöhen.

4) Plane Fallbacks

Auch die beste Infrastruktur hat Ausnahmen: Provider‑Downtime, Netzwerkprobleme, Rate‑Limits. Baue in der UI einen Fallback ein (z. B. zeige primär EUR, blende Umrechnung temporär aus oder nutze den zuletzt bekannten Kurs), statt den gesamten Preisblock „leer“ zu lassen.

Kein Formular im eingebetteten Code (wie gewünscht). Der Button führt zur bestehenden Kontaktseite.

FAQ zur Währungsumrechner API

Häufige Fragen rund um Wechselkurse, Umrechnung und Integration (SEO‑freundlich, klar beantwortet).