Frankfurter es una API gratuita de tipos de cambio para 219 divisas y otros 39 activos de 112 bancos centrales y fuentes oficiales. Los tipos se actualizan a lo largo del día. El historial diario se remonta a 1948.

La API pública está en api.frankfurter.dev y no necesita clave API. El proyecto es de código abierto, así que también puedes alojarlo tú mismo para tener control total.

Son tipos de referencia, no cotizaciones de mercado en tiempo real. Cada fuente los publica una o varias veces al día.

¿Trabajas con un agente de IA? Pásale el llms.txt o añade el servidor MCP.

Tipos de cambio

Obtén los últimos tipos de cambio.

curl https://api.frankfurter.dev/v2/rates

Cambia la divisa base con base.

curl https://api.frankfurter.dev/v2/rates?base=usd

Filtra las divisas de destino con quotes.

curl https://api.frankfurter.dev/v2/rates?quotes=usd,gbp

Tipos históricos

Consulta los tipos de una fecha concreta.

curl https://api.frankfurter.dev/v2/rates?date=1999-01-04

Series temporales

Obtén los tipos de un período con from y to.

curl https://api.frankfurter.dev/v2/rates?from=2026-01-01&quotes=usd

Consejo: Limitar las divisas mantiene las respuestas ligeras. Para rangos de fechas largos, pide NDJSON y recibe los resultados en streaming, línea a línea.

Agrupación

Reduce la resolución de una serie temporal con group. Admite week y month.

curl https://api.frankfurter.dev/v2/rates?from=2026-01-01&group=month

Filtrar por fuente

Limita la consulta a fuentes concretas con providers.

curl https://api.frankfurter.dev/v2/rates?providers=ecb

Por defecto, la API combina los tipos de todas las fuentes. Usa providers para obtener los tipos de una fuente concreta o consulta esa fuente directamente con sus propias rutas.

Algunas fuentes publican más de un conjunto de datos, como las tablas diaria y semanal del NBP. La clave de una fuente selecciona sus conjuntos de datos predeterminados. La clave de un conjunto de datos selecciona solo ese.

curl https://api.frankfurter.dev/v2/rates?providers=nbp.b&base=pln&quotes=ars,ngn

Atribución de fuentes

Añade expand=providers para ver qué fuentes intervienen en cada tipo combinado.

curl https://api.frankfurter.dev/v2/rates?expand=providers

Cada fila incluye un array providers. Cada entrada lleva la clave (key), la fecha de observación (date) y el tipo (rate) de la fuente, más excluded: true si quedó fuera de la media. Las divisas con paridad fija toman su tipo de la paridad, así que todas sus entradas figuran como excluidas. Las filas que salen solo de una paridad, sin ninguna fuente que cotice la divisa, no llevan este campo.

Salida CSV

Los tipos también están disponibles en CSV. Añade .csv a la ruta o envía la cabecera Accept con text/csv.

curl https://api.frankfurter.dev/v2/rates.csv

Salida NDJSON

Para respuestas grandes, pide NDJSON (JSON delimitado por saltos de línea) enviando la cabecera Accept con application/x-ndjson. Cada línea es un objeto JSON independiente, así que puedes procesar series temporales largas en streaming sin cargar toda la respuesta en memoria.

curl https://api.frankfurter.dev/v2/rates?from=2026-01-01

Tipo individual

Obtén el tipo de cambio de un solo par de divisas. Si quieres, añade date o providers.

curl https://api.frankfurter.dev/v2/rate/eur/usd

Divisas

Obtén las divisas disponibles y qué fuentes las cubren.

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

Incluye divisas retiradas con scope.

curl https://api.frankfurter.dev/v2/currencies?scope=all

Divisa individual

Obtén los detalles de una divisa y qué fuentes la cubren.

curl https://api.frankfurter.dev/v2/currency/eur

Fuentes

Lista las fuentes de datos que usa la API.

curl https://api.frankfurter.dev/v2/providers

Obtén los detalles de una fuente concreta.

curl https://api.frankfurter.dev/v2/providers/ecb

Cada fuente lista sus conjuntos de datos, cada uno con sus propias fechas, calendario y divisas.

Tipos por fuente

Consulta los tipos de una fuente concreta directamente. Admite los mismos parámetros que /v2/rates y /v2/rate.

curl https://api.frankfurter.dev/v2/providers/ecb/rates

Obtén un solo par de divisas de esa fuente.

curl https://api.frankfurter.dev/v2/providers/ecb/rate/eur/usd

Combínalo con date, rangos de fechas (from y to) o agrupación. Los formatos como .csv y ndjson también funcionan aquí.

curl https://api.frankfurter.dev/v2/providers/ecb/rates?date=2024-05-15

Conversión

No hay endpoint de conversión. Obtén el tipo y convierte con unas pocas líneas de código.

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

Errores

La API responde con códigos de estado HTTP estándar y un cuerpo JSON.

{
  "status": 422,
  "message": "invalid currency: ABC"
}
400
Parámetro no válido o petición mal formada.
404
Divisa, tipo de cambio o recurso no encontrado.
422
Petición entendida, pero no se puede procesar.

Self-hosting

