CurrencyRateAPI

Herramienta de inicio rápido

¿Necesitas probar la API sin tener que revisar toda la documentación? Ve al Panel de Control, donde encontrarás la Herramienta de Inicio Rápido: una forma sencilla de probar todos los endpoints disponibles con un solo clic.

Haga clic en el botón a continuación para registrarse gratuitamente y comenzar a utilizar la herramienta de inicio rápido.

Empezando

Términos y conceptos clave que necesitarás para comenzar a trabajar con la API de tipo de cambio:

Respuesta de API

Los tipos de cambio proporcionados por CurrencyRateAPI se expresan en euros por defecto. Todos los datos se devuelven en formato JSON estándar y se pueden analizar fácilmente con cualquier lenguaje de programación.

Respuesta de muestra:
A continuación encontrará un ejemplo de respuesta de API que contiene una variedad de monedas mundiales comunes, todas relativas a la moneda EUR y con una marca de tiempo en la que se recibieron.

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

Como se muestra arriba, la respuesta de la API para los tipos de cambio en tiempo real incluye varios campos clave:

• success Indica si la solicitud fue exitosa.
• base devuelve el código de 3 letras de la moneda base utilizada para esta solicitud.
• date devuelve la fecha real para la que se proporcionan los tipos de cambio (formato AAAA-MM-DD).
• rates Contiene la lista de monedas solicitadas y sus tipos de cambio actuales.
• last_update_unix muestra la marca de tiempo (en formato Unix) de los últimos datos disponibles en el sistema.

Puntos finales disponibles

CurrencyRateAPI incluye varios puntos de conexión de API, cada uno con una funcionalidad específica. La disponibilidad de ciertos puntos de conexión depende de su plan de suscripción.

• Punto final de la lista de monedas. Este punto final devuelve la lista completa de todas las monedas admitidas. /api/codes (Alternativa: /api/currencies)
• Punto final de las últimas tarifas. Este punto final devuelve datos del tipo de cambio en tiempo real para todas las monedas admitidas. /api/latest
• Punto final de las tasas históricas. Este punto final devuelve datos históricos del tipo de cambio para una fecha específica. /api/YYYY-MM-DD (Alternativa: /api/history?date=YYYY-MM-DD). Los datos históricos están disponibles desde el 4 de enero de 1999.

Metodología del tipo de cambio

Para garantizar la precisión y la coherencia de los datos, CurrencyRateAPI sigue una metodología estricta para gestionar y entregar los tipos de cambio:

• Tarifas del mercado medio: Por defecto, la API devuelve tasas mid . Estas representan la media aritmética entre los precios de compra ( bid ) y venta ( ask ) del mercado, o las tasas de referencia oficiales de los bancos centrales.
• Finalización al final del día (EOD): Las tarifas históricas proporcionadas por la API se finalizan al final del día en UTC (Tiempo Universal Coordinado).
• Cálculo de tasa cruzada: Para los pares de divisas que no están disponibles directamente en nuestras fuentes, el sistema calcula automáticamente tipos de cambio cruzados altamente precisos utilizando las principales divisas mundiales como puente (pivote).
• Mecanismo de reserva inteligente: Si los datos para una fecha solicitada no están disponibles (por ejemplo, debido al cierre del mercado los fines de semana o días festivos), el sistema busca automáticamente la tarifa válida más reciente dentro de una ventana móvil de 8 días .
• Alta precisión: Para evitar errores de redondeo en los cálculos financieros, los tipos de cambio se almacenan y procesan con hasta 18 decimales .

Puntos finales

Punto final de símbolos admitidos

https://currencyrateapi.com/api/codes

Este punto de conexión devuelve la lista completa de todas las monedas admitidas. También puede usar el alias /api/currencies.

Una lista legible por humanos de todas las monedas admitidas también está disponible en nuestra página Monedas admitidas .

Monedas básicas: De forma predeterminada, otros puntos finales (como /latest y /{YYYY-MM-DD}) devuelven un conjunto limitado de las principales monedas globales para minimizar el tráfico. Estas monedas básicas son:

USD, EUR, GBP, CHF, JPY, CAD, AUD, NZD, SEK, NOK, DKK, ISK, PLN, CZK, HUF, RON, HRK, RSD,
MKD, MDL, TRY, SGD, HKD, KRW, TWD, ILS, AED, SAR, QAR, KWD, BHD, OMR, ZAR

Respuesta de la API:

{
    "success": true,
    "currencies": {
        "EUR": {
            "entity": "EUROPEAN UNION",
            "currency": "Euro",
            "alphabetic_code": "EUR",
            "numeric_code": 978,
            "minor_unit": 2,
            "title": "Euro",
            "symbol": "€",
            "data_from": "1999-01-04"
        },
        "BTC": {
            "entity": "CRYPTOCURRENCY",
            "currency": "Bitcoin",
            "alphabetic_code": "BTC",
            "title": "Bitcoin",
            "symbol": "₿",
            "is_crypto": true,
            "data_from": "2024-03-02"
        },
        [...]
    }
}

Objetos de respuesta:

Últimas tarifas de punto final

https://currencyrateapi.com/api/latest?
    base=USD&
    quote=GBP,JPY,EUR

Parámetros de la solicitud:

Respuesta de la API:

{
    "success": true,
    "base": "usd",
    "date": "2026-01-22",
    "rates": {
        "gbp": "0.74350935478637",
        "jpy": "158.00358051914",
        "eur": "0.8518613169776"
    },
    "last_update_unix": "1769067006"
}

Objetos de respuesta:

Punto final de las tasas históricas

https://currencyrateapi.com/api/2025-08-25?
    base=EUR&
    quote=USD,GBP,CAD

Formato alternativo: /api/history?date=2025-08-25...

Parámetros de la solicitud:

Respuesta de la API:

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

Objetos de respuesta:

Código de muestra

PHP (cURL)

// Set API Endpoint (can be 'latest' or a date 'YYYY-MM-DD')
$endpoint = 'latest';

// Initialize CURL:
$ch = curl_init('https://currencyrateapi.com/api/'.$endpoint.'?base=USD"e=GBP,JPY');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Store the data:
$json = curl_exec($ch);
curl_close($ch);

// Decode JSON response:
$exchangeRates = json_decode($json, true);

// Access the exchange rate values, e.g. GBP:
echo $exchangeRates['rates']['GBP'];

JavaScript (búsqueda)

 // Set endpoint (can be 'latest' or a date 'YYYY-MM-DD')
const endpoint = 'latest';
const params = '?base=USD"e=GBP,JPY';

// Get exchange rates via the selected endpoint:
fetch('https://currencyrateapi.com/api/' + endpoint + params)
    .then(response => {
        return response.json();
    })
    .then(json => {

        // Exchange rate data is stored in json.rates
        console.log(json.rates.GBP);

        // Timestamp can be accessed in json.last_update_unix
        console.log(json.last_update_unix);
    })
    .catch(error => {
        console.error('Fetch error:', error);
    });