Ces réponses couvrent les questions techniques courantes concernant l’intégration à l’API Currency Data. Pour connaître tous les endpoints et paramètres, consultez la documentation de l’API. Pour obtenir une présentation de nos taux, consultez Comment fonctionne l’API Currency Data ?

Dans cet article

• Quel endpoint dois-je utiliser pour chaque type de taux ?
• Comment obtenir la liste complète des devises ?
• Quelles paires de devises l’endpoint bid et ask couvre-t-il ?
• Comment l’API gère-t-elle les devises obsolètes ?
• Comment obtenir les taux bid et ask d’une banque centrale ?
• Pourquoi un taux de banque centrale semble-t-il dater de la veille ?
• Puis-je mettre en cache les taux de l’API ?
• Comment obtenir le taux d’un jour passé à mon heure de verrouillage ?
• Comment trouver le certificat SSL de l’API ?
• Pourquoi mes requêtes expirent-elles ou renvoient-elles des erreurs 500 ?
• Dois-je autoriser certaines adresses IP ?
• Pourquoi mes requêtes renvoient-elles des erreurs 401 ou 403 ?

Quel endpoint dois-je utiliser pour chaque type de taux ?

Les taux des cryptomonnaies proviennent de nos taux du marché intermédiaire ; vous devez donc les demander via les endpoints du marché intermédiaire. Ajoutez crypto=true à votre requête pour les inclure.

Comment obtenir la liste complète des devises ?

Utilisez l’endpoint /v2/currencies. Pour chaque devise, il indique :

• s’il s’agit d’un code ISO 4217
• la date de son introduction et, si elle est obsolète, la date de son retrait
• les dates de début et de fin de disponibilité de nos taux pour cette devise
• la devise qui l’a remplacée, ainsi que tout rattachement

Par défaut, la liste inclut les devises actives et obsolètes. Pour modifier ce comportement :

• ajoutez obsolete=true pour afficher uniquement les devises obsolètes pour lesquelles nous disposons de données historiques
• ajoutez obsolete=false pour remplacer les devises obsolètes par la devise qui les a remplacées

Quelles paires de devises l’endpoint bid et ask couvre-t-il ?

L’endpoint /v1/bid_ask couvre les devises AUD, BRL, CAD, CHF, CNH, DKK, EUR, GBP, JPY, NOK, NZD, PLN, SEK et USD.

Vous pouvez demander n’importe quelle paire dans les deux sens, à l’exception des paires suivantes avec le CNH (yuan chinois offshore) :

• Le CNH n’est pas disponible avec le BRL, le DKK ou le PLN, dans aucun des deux sens.
• Le CNH est uniquement disponible comme devise cible avec le NOK et le SEK. Par exemple, vous pouvez demander from=NOK&to=CNH, mais pas from=CNH&to=NOK.

Comment l’API gère-t-elle les devises obsolètes ?

Les devises sont parfois renommées, réévaluées ou retirées. Par défaut, l’API répond avec la devise utilisée aujourd’hui : si vous demandez un code retiré, vous obtenez les taux de la devise qui l’a remplacé. Pour obtenir les taux correspondant au code retiré lui-même, ajoutez obsolete=true à votre requête.

Nous calculons les taux d’une devise obsolète après sa date de retrait à partir de son rattachement fixe à la devise qui l’a remplacée. Cela permet de conserver des historiques cohérents, mais il ne s’agit pas de taux de marché.

Pour plus de détails, notamment sur le calcul des moyennes et des statistiques lors d’un changement de devise, consultez Taux historiques et devises obsolètes dans la documentation de l’API.

Comment obtenir les taux bid et ask d’une banque centrale ?

Ajoutez fields=mid,bid,ask à votre requête /v1/central_bank_rate. Sans ce paramètre, vous n’obtiendrez que le taux moyen.

• Vous n’obtiendrez les taux bid et ask que pour les banques centrales qui les publient. 37 des 100 banques centrales le font, notamment la Banque du Japon, l’Autorité monétaire de Hong Kong, la Banque centrale du Brésil et la Banque de Thaïlande. La Banque centrale européenne, la Banque d’Angleterre et la Federal Reserve Bank of New York publient uniquement des taux de référence. La colonne Bid/Ask de la documentation de l’API indique quelles banques les publient.
• Les taux bid et ask concernent uniquement les taux actuels. Si vous ajoutez une date à votre requête, vous obtiendrez uniquement les taux moyens.
• Il s’agit des taux publiés par chaque banque centrale. Ils diffèrent des propres taux bid et ask de Xe provenant de l’endpoint /v1/bid_ask.

Pourquoi un taux de banque centrale semble-t-il dater de la veille ?

Si vous ne fournissez pas de date, /v1/central_bank_rate renvoie un timestamp en UTC. Lorsque vous le convertissez dans votre heure locale, le taux peut sembler dater de la veille.

Pour obtenir la date locale utilisée par la banque, ajoutez use_bank_date=true à votre requête. Par exemple, pour la Banque centrale européenne, vous obtiendrez 2026-08-17 au lieu de 2026-08-16T22:00:00Z. Cela fonctionne pour les réponses JSON, XML et CSV.

Puis-je mettre en cache les taux de l’API ?

Oui, pendant une durée limitée. La mise en cache permet à votre intégration de fonctionner plus rapidement et réduit le nombre de requêtes que vous effectuez. Supprimez les taux mis en cache une fois qu’ils ne sont plus à jour. La mise en cache consiste à conserver temporairement les taux. Elle ne signifie pas les stocker de façon permanente.

