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.
- Los nombres del producto no definen la calidad ni el significado del dato.
- Elige el endpoint según necesites tipos actuales, conversión o historial.
- Guarda la fuente y la hora de observación junto con cada tipo.
- Para una operación real, usa la cotización de la entidad que la ejecuta.
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.
“Forex en vivo” puede ser un punto medio indicativo y no una cotización ejecutable. Comprueba los campos y la metodología.
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.