Frankfurter API voor wisselkoersen en valutagegevens
Frankfurter is een gratis wisselkoers-API voor 219 valuta's en 39 andere activa van 112 centrale banken en officiële bronnen. De koersen worden de hele dag door bijgewerkt. Dagelijkse gegevens gaan terug tot 1948.
De publieke API is beschikbaar via api.frankfurter.dev en vereist geen API-sleutel. Het project is open source. Voor volledige controle kun je het ook zelf hosten.
Dit zijn referentiekoersen, geen live marktkoersen. Elke bron publiceert ze een of enkele keren per dag.
Werk je met een AI-agent? Gebruik llms.txt of koppel de MCP-server.
Koersen
Haal de meest recente wisselkoersen op.
curl https://api.frankfurter.dev/v2/rates
Wijzig de basisvaluta met base.
curl https://api.frankfurter.dev/v2/rates?base=usd
Filter doelvaluta's met quotes.
curl https://api.frankfurter.dev/v2/rates?quotes=usd,gbp
Historische koersen
Vraag koersen op voor een specifieke datum.
curl https://api.frankfurter.dev/v2/rates?date=1999-01-04
Tijdreeksen
Haal wisselkoersen over een periode op met from en to.
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01"es=usd
Tip: Vraag alleen de valuta's op die je nodig hebt. Voor lange tijdreeksen kun je NDJSON gebruiken: resultaten worden regel voor regel gestreamd.
Groepering
Verdicht tijdreeksen met group. Mogelijke waarden: week en month.
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01&group=month
Filteren op bron
Beperk gegevens tot specifieke instellingen met providers.
curl https://api.frankfurter.dev/v2/rates?providers=ecb
Standaard combineert de API koersen van alle bronnen. Gebruik providers voor een specifieke bron of raadpleeg deze via haar eigen endpoints.
Sommige bronnen publiceren meer dan één dataset, zoals de dagelijkse en wekelijkse tabel van de NBP. De sleutel van een bron selecteert de standaarddatasets. De sleutel van een dataset selecteert alleen die ene.
curl https://api.frankfurter.dev/v2/rates?providers=nbp.b&base=pln"es=ars,ngn
Bronvermelding
expand=providers toont welke bronnen aan elke gecombineerde koers hebben bijgedragen.
curl https://api.frankfurter.dev/v2/rates?expand=providers
Elk item bevat een providers-array. Elk element bevat de sleutel (key), de waarnemingsdatum (date) en de koers (rate) van de bron, plus excluded: true als de bron buiten het gemiddelde is gelaten. Gekoppelde valuta's halen hun koers uit de koppeling, dus elk element is uitgesloten. Items die alleen uit een koppeling komen, voor een valuta die geen enkele bron noteert, missen dit veld.
CSV-uitvoer
Koersen zijn ook beschikbaar als CSV. Voeg .csv toe aan het pad of
stel de Accept-header in op text/csv.
curl https://api.frankfurter.dev/v2/rates.csv
NDJSON-uitvoer
Gebruik NDJSON (Newline-Delimited JSON) voor grote datasets: stel de Accept-header in op application/x-ndjson. Elke regel is een zelfstandig JSON-object dat je kunt streamen.
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01
Enkele wisselkoers
Haal de koers van één valutapaar op.
curl https://api.frankfurter.dev/v2/rate/eur/usd
Valuta's
Bekijk beschikbare valuta's en hun bronnen.
curl https://api.frankfurter.dev/v2/currencies
Voeg historische valuta's toe met scope.
curl https://api.frankfurter.dev/v2/currencies?scope=all
Enkele valuta
Details en bronnen van een specifieke valuta opvragen.
curl https://api.frankfurter.dev/v2/currency/eur
Bronnen
Overzicht van alle gegevensbronnen achter de API.
curl https://api.frankfurter.dev/v2/providers
Details van een specifieke bron bekijken.
curl https://api.frankfurter.dev/v2/providers/ecb
Elke bron toont zijn datasets, elk met eigen datums, schema en valuta.
Koersen per bron
Haal koersen rechtstreeks op van een bepaalde bron. Dezelfde parameters als bij /v2/rates zijn van toepassing.
curl https://api.frankfurter.dev/v2/providers/ecb/rates
Een enkel valutapaar van deze bron ophalen.
curl https://api.frankfurter.dev/v2/providers/ecb/rate/eur/usd
Koersen voor een valutapaar over een periode ophalen. Combineerbaar met date, datumbereiken (from en to) of groepering. Formaten zoals .csv en ndjson werken hier ook.
curl https://api.frankfurter.dev/v2/providers/ecb/rates?date=2024-05-15
Omrekenen
Er is geen apart omreken-endpoint. Haal de koers op en reken om met een paar regels code.
function convert(base, quote, amount) {
const api = "https://api.frankfurter.dev";
return fetch(`${api}/v2/rate/${base}/${quote}`)
.then((r) => r.json())
.then((d) => (amount * d.rate).toFixed(2));
}
convert("eur", "usd", 10).then((result) =>
alert(`10 EUR = ${result} USD`)
);
Foutmeldingen
De API reageert met standaard HTTP-statuscodes en een JSON-body.
{
"status": 422,
"message": "invalid currency: ABC"
}
400- Ongeldige parameter of onjuist verzoek.
404- Valuta, koers of bron niet gevonden.
422- Verzoek begrepen, maar kan niet worden verwerkt.
Zelf hosten
Je kunt Frankfurter zelf hosten met Docker. De deploy-handleiding behandelt productieconfiguraties en API-sleutels.
FAQ
- Waarvoor is Frankfurter geschikt (en waarvoor niet)?
- De API is geschikt voor SaaS-facturatie, e-commerce, ERP- en boekhoudsystemen en historisch onderzoek vanaf 1948. Gebruik voor belastingaangiften en andere compliance de officiële koersen van een specifieke bron. Niet bedoeld voor realtime handel of intraday koersschommelingen.
- Mag ik Frankfurter commercieel gebruiken?
- Ja, ook in betaalde producten en in de rapporten en exports die ze maken. Gecombineerde koersen zijn Frankfurters eigen berekening, dus de voorwaarden van bronnen gelden daar niet voor. Voor de endpoints van een bron, en de koersen die een bron publiceert, gelden de voorwaarden van die bron.
- Mag ik koersen opslaan of cachen in mijn eigen database?
-
Ja, en zo lang als je wilt. Caching houdt het API-verkeer laag en wordt aangemoedigd. Gecombineerde koersen kunnen licht verschuiven als er nieuwe data binnenkomt. Sla voor auditdoeleinden daarom de koers, de datum en de uitvoer van
expand=providersop. De koersen per bron in die uitvoer zijn data van die bron, dus voor herpublicatie gelden de voorwaarden van die bron. - Moet ik Frankfurter vermelden?
- Nee, maar we waarderen het. Een regel als “Wisselkoersen: Frankfurter (frankfurter.dev)” bij omgerekende bedragen of in de bronvermelding van een rapport werkt goed.
- Geldt er een quotum of limiet?
- Er zijn geen quota. Er geldt een rate limit tegen misbruik, maar geen maandelijkse of dagelijkse limiet. Bij hoge volumes kun je cachen, zelf hosten of datasets rechtstreeks downloaden.
- Heeft de publieke API een SLA of uptimegarantie?
- Nee, maar je kunt hem prima in productie gebruiken als je antwoorden cachet. Heb je garanties nodig, host hem dan zelf.
- Ondersteunt de API GraphQL?
-
Nee. De REST-API is zo eenvoudig dat GraphQL alleen onnodige complexiteit
zou toevoegen en edge-caching zou belemmeren. Met parameters als
base,quotesenfrom/tovraag je precies op wat je nodig hebt. - Wordt de v1 API uitgefaseerd?
- Nee. De v1 API is verouderd ten gunste van v2, maar blijft permanent beschikbaar. Zie de v1-documentatie. ECB-gegevens zijn beschikbaar via /v2/providers/ecb/rates.
- Hoe zit het met privacy?
- Frankfurter slaat geen persoonsgegevens, IP-adressen of opgevraagde URL's op. We verzamelen uitsluitend anonieme geaggregeerde statistieken via een eigen Plausible Analytics-instantie.
- Moet ik de API vermelden in de privacyverklaring van de App Store of Google Play?
- Nee. Verzoeken zijn anoniem en worden niet gelogd. Volgens de richtlijnen van Apple en Google geldt dit als niet-verzamelde data.
- Waar kan ik problemen melden of vragen stellen?
- Open een issue om bugs te melden of nieuwe bronnen voor te stellen. Vragen en tools van derden horen thuis in de discussions.
- Hoe nauwkeurig zijn de koersen?
- Voor compliance (belasting en boekhouding) filter je op een specifieke bron om officiële referentiekoersen te ontvangen. Voor overige toepassingen voldoet de samengestelde marktkoers.
- Zijn de koersen midden-, bied- of laatkoersen?
- De API levert middenkoersen (mid-market). Als een bron bied- en laatkoersen publiceert in plaats van een referentiekoers, slaat Frankfurter beide op en berekent het gemiddelde.
- Worden alle koersen dagelijks gepubliceerd?
-
Vrijwel allemaal. Sommige bronnen leveren wekelijkse, maandelijkse of kwartaalwaarnemingen. Deze bronnen vallen buiten de samengestelde feed. Vraag ze rechtstreeks op met het
providers-filter. - Gaat de historie van elke valuta terug tot 1948?
-
Nee. Bij de Amerikaanse dollar wel, maar de meeste valuta beginnen in de jaren negentig of later, afhankelijk van hun bronnen. Elke valutapagina toont de periode, net als
/v2/currencies. - Zijn er koersen voor edelmetalen of cryptovaluta?
-
Ja. Verschillende centrale banken publiceren dagelijkse koersen voor goud (
XAU), zilver (XAG), platina (XPT) en palladium (XPD) per troy ounce. Voor crypto beperken we de lijst tot munten met CME-futures of een CME CF Reference Rate (zoalsBTC,ETH,SOLenXRP), plusUSDTenUSDC. Maar weinig bronnen bieden crypto aan, dus de dekking is mager. - Waarom overlappen de periodes bij sommige oude en nieuwe valuta's?
-
Sommige bronnen dateren opvolgende valuta's terug in de periode van hun voorganger
(bijv.
TRLeindigt in 2010, terwijlTRYal in 1996 begint). We nemen de brongegevens ongewijzigd over en filteren overlappingen pas bij het combineren. - Waarom Frankfurter?
-
Omdat onze oorspronkelijke gegevensbron in de stad Frankfurt zit.