Endpoints da API

O Frankfurter fornece endpoints para consultar as taxas mais recentes, dados históricos e séries temporais.

Taxas mais recentes

Obtenha as taxas do último dia útil, atualizadas diariamente por volta das 16:00 CET.

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

Altere a moeda base usando o parâmetro base. O padrão é EUR.

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

Limite a resposta a moedas de destino específicas.

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

Taxas históricas

Consulte taxas para uma data específica.

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

Altere a moeda base e filtre as moedas de destino.

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

Nota: O Frankfurter armazena datas em UTC. Se você utiliza outro fuso horário, esteja ciente de que pode estar consultando uma data de calendário diferente da pretendida. Além disso, os dados retornados para o dia atual não são definitivos e serão atualizados caso novas taxas sejam publicadas.

Séries temporais

Obtenha taxas ao longo de um período.

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

Obtenha taxas até o presente.

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

Dica: Filtre moedas para reduzir o tamanho da resposta e melhorar o desempenho.

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

Moedas disponíveis

Obtenha os códigos de moeda suportados e seus nomes completos.

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

Conversão de moedas

Realize a conversão de moedas obtendo a taxa de câmbio e calculando no seu código.

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);