L'API v1 est deprecated au profit de la v2, mais continuera de fonctionner.

Frankfurter propose des endpoints pour récupérer les derniers taux, des données historiques ou des séries temporelles.

Derniers taux

Récupère les taux du dernier jour ouvré, mis à jour chaque jour vers 16 h CET.

curl https://api.frankfurter.dev/v1/latest

Change la devise de base avec le paramètre base. La valeur par défaut est EUR.

curl https://api.frankfurter.dev/v1/latest?base=USD

Limite la réponse à certaines devises cibles.

curl https://api.frankfurter.dev/v1/latest?symbols=CHF,GBP

Taux historiques

Récupère les taux d'une date précise.

curl https://api.frankfurter.dev/v1/1999-01-04

Change la devise de base et filtre les devises cibles.

curl https://api.frankfurter.dev/v1/1999-01-04?base=USD&symbols=EUR

Remarque : Frankfurter enregistre les dates en UTC. Si tu utilises un autre fuseau horaire, tu risques d'interroger une autre date calendaire que prévu. Par ailleurs, les données renvoyées pour aujourd'hui ne sont pas figées et seront mises à jour si de nouveaux taux sont publiés.

Séries temporelles

Récupère les taux sur une période.

curl https://api.frankfurter.dev/v1/2000-01-01..2000-12-31

Récupère les taux jusqu'à aujourd'hui.

curl https://api.frankfurter.dev/v1/2024-01-01..

Astuce : filtre les devises pour réduire la taille de la réponse et gagner en performance.

curl https://api.frankfurter.dev/v1/2024-01-01..?symbols=USD

Devises disponibles

Récupère les codes des devises prises en charge et leur nom complet.

curl https://api.frankfurter.dev/v1/currencies

Conversion de devises

Pour convertir, récupère le taux de change et fais le calcul dans ton code.

function convert(from, to, amount) {
  fetch(`https://api.frankfurter.dev/v1/latest?base=${from}&symbols=${to}`)
    .then((resp) => resp.json())
    .then((data) => {
      const convertedAmount = (amount * data.rates[to]).toFixed(2);
      alert(`${amount} ${from} = ${convertedAmount} ${to}`);
    });
  }

convert("EUR", "USD", 10);