Endpoints da API

O Frankfurter oferece endpoints para consultar as cotações mais recentes, dados históricos ou séries temporais.

Cotações mais recentes

Busque as cotações do último dia útil, atualizadas todo dia por volta das 16h CET.

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

Troque a moeda base com o parâmetro base. O padrão é EUR.

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

Limite a resposta a moedas de cotação específicas.

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

Cotações históricas

Consulte as cotações de uma data específica.

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

Troque a moeda base e filtre as moedas de cotação.

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

Nota: o Frankfurter armazena datas em UTC. Se você usa outro fuso horário, pode acabar consultando uma data diferente da que pretendia. Além disso, os dados de hoje não são definitivos e mudam se novas cotações forem publicadas.

Séries temporais

Busque cotações de um período.

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

Busque cotações até hoje.

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

Dica: filtre as moedas para reduzir o tamanho da resposta e melhorar a performance.

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

Moedas disponíveis

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

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

Conversão de moedas

Converta moedas buscando a cotação e fazendo a conta 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);