API BRVM Live

Démarrage rapide

Remplacez https://votre-domaine.tld par l’URL de votre instance. Les exemples ci-dessous s’adaptent automatiquement au domaine courant lorsque JavaScript est activé.

curl -s https://votre-domaine.tld/api/cours

const response = await fetch('https://votre-domaine.tld/api/cours');
const data = await response.json();

for (const action of data.actions) {
  console.log(action.symbole, action.cloture, action.variation_pct);
}

import requests

data = requests.get(
    "https://votre-domaine.tld/api/cours",
    timeout=10,
).json()

for action in data["actions"]:
    print(action["symbole"], action["cloture"])

=IMPORTDATA("https://votre-domaine.tld/api/cours?format=csv")

Endpoints

{
  "maj": "Vendredi, 6 novembre, 2026 - 22:45",
  "nombre": 48,
  "actions": [
    {
      "symbole": "ABJC",
      "nom": "SERVAIR ABIDJAN COTE D'IVOIRE",
      "volume": 3026,
      "cours_veille": 3395,
      "ouverture": 3400,
      "cloture": 3400,
      "variation_pct": 0.15
    }
  ],
  "source": "https://www.brvm.org/fr/cours-actions/0",
  "recupere_le": "2026-11-08T21:42:07.000Z",
  "mis_a_jour_le": "2026-11-08T21:42:07.000Z",
  "perime": false
}

curl -s "https://votre-domaine.tld/api/cours?symbole=ONTBF"

Content-Type: text/csv; charset=utf-8
Content-Disposition: attachment; filename="cours-brvm-2026-11-08.csv"

symbole,nom,volume,cours_veille,ouverture,cloture,variation_pct
ABJC,"SERVAIR ABIDJAN COTE D'IVOIRE",3026,3395,3400,3400,0.15

{
  "vues_total": 1024,
  "visiteurs_uniques": 312,
  "aujourd_hui": { "jour": "2026-11-08", "vues": 48, "uniques": 31 },
  "serie_30_jours": [
    { "jour": "2026-11-08", "vues": 48, "uniques": 31 }
  ]
}

{
  "statut": "ok",
  "version": "2.0.0",
  "uptime_s": 3600,
  "base_de_donnees": "ok",
  "cache": { "etat": "frais", "age_s": 120, "actions": 48 }
}

Format des données

Chaque action contient les champs suivants. Les valeurs numériques peuvent être null si la source ne les fournit pas.

Cache et fraîcheur

Les données sont mises en cache 30 minutes côté serveur. Si brvm.org est indisponible, la dernière réponse valide peut être servie jusqu’à 24 heures. Les en-têtes suivants permettent de savoir ce que vous recevez.

curl -sI https://votre-domaine.tld/api/cours | grep -i 'x-data\|cache-control'

Clé API

L’API est publique par défaut, avec un quota limité par IP. Des clés peuvent être configurées côté serveur pour identifier des consommateurs et leur donner un quota plus élevé.

curl -s https://votre-domaine.tld/api/cours \
  -H "X-API-Key: votre-cle-api"

curl -s https://votre-domaine.tld/api/cours \
  -H "Authorization: Bearer votre-cle-api"

Génération d’une clé côté serveur : openssl rand -hex 24, puis renseignez API_KEYS dans le fichier .env. Ne placez jamais une clé dans du code front-end.

Quotas et erreurs

Les quotas sont appliqués par IP sur une fenêtre glissante de 15 minutes.

{
  "erreur": "Trop de requêtes vers l’API, réessayez plus tard.",
  "reessayez_dans_secondes": 900
}

Bonnes pratiques

• N’interrogez pas l’API plus d’une fois par minute : les données sont déjà mises en cache 30 minutes.
• Utilisez X-Data-Updated-At ou le champ mis_a_jour_le pour afficher la fraîcheur.
• Prévoyez le cas perime: true et les valeurs null dans votre code.
• Pour Google Sheets ou Excel, préférez ?format=csv : plus léger et directement tabulaire.
• Attribuez la source : les données appartiennent à la BRVM et proviennent de brvm.org.
• Les cours sont indicatifs : ce n’est pas un conseil en investissement.