Puedes alojar Frankfurter tú mismo con Docker. La guía de despliegue explica la configuración para producción y las claves API.

FAQ

¿Para quién es Frankfurter (y para quién no)?
Funciona bien para facturación SaaS, e-commerce, sistemas ERP y de contabilidad, e investigación académica con series históricas desde 1948. Para informes fiscales y otras tareas de cumplimiento normativo, usa los tipos oficiales de una fuente concreta. No está pensado para trading en tiempo real ni para negocios con divisas exóticas sujetas a fuertes oscilaciones intradía.
¿La API es gratis para uso comercial?
Sí, también en productos de pago y en los informes y exportaciones que generen. Los tipos combinados son un cálculo propio de Frankfurter, así que las condiciones de los proveedores no se aplican a ellos. Los endpoints de cada proveedor, y las cifras que publica, siguen sujetos a las condiciones de ese proveedor.
¿Puedo guardar o almacenar en caché los tipos en mi propia base de datos?
Sí, y durante el tiempo que quieras. La caché mantiene ligero el tráfico de la API, por eso la recomendamos. Como los tipos combinados pueden variar ligeramente cuando llegan datos nuevos, para registros de auditoría guarda el tipo, su fecha y la salida de expand=providers. Los tipos por proveedor de esa salida son datos de cada proveedor: si los republicas, se aplican sus condiciones.
¿Tengo que citar a Frankfurter?
No, pero se agradece. Una línea como «Tipos de cambio: Frankfurter (frankfurter.dev)» junto a los importes convertidos o en la nota de fuentes de un informe funciona bien.
¿Tiene la API límites de llamadas?
No hay cuotas. Las peticiones tienen un rate limit para evitar abusos, pero sin topes diarios ni mensuales. Para volúmenes altos, cachea las respuestas, aloja tu propia instancia o consulta los datasets directamente.
¿La API pública tiene SLA o garantía de disponibilidad?
No, pero sirve para producción si cacheas las respuestas. Si necesitas garantías, aloja tu propia instancia.
¿La API admite GraphQL?
No. La API REST es tan simple que GraphQL solo añadiría complejidad sin mucho beneficio. Además, rompería la caché en el edge, que es lo que la hace rápida. Usa parámetros de consulta como base, quotes y from/to para obtener exactamente los datos que necesitas.
¿Se va a retirar la API v1?
No. La API v1 está obsoleta en favor de v2, pero seguirá disponible indefinidamente. Consulta la documentación de v1. Para datos del Banco Central Europeo, usa /v2/providers/ecb/rates.
¿Cuál es la política de privacidad de la API?
La API no recopila ni registra datos personales, direcciones IP ni URLs de las peticiones. La instancia pública funciona detrás de Cloudflare, que aporta caché y protección DDoS y solo ofrece estadísticas de tráfico agregadas.
¿Tengo que declarar la API en las etiquetas de privacidad de la App Store o Google Play?
No. Como las consultas son anónimas y no se guardan registros de las peticiones, cuentan como datos no recopilados según las directrices de Apple y Google Play.
¿Dónde puedo reportar un error o hacer una pregunta?
Abre una issue para reportar un error, pedir una funcionalidad o sugerir una nueva fuente de datos. Usa Discussions para hacer preguntas o compartir una librería o herramienta que hayas creado con Frankfurter.
¿Qué precisión tienen los tipos?
Para cumplimiento normativo (impuestos y contabilidad), filtra por una fuente concreta y obtendrás sus tipos de referencia oficiales. Para uso general, los tipos combinados por defecto funcionan bien, aunque los últimos decimales pueden variar a medida que llegan datos nuevos.
¿Los tipos son medios, de compra o de venta?
La API devuelve tipos medios de mercado (mid-market). Si una fuente publica tipos de compra y venta en lugar de un tipo de referencia, Frankfurter guarda ambos y calcula el punto medio.
¿Todos los tipos son diarios?
Casi todos. Algunas fuentes ofrecen observaciones semanales, mensuales o trimestrales. Estas fuentes no entran en el feed combinado. Consúltalas directamente con el filtro providers.
¿Todas las divisas tienen datos desde 1948?
No. El dólar estadounidense sí, pero la mayoría empieza en los años noventa o después, según sus proveedores. Cada página de divisa muestra su rango, igual que /v2/currencies.
¿Hay tipos de metales preciosos o criptomonedas?
Sí. Varios bancos centrales publican tipos diarios del oro (XAU), la plata (XAG), el platino (XPT) y el paladio (XPD) por onza troy. En cripto, limitamos la lista a monedas con futuros de CME o una CME CF Reference Rate (como BTC, ETH, SOL y XRP), más USDT y USDC. Solo unas pocas fuentes ofrecen cripto, así que la cobertura es escasa.
¿Por qué se solapan las fechas de algunas divisas antiguas y nuevas?
Algunas fuentes retrotraen la divisa nueva al período de la antigua (por ejemplo, TRL termina en 2010 y TRY empieza en 1996). Guardamos los datos de las fuentes tal cual y solo filtramos los solapamientos al combinarlos.
¿Por qué Frankfurter?
Porque nuestra fuente de datos original está en la ciudad de Fráncfort.
European Central Bank