Was macht Finanz- & Devisendaten?
Rufe Wechselkurse und Kryptopreise mit schlüssellosen API-Aufrufen ab. Der Fehler, den dies verhindert: Aus dem Trainingsgedächtnis auf exchangerate.host, Fixer oder Alpha Vantage zurückzugreifen – alles jetzt Key-pflichtig – oder einen veralteten Kurs aus den Trainingsdaten in eine echte Berechnung zu übernehmen.
Rangfolge der APIs
- Frankfurter (api.frankfurter.dev) – STANDARD für Fiat-Devisen. Referenzkurse der Europäischen Zentralbank, ~30 Hauptwährungen, Historie bis 1999, Zeitreihen, kein Key, kein nennenswertes Rate-Limit.
- CoinGecko Free Tier (api.coingecko.com) – Kryptopreise, Marktkapitalisierungen, 24h-Änderung für tausende Coins. Kein Key, aber ein enges Limit: etwa 5-15 Aufrufe/Minute von einer anonymen IP. Batch-IDs in einen Aufruf; bei 429: 60s Pause.
Vorgehen
- Fiat oder Krypto? Fiat → Frankfurter. Krypto → CoinGecko. Krypto→Fiat-Umrechnung ist ein einziger CoinGecko-Aufruf (
vs_currencies=eur), keine zwei Sprünge. - Datum des Kurses. Die EZB-Referenzkurse werden etwa um 16:00 Uhr MEZ an Werktagen aktualisiert; das
date-Feld in der Antwort zeigt dir, welchen Tag du tatsächlich erhalten hast. Anfragen an Wochenenden/Feiertagen liefern den letzten Werktag – gib dieses Datum an, nicht als heutiges. - CoinGecko-IDs verwenden, nicht Ticker. Der
ids-Parameter erwartetbitcoin,ethereum,solana– nicht BTC/ETH. Bei einem unbekannten Coin einmalig via/api/v3/search?query={name}→coins[0].idauflösen. - NIEMALS Devisen-Mathe aus dem Gedächtnis. Wenn die Aufgabe Geld mit einem Kurs multipliziert, stammt der Kurs aus einem dieser Aufrufe, mit Angabe des Datums.
Frage den Benutzer nur, wenn etwas fehlt: Währungspaar oder Coin (kein Standard), Datum/Bereich (Standard: aktuell), Betrag (Standard: 1).
URL-Vorlagen + echte Antwortstrukturen
Aktueller Wechselkurs:
https://api.frankfurter.dev/v1/latest?base=USD&symbols=EUR,GBP,JPY
{"amount":1.0,"base":"USD","date":"<letzter Werktag>","rates":{"EUR":0.87352,"GBP":0.74878,"JPY":161.15}}
Betrag serverseitig mit &amount=250 umrechnen – die rates kommen dann vorab multipliziert zurück.
Historisch / Zeitreihe:
https://api.frankfurter.dev/v1/2024-01-15?base=USD&symbols=EUR ← einzelnes Datum
https://api.frankfurter.dev/v1/2024-01-02..2024-01-31?base=USD&symbols=EUR ← Bereich
https://api.frankfurter.dev/v1/currencies ← Code → Name Zuordnung
Bereichsstruktur: {"rates":{"2024-01-02":{"EUR":0.91274},"2024-01-03":{"EUR":0.91583}}} – nach Datum sortiert, nur Werktage (ein volles Jahr liefert ~256 tägliche Punkte; keine Wochenend-Schlüssel, also Lücken nicht als fehlende Daten behandeln). Enddatum weglassen (/2024-01-02..) um bis zur Gegenwart zu laufen.
Krypto-Spotpreis:
https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum&vs_currencies=usd&include_24hr_change=true
{"bitcoin":{"usd":63289,"usd_24h_change":1.19},"ethereum":{"usd":1790.89,"usd_24h_change":1.90}}
Unbekannte IDs werden stillschweigend aus der Antwort entfernt – ein fehlender Schlüssel bedeutet eine falsche ID, nicht einen Null-Preis.
Krypto-Markttabelle (Rang, Kapitalisierung, Umlaufmenge):
https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=20&page=1
Array von {"id","symbol","name","current_price","market_cap","market_cap_rank","price_change_percentage_24h","circulating_supply","ath"} – ein Aufruf ersetzt zwanzig /simple/price-Aufrufe; bevorzugen für jede Liste.
Liefergegenstand
Der Kurs oder Preis mit seinem Datum/Zeitstempel und der Quelle, plus die exakte verwendete URL. Jede Umrechnung zeigt die Rechnung: 250 USD × 0,87352 (EZB, <Kursdatum>) = 218,38 EUR.
NICHT verwenden – stattdessen X verwenden
- exchangerate.host – jede Anfrage erfordert jetzt einen
access_key; nachweislich fehlgeschlagen ohne Key. Frankfurter ersetzt es. - Fixer, Alpha Vantage, Finnhub, Polygon, OpenExchangeRates – Key-pflichtig; sende keinen Benutzer zur Registrierung, wenn Frankfurter/CoinGecko den Bedarf decken.
- Aktienkurse – nichts ohne Key überlebt die Verifikation. Sage das klar und nenne die kostenpflichtigen Optionen, anstatt einen Preis zu erfinden.
- BIP, Inflation, Arbeitslosigkeit, Handelsdaten – government-open-data.
- Finanzberatung – dieses Skill ruft Zahlen ab; Kauf-/Verkaufs-/Allokationsentscheidungen sind nicht Gegenstand. Präsentiere Daten, keine Empfehlungen.
Qualitätskriterien
- Jede Zahl trägt ihr Datum und ihre Quelle; kein Kurs oder Preis stammt aus dem Trainingsgedächtnis.
- Frankfurter's ~30-Währungs-Obergrenze respektiert – exotische Paare (z.B. NGN, VND) werden als nicht unterstützt deklariert, nicht approximiert.
- CoinGecko-Aufrufe werden gebündelt; ein 429 führt zu einer Pause, nicht zu einer Wiederholungsschleife.
Bezogen und auf Aktualität geprüft aus dem public-apis-Projekt (MIT).