Endpoints de la API

Frankfurter ofrece endpoints para obtener los últimos tipos de cambio, datos históricos o series temporales.

Últimos tipos

Obtén los tipos del último día hábil, que se actualizan a diario hacia las 16:00 CET.

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

Cambia la divisa base con el parámetro base. Por defecto es EUR.

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

Limita la respuesta a divisas de destino concretas.

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

Tipos históricos

Consulta los tipos de una fecha concreta.

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

Cambia la divisa base y filtra las divisas de destino.

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

Nota: Frankfurter guarda las fechas en UTC. Si usas otra zona horaria, ten en cuenta que podrías estar consultando un día distinto del que esperas. Además, los datos de hoy no son definitivos y se actualizan si se publican nuevos tipos.

Series temporales

Obtén los tipos de un período.

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

Obtén los tipos hasta hoy.

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

Consejo: Filtra las divisas para reducir el tamaño de la respuesta y mejorar el rendimiento.

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

Divisas disponibles

Obtén los códigos de divisa admitidos y sus nombres completos.

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

Conversión de divisas

Para convertir divisas, obtén el tipo de cambio y haz el cálculo en tu 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);