API de tipos de cambio: guía para desarrolladores

API de divisas, API de tipos de cambio, API FX y API forex son nombres que se solapan. Empieza por la tarea de tu aplicación y comprueba el formato, la fuente, la frescura, el historial y los límites.

Qué hace una API de tipos de cambio

La API recibe códigos como USD, EUR o JPY y devuelve tipos o importes convertidos. Suele cubrir tipos actuales, conversión, una fecha pasada y series históricas.

Haz tu primera petición

Esta petición solicita EUR y GBP con base USD. Puedes probarla sin clave y revisar la respuesta antes de crear credenciales.

curl "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"

Lee rates junto con source, market_session, timestamp y data_updated_at. El número sirve para calcular; los metadatos explican su origen y momento.

API de divisas, tipos de cambio, FX y forex

Los cuatro términos se usan de forma flexible. Forex puede sugerir trading, pero solo el contrato indica si hay punto medio indicativo, bid/ask o ejecución.

Comprende la divisa base y cotizada

En USD/EUR, USD es la base y EUR la cotizada. 0.84 significa que un dólar equivale a 0,84 euros. Guarda ambos códigos.

Llama a la API desde el servidor

En producción, conserva la clave en el servidor, fija un timeout, rechaza errores HTTP y almacena en caché según la frescura necesaria.

const response = await fetch(
  "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP",
  {
    headers: {
      Authorization: `Bearer ${process.env.EXCHANGERATE_API_KEY}`,
    },
    signal: AbortSignal.timeout(5000),
  },
);

if (!response.ok) {
  throw new Error(`exchange_rate_api_${response.status}`);
}

const snapshot = await response.json();
console.log(snapshot.rates.EUR, snapshot.data_updated_at);

Elige según la evidencia que necesita tu aplicación

• Confirma monedas y pares concretos.
• Distingue referencias diarias de observaciones intradía.
• Comprueba fechas, intervalos y huecos históricos.
• Exige fuente, hora, frescura y derivación explícitas.
• Modela cuotas, caché, reintentos y fallos.
• Separa tipos indicativos de precios de liquidación.

Evita errores comunes

No expongas claves en el navegador, no sustituyas un fallo por cero y no pongas una hora nueva a un dato antiguo. Conserva la última observación correcta y marca su estado.

API FX vs API forex vs API de divisas