Comment obtenir le taux d’un jour passé à mon heure de verrouillage ?

Appelez /v1/historic_rate avec date=YYYY-MM-DD et use_lock_in_time=true. Vous obtiendrez le taux tel qu’il était à l’heure de verrouillage quotidienne de votre compte ce jour-là. Par exemple, vous pouvez utiliser cette méthode pour obtenir le taux du vendredi au cours de la semaine suivante.

Votre heure de verrouillage n’a aucune incidence sur les taux des banques centrales. Ceux-ci suivent le calendrier de publication propre à chaque banque.

Comment trouver le certificat SSL de l’API ?

Vous pouvez télécharger le certificat depuis votre navigateur, avec Chrome ou Edge.

Dans Chrome

1. Ouvrez Chrome et accédez à https://dfs.xe.com/dfs ou à https://xecdapi.xe.com/v1.

2. Sélectionnez l’icône des informations sur le site à gauche de la barre d’adresse.

   

3. Sélectionnez La connexion est sécurisée, puis Le certificat est valide.

   

4. Dans la fenêtre des détails du certificat, accédez à l’onglet Détails.

   

5. Sélectionnez Exporter pour télécharger le certificat sur votre système.

   

Dans Edge

1. Accédez à https://dfs.xe.com/dfs ou à https://xecdapi.xe.com/v1.

2. Sélectionnez l’icône représentant un cadenas dans la barre d’adresse.

   

3. Sélectionnez La connexion est sécurisée.
4. Sélectionnez l’icône du certificat en haut à droite de la fenêtre contextuelle.

5. Dans la fenêtre du certificat, ouvrez l’onglet Détails.

   

6. Sélectionnez Exporter pour télécharger le certificat.
   
   

Pourquoi mes requêtes expirent-elles ou renvoient-elles des erreurs 500 ?

La plupart des expirations intermittentes et des erreurs 5xx commencent au niveau du réseau ou de la passerelle entre votre système et le nôtre. Avant de nous contacter, vérifiez les éléments suivants :

• Passerelles et intergiciels : si vous appelez l’API via une plateforme d’intégration ou une passerelle d’API, consultez d’abord ses journaux. Les erreurs qu’elle génère elle-même peuvent ressembler à des erreurs provenant de notre API.
• DNS : ne codez pas en dur et ne mettez pas en cache notre adresse IP. Résolvez normalement xecdapi.xe.com et respectez les durées de vie DNS (TTL), car l’adresse IP associée peut changer.
• Délais d’expiration et pools de connexions : assurez-vous que les paramètres de votre client permettent de gérer le volume de vos requêtes. Répartissez les lots importants au lieu de les envoyer tous en même temps.
• TLS : votre client doit prendre en charge TLS 1.2 ou une version ultérieure avec des suites de chiffrement modernes (GCM). Les piles plus anciennes, comme Java 7 ou les anciennes versions de .NET, peuvent ne proposer que des chiffrements CBC, que nous sommes en train de retirer. Vous pouvez tester votre client avec https://xecd-rates-api-test.xe.com/, qui accepte uniquement TLS 1.3 et TLS 1.2 avec GCM.

Si les erreurs persistent, envoyez-nous un e-mail à data@xe.com en indiquant votre identifiant de compte, l’endpoint et les paramètres, les heures UTC auxquelles les erreurs se sont produites, ainsi que l’intégralité de la réponse d’erreur.

Dois-je autoriser certaines adresses IP ?

Non. L’API Currency Data ne restreint pas les appelants en fonction de leur adresse IP. Vous pouvez appeler https://xecdapi.xe.com depuis n’importe quelle adresse IP publique, et vous n’avez pas besoin d’enregistrer la vôtre auprès de nous.

Si votre pare-feu n’autorise les connexions sortantes que vers des adresses IP fixes, utilisez notre endpoint à adresse IP statique, xecd-proxy.xe.com, et ajoutez son adresse IP à votre liste d’autorisation pour connaître l’adresse IP actuelle. Nous envoyons un e-mail à tous les utilisateurs de cet endpoint avant toute modification de son adresse IP et avant toute opération de maintenance planifiée.

• Utilisez xecd-proxy.xe.com uniquement si vous avez besoin d’une adresse IP fixe. Sinon, appelez directement xecdapi.xe.com.
• Si les requêtes commencent à échouer après une modification du réseau de votre côté, vérifiez que la liste d’autorisation de votre pare-feu inclut toujours notre adresse IP statique.

Si vous utilisez le Datafeed (DFS) existant

DFS accepte uniquement les requêtes provenant d’adresses IP autorisées. Si les adresses IP de votre bureau ou de vos serveurs changent, envoyez-nous les nouvelles adresses. Si vous passez à l’API, vous n’aurez pas besoin d’autoriser d’adresses IP.

Pourquoi mes requêtes renvoient-elles des erreurs 401 ou 403 ?

• 401 Identifiants invalides : vérifiez l’identifiant de compte et la clé API envoyés par votre intégration. Les deux sont sensibles à la casse.
• 403 « nombre maximal de tentatives d’accès dépassé » : après 3 tentatives d’authentification échouées, nous bloquons le compte pendant 5 minutes au maximum. Le blocage s’applique à toutes les intégrations du compte, y compris celles qui utilisent les identifiants corrects. Cela signifie généralement qu’un autre système, comme un ancien serveur ou un script de test, envoie toujours une clé obsolète.

Pour résoudre une erreur 403 :

1. Trouvez le système qui envoie l’ancienne clé, puis mettez-le à jour ou désactivez-le.
2. Attendez 5 minutes, puis réessayez.