Comment fonctionne l’API de données monétaires ? – Centre d’aide Xe

L’API de données monétaires vous fournit le taux de chaque devise que nous couvrons par rapport à une devise de base de votre choix, à un moment précis. Elle fonctionne avec tous les logiciels capables d’effectuer des requêtes web.

Pour les questions techniques, notamment concernant le point de terminaison à utiliser ou le fonctionnement des codes de devises obsolètes, consultez notre FAQ destinée aux développeurs sur l’API de données monétaires.

Quelles devises l’API couvre-t-elle ?

L’API fournit les taux pour :

170 devises actuellement utilisées
212 devises si vous incluez les devises obsolètes
237 devises si vous incluez également les cryptomonnaies
4 métaux précieux

Elle fournit également les taux publiés par 100 banques centrales et 23 sources alternatives (voir la section Quels taux fournissez-vous ? ci-dessous).

Notre liste va au-delà de la norme ISO 4217. Elle inclut des devises offshore, comme le CNH, ainsi que des cryptomonnaies. Pour consulter la liste complète, notamment les dates d’introduction ou de retrait de chaque devise, consultez notre FAQ destinée aux développeurs.

À quelles plateformes ERP et CRM puis-je la connecter ?

L’API est un service REST : toute plateforme capable d’effectuer des requêtes web peut donc l’utiliser. Nos clients la connectent notamment aux plateformes suivantes :

SAP
Oracle
Microsoft
Sage
Salesforce
Workday

Ces partenaires proposent également des logiciels permettant de connecter d’autres systèmes à l’API :

Deltek
Insight Software (anciennement FX Loader)

Si vous utilisez Microsoft Business Central, vous pouvez obtenir notre module complémentaire sur Microsoft AppSource.

Quels taux fournissez-vous ?

Nos principaux taux sont ceux de Xe :

Taux comptants intermédiaires du marché : le point médian actuel entre les prix d’achat et de vente sur les marchés mondiaux des devises
Taux historiques intermédiaires du marché : taux intermédiaires du marché pour des dates et périodes passées
Taux comptants acheteur et vendeur (bêta) : prix d’achat et de vente indicatifs, mis à jour toutes les 10 secondes

Nous fournissons également des taux des banques centrales et des taux issus de sources alternatives. Il s’agit de taux officiels ou publiés par d’autres organisations, et non de taux propres à Xe. Chacun dispose de son propre point de terminaison.

Proposez-vous des taux d’ouverture et de clôture du marché ?

Non. Selon la fréquence de vos taux, vous pouvez calculer le taux d’ouverture ou de clôture à l’aide du paramètre temporel.

Nous mettons à jour les taux 24 heures sur 24, 7 jours sur 7, à l’aide de flux en direct provenant des marchés mondiaux des devises. Cela signifie que le taux d’une devise peut changer même lorsque les marchés de son propre pays sont fermés. Si une devise est peu négociée, nous utilisons les données les plus récentes disponibles.

Fournissez-vous des taux d’achat et de vente ?

Oui, en version bêta. Les taux acheteur et vendeur proviennent du point de terminaison Bid & Ask Rates (Beta), qui couvre les devises suivantes :

AUD, BRL, CAD, CHF, CNH, DKK, EUR, GBP, JPY, NOK, NZD, PLN, SEK et USD

Vous pouvez demander la plupart des paires dans les deux sens. Quelques paires impliquant le CNH (yuan chinois offshore) ne sont pas disponibles. Notre FAQ destinée aux développeurs les répertorie.

Certaines banques centrales et sources alternatives publient également leurs propres taux d’achat et de vente. Voir ci-dessous.

Fournissez-vous des taux à terme ?

Non. L’API ne prend pas en charge les taux à terme.

Fournissez-vous des taux historiques ?

Oui. Nos taux historiques remontent au 16 novembre 1995. Ils incluent les devises qui ont depuis été renommées, réévaluées ou retirées. Notre FAQ destinée aux développeurs explique comment les demander.

Pourquoi le taux ne change-t-il pas entre mes appels ?

La fréquence de variation de votre taux dépend de la fréquence de taux de votre forfait : quotidienne, horaire, toutes les 15 minutes ou en direct.

Les forfaits quotidiens renvoient le taux tel qu’il était à l’heure de verrouillage quotidienne de votre compte. Chaque appel jusqu’au prochain verrouillage renvoie le même taux. C’est ainsi que fonctionnent les taux quotidiens. Les données ne sont pas obsolètes.

Avec un forfait payant, vous pouvez définir votre heure de verrouillage et votre fuseau horaire dans l’application web. Les essais gratuits utilisent 00:00 UTC et vous ne pouvez pas modifier ce paramètre.
Si vous choisissez un fuseau horaire local, tel que America/New_York, votre heure de verrouillage en UTC change lors des changements d’heure. Choisissez UTC si vous avez besoin qu’elle reste fixe toute l’année.
Pour obtenir le taux d’un jour passé à votre heure de verrouillage, consultez notre FAQ destinée aux développeurs.

Fournissez-vous les taux des banques centrales ?

Oui. Le point de terminaison Central Bank Exchange Rates vous fournit les taux officiels publiés par 100 banques centrales, notamment la Banque centrale européenne, la Banque d’Angleterre et la Federal Reserve Bank of New York. Utilisez-le lorsque vous devez faire correspondre le taux de référence officiel d’un pays plutôt que le taux du marché.

Chaque banque centrale publie ses taux selon son propre calendrier. La plupart publient quotidiennement. Quelques-unes publient chaque semaine ou chaque mois. 37 d’entre elles publient également des taux d’achat et de vente, que vous pouvez demander en plus du taux intermédiaire.

La documentation de l’API répertorie chaque banque et indique quand elle publie ses taux. Notre FAQ destinée aux développeurs explique comment demander les taux d’achat et de vente.

Fournissez-vous d’autres types de taux ?

Oui, nous fournissons également des taux de cryptomonnaies et des taux issus de sources alternatives.

Cryptomonnaies : l’API couvre 12 cryptomonnaies. Leurs taux proviennent de nos taux intermédiaires du marché, vous les demandez donc de la même manière que toute autre devise.

Sources alternatives : il s’agit de taux publiés par des organisations autres que les banques centrales, telles que des banques commerciales, des places boursières et des autorités douanières et fiscales. Le point de terminaison Alternative Source Exchange Rates fournit les taux de 23 de ces sources. Utilisez-le lorsque vous devez faire correspondre les taux d’une banque ou d’un organisme gouvernemental spécifique.

La plupart des sources publient quotidiennement, et certaines mensuellement. 13 d’entre elles publient également des taux d’achat et de vente. La documentation de l’API répertorie toutes les sources.