DEV Community

SM
SM

Posted on

25 ans de taux de change officiels en Afrique de l'Ouest — en un seul appel API

#webdev #datascience #api #fintech

25 ans de taux de change officiels en Afrique de l'Ouest — en un seul appel API

Le naira nigérian s'échangeait à environ 130 dollars en 2015. En 2023, il avait chuté au-delà de 700. Début 2024, il a franchi le seuil de 1 500. Si vous vouliez étudier cette dépréciation de manière programmatique — la visualiser, la modéliser, construire un produit par-dessus — vous aviez une option réaliste : payer Trading Economics 50 $/mois, ou assembler des feuilles de calcul à la main depuis le site de la Banque Centrale du Nigeria.

Il existe maintenant une meilleure solution.

Ce que c'est

west-africa-fx-rates est un actor Apify qui scrape et normalise les taux de change officiels publiés quotidiennement par les banques centrales d'Afrique de l'Ouest. Il couvre 11 pays, 4 devises ISO, avec des données historiques remontant à 1996 — le tout dans un schéma JSON cohérent et unique.

Couverture :

  • Nigeria (NGN) — taux officiel NFEM de la Banque Centrale du Nigeria
  • Ghana (GHS) — taux médian de la Bank of Ghana
  • 8 pays de l'UEMOA — Bénin, Burkina Faso, Côte d'Ivoire, Guinée-Bissau, Mali, Niger, Sénégal, Togo (XOF, via BCEAO/BCE)
  • Cap-Vert (CVE, via Banco de Cabo Verde/BCE)

Les données proviennent directement des banques centrales émettrices — pas des publications annuelles de la Banque Mondiale avec 6 à 12 mois de décalage, pas d'agrégateurs qui ne précisent pas l'origine du chiffre.

Le franc CFA et le mécanisme de parité (utile à comprendre)

Huit des onze pays partagent le franc CFA ouest-africain (XOF), arrimé à l'euro par traité depuis 1999 — à exactement 655,957 XOF pour 1 EUR, un taux qui n'a jamais varié depuis sa création et qui est garanti par le Trésor français. Il n'existe pas de taux USD indépendant pour le XOF. Le taux en dollar est dérivé mathématiquement du taux de référence EUR/USD quotidien publié par la Banque Centrale Européenne.

C'est utile à savoir si vous construisez quoi que ce soit sur les données de change ouest-africaines. Cela signifie :

  • Les 8 pays de l'UEMOA ont des taux de change identiques — une seule source couvre tous les pays
  • Le taux XOF/USD évolue en phase avec EUR/USD, et non avec une politique monétaire locale
  • L'escudo cap-verdien (CVE) est également arrimé à l'euro, selon un traité similaire à 110,265 CVE/EUR

L'actor gère tout cela de manière transparente : les taux dérivés sont signalés via rateType: "derived" et sharedRate: true, mais chaque pays conserve sa propre ligne pour faciliter les filtres et les jointures par code ISO.

Deux produits distincts en un seul actor

Pour les usages quotidiens : le snapshot usd-core

Un seul appel API, une seule facturation (0,10 $), dernier taux USD pour les 11 pays. Si vous développez une calculatrice de transferts, un moteur de tarification transfrontalier, ou un tableau de bord fintech qui a besoin du taux officiel CBN ou BoG du jour — c'est la solution.

{
  "country": "SN",
  "currency": "XOF",
  "date": "2026-05-28",
  "usdMid": 613.24,
  "rateType": "derived",
  "sharedRate": true,
  "midMethod": "derived_from_ecb",
  "source": {
    "bank": "BCEAO / Banque Centrale Européenne",
    "url": "https://www.bceao.int",
    "retrievedAt": "2026-05-28T08:34:12Z",
    "licence": "Données factuelles officielles, attribution incluse"
  }
}
Enter fullscreen mode Exit fullscreen mode

Avec un planning quotidien à 0,10 $ par exécution, le coût est d'environ 2,20 $/mois pour les 11 pays.

Pour les chercheurs : la série historique

C'est le produit qui n'existe nulle part ailleurs à ce prix. Une année complète de taux USD quotidiens pour les 11 pays coûte 11,40 $. Dix ans coûtent 114 $. La série nigériane remonte à une plage arbitraire ; l'UEMOA et le Ghana remontent respectivement à 1999 et 1996.

# Extraire 10 ans d'historique NGN et GHS
{
  "mode": "historical",
  "countries": ["NG", "GH"],
  "dateFrom": "2016-01-01",
  "dateTo": "2026-01-01"
}
Enter fullscreen mode Exit fullscreen mode

