CurrencyRateAPI

Outil de lancement rapide

Besoin de tester l'API sans parcourir toute la documentation ? Rendez-vous dans le panneau de contrôle, où vous trouverez l'outil de lancement rapide : un moyen simple de tester tous les points de terminaison disponibles en un seul clic.

Cliquez sur le bouton ci-dessous pour vous inscrire gratuitement et commencer à utiliser l'outil de lancement rapide.

Commencer

Termes et concepts clés dont vous aurez besoin pour commencer à utiliser l'API des taux de change :

Réponse de l'API

Les taux de change fournis par CurrencyRateAPI sont par défaut en euros. Toutes les données sont renvoyées au format JSON standard et peuvent être facilement analysées à l'aide de n'importe quel langage de programmation.

Exemple de réponse :
Vous trouverez ci-dessous un exemple de réponse d'API contenant un éventail de devises mondiales courantes, toutes relatives à la devise EUR et accompagnées d'un horodatage de leur réception.

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

Comme indiqué ci-dessus, la réponse de l'API pour les taux de change en temps réel comprend plusieurs champs clés :

• success indique si la requête a abouti.
• base renvoie le code à 3 lettres de la devise de base utilisée pour cette requête.
• date renvoie la date réelle pour laquelle les taux de change sont fournis (format AAAA-MM-JJ).
• rates Elle contient la liste des devises demandées et leurs taux de change actuels.
• last_update_unix affiche l'horodatage (au format Unix) des dernières données disponibles dans le système.

Points de terminaison disponibles

L'API CurrencyRateAPI comprend plusieurs points de terminaison, chacun offrant des fonctionnalités spécifiques. La disponibilité de certains points de terminaison dépend de votre abonnement.

• Point final de la liste des devises. Ce point de terminaison renvoie la liste complète de toutes les devises prises en charge. /api/codes (Alternative: /api/currencies)
• Point final des derniers taux. Ce point de terminaison renvoie des données de taux de change en temps réel pour toutes les devises prises en charge. /api/latest
• Point final des taux historiques. Ce point de terminaison renvoie les données historiques des taux de change pour une date spécifique. /api/YYYY-MM-DD (Alternative: /api/history?date=YYYY-MM-DD). Les données historiques sont disponibles à partir du 4 janvier 1999.

Méthodologie des taux de change

Pour garantir l'exactitude et la cohérence des données, CurrencyRateAPI suit une méthodologie stricte pour la gestion et la diffusion des taux de change :

• Taux du marché intermédiaire : Par défaut, l'API renvoie les taux mid . Ceux-ci représentent la moyenne arithmétique entre les prix d'achat ( bid ) et de vente ( ask ) du marché, ou les taux de référence officiels des banques centrales.
• Finalisation de fin de journée (EOD) : Les taux historiques fournis par l'API sont définitifs à la fin de la journée en UTC (Temps universel coordonné).
• Calcul du taux croisé : Pour les paires de devises qui ne sont pas directement disponibles auprès de nos sources, le système calcule automatiquement des taux de change croisés très précis en utilisant les principales devises mondiales comme pont (pivot).
• Mécanisme de repli intelligent : Si les données pour une date demandée ne sont pas disponibles (par exemple, en raison de la fermeture des marchés les week-ends ou les jours fériés), le système recherche automatiquement le taux valide le plus récent dans une fenêtre glissante de 8 jours .
• Haute précision : Pour éviter les erreurs d’arrondi dans les calculs financiers, les taux de change sont stockés et traités avec jusqu’à 18 décimales .

Points d'extrémité

Point de terminaison des symboles pris en charge

https://currencyrateapi.com/api/codes

Ce point de terminaison renvoie la liste complète des devises prises en charge. Vous pouvez également utiliser l'alias /api/currencies.

Une liste lisible par l'humain de toutes les devises prises en charge est également disponible sur notre page Devises prises en charge .

Devises de base : Par défaut, certains autres points de terminaison (comme /latest et /{YYYY-MM-DD}) renvoient un ensemble limité de devises internationales majeures afin de minimiser le trafic. Ces devises « de base » sont :

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

Réponse de l'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"
        },
        [...]
    }
}

Objets de réponse :

Point de terminaison des derniers taux

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

Paramètres de la requête :

Réponse de l'API :

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

Objets de réponse :

Point final des taux historiques

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

Format alternatif : /api/history?date=2025-08-25...

Paramètres de la requête :

Réponse de l'API :

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

Objets de réponse :

Exemple de code

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 (récupération)

 // 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);
    });