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&quotes=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&quotes=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=providers op. 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, quotes en from/to vraag 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 (zoals BTC, ETH, SOL en XRP), plus USDT en USDC. 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. TRL eindigt in 2010, terwijl TRY al 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.
European Central Bank