Cette plage temporelle couvre la crise des changes nigériane de 2016, la crise de la dette ghanéenne de 2022 et l'effondrement du cédi qui s'en est suivi, ainsi que la dépréciation du naira de 2023–24. Trois événements monétaires majeurs en Afrique, données quotidiennes propres, un seul appel API.

Qualité des données : ce qui a demandé du travail

Quelques fonctionnalités qui ont nécessité un vrai effort d'ingénierie et qui comptent si vous utilisez ces données en production :

Attribution de la source sur chaque enregistrement. Nom de la banque, URL, horodatage de récupération, date de référence et note de licence sur chaque ligne de sortie. Vous savez toujours exactement d'où vient un chiffre.

Documentation du midMethod. Le taux médian est calculé différemment selon les banques centrales — certaines le publient directement, d'autres ne publient que les cours acheteur/vendeur. Ce champ documente la méthode utilisée pour chaque source.

Garde de fraîcheur. Toute source dont la dernière date publiée remonte à plus de 10 jours est silencieusement exclue de l'output plutôt que de retourner des données périmées comme si elles étaient actuelles.

Tableau de warnings. Les anomalies (cours acheteur supérieur au cours vendeur, variation journalière anormalement élevée) sont signalées par enregistrement sans faire planter l'exécution.

Récupération indépendante des sources. La panne du site d'une banque centrale ne fait pas échouer l'exécution — vous récupérez les données des autres sources avec un avertissement dans l'enregistrement concerné.

À qui s'adresse cet actor ?

Développeurs fintech — en particulier dans l'écosystème de la diaspora nigériane et ghanéenne. Si vous développez sur Paystack, Flutterwave, ou toute infrastructure de paiement transfrontalier et que vous avez besoin du taux officiel CBN NFEM pour la conformité réglementaire, c'est la source programmatique la plus propre disponible.

Chercheurs quantitatifs — la dynamique des devises africaines est sous-étudiée en partie parce que des données historiques propres et normalisées n'existaient pas. 25+ ans de taux officiels quotidiens pour 11 pays dans un schéma cohérent constitue un jeu de données significatif pour la recherche.

Plateformes e-commerce et SaaS transfrontalières — les entreprises opérant sur plusieurs marchés d'Afrique de l'Ouest ont besoin d'inputs de change fiables pour leurs modèles de tarification. L'output normalisé sur 11 pays est conçu exactement pour ce cas d'usage.

Journalistes et data journalists — la trajectoire de dépréciation du naira, le débat sur l'arrimage du franc CFA, l'effondrement du cédi ghanéen lié à la dette souveraine. Ce sont des sujets qui ont besoin de données. Cet actor retourne des données structurées et attribuées, directement exploitables dans un graphique.

Base légale

Il est important d'être explicite sur ce point, car les produits de données africains ont un historique compliqué en matière de conditions de redistribution.

La CBN Nigeria accorde explicitement la permission de copier les données avec attribution — mentionné directement sur leur page de taux de change. La Bank of Ghana et la BCE (source pour XOF et CVE) ne comportent aucune restriction contractuelle de redistribution. L'actor s'appuie sur le principe des données factuelles — le droit d'auteur protège l'expression créative, pas les chiffres bruts — et attribue chaque enregistrement à sa banque émettrice.

La justification légale complète est documentée dans le README de l'actor. Chaque enregistrement contient la note de licence correspondante dans son bloc source.

Tarification

Mode Prix
Snapshot usd-core (11 pays) 0,10 $ par exécution
Ligne historical ou all-currencies 0,015 $ par point (pays, devise, date)

Planning quotidien usd-core : ~2,20 $/mois
Un an d'historique, 11 pays : ~11,40 $
Dix ans d'historique, 11 pays : ~114 $

Niveau gratuit disponible pour les nouveaux utilisateurs.

Ce qui arrive ensuite

Des actors pour l'Afrique de l'Est, l'Afrique australe et l'Afrique du Nord sont en cours de développement, dans le même schéma normalisé. La Gambie, la Guinée, le Libéria et la Sierra Leone sont les membres CEDEAO restants non encore couverts ; la reconnaissance des sources est en cours.

Pour commencer

→ API West Africa FX Rates sur l'Apify Store

Les données proviennent des publications officielles des banques centrales. L'attribution est incluse dans chaque enregistrement. Cet actor n'est ni affilié à ni approuvé par les banques centrales mentionnées. Les données sont fournies à titre informatif et ne doivent pas être utilisées comme seule base pour des décisions financières ou de trading.

Top comments (0)