Les données, directement depuis la plateforme
La même couche que celle que lisent les pages du site. Sans clé, sans inscription, du JSON sur HTTP. Chaque réponse indique de quelle source elle provient, à quel moment elle se rapporte et quelle est sa fraîcheur.
Le système électrique, en temps réel
Consommation, production par source et échanges transfrontaliers, tels que les publient les gestionnaires de réseau de transport. Ouvert.
| Adresse | Ce qu’il renvoie | Fréquence |
|---|---|---|
/api/v1/countries |
Chaque pays de la plateforme, avec ses zones et son état de couverture. | Change rarement — quand le registre change. |
/api/v1/countries/:iso2/latest |
L’instantané d’un pays : consommation, production par source, solde aux frontières. | Aussi souvent que son opérateur publie — de 10 secondes à une heure. |
/api/v1/countries/:iso2/history |
Une série temporelle pour un pays, sur une plage choisie. | La même fréquence que l’instantané. |
/api/v1/europe/latest |
Le total européen et chaque pays qui y entre. | Une minute. |
/api/v1/status |
L’état de la collecte : quelle source a publié en dernier, et quand. | En continu. |
/api/v1/licenses |
Ce que la plateforme a le droit de faire avec les données de chaque source. | Quand les conditions d’une source changent. |
/api/v1/search |
Recherche parmi les pays, les zones et les termes. | En continu. |
Le marché journalier
Les prix issus des enchères pour le lendemain, par zone de prix. Fermé pour l’instant — voir plus bas pourquoi.
| Adresse | Ce qu’il renvoie | Fréquence |
|---|---|---|
/api/v1/prices/latest451 · licence |
Le dernier prix connu pour chaque zone. | Une fois par jour, après l’enchère. |
/api/v1/prices/zones451 · licence |
Les zones de prix, avec le fuseau horaire et la devise de chacune. | Change rarement. |
/api/v1/prices/date451 · licence |
Toutes les zones, pour un jour de livraison choisi. | Chaque jour. |
/api/v1/prices/country/:iso2451 · licence |
Les prix d’un pays, pour chacune de ses zones. | Chaque jour. |
/api/v1/prices/:zone/history451 · licence |
L’historique d’une zone, intervalle par intervalle. | Chaque jour. |
/api/v1/prices/:zone/summary451 · licence |
Moyenne, minimum, maximum et quantiles par jour, semaine ou mois. | Chaque jour. |
/api/v1/market/cheapest451 · licence |
Les zones dont le prix moyen du jour est le plus bas. | Chaque jour. |
/api/v1/market/expensive451 · licence |
Les zones dont le prix moyen du jour est le plus élevé. | Chaque jour. |
/api/v1/market/spreads451 · licence |
L’écart entre l’heure la moins chère et l’heure la plus chère, par zone. | Chaque jour. |
/api/v1/market/cheapest-window451 · licence |
La fenêtre continue de N heures la moins chère dans une zone. | Chaque jour. |
/api/v1/market/weekly451 · licence |
Le rapport hebdomadaire, une fois la semaine close. | Chaque semaine. |
Pourquoi les routes de prix répondent par 451
Les données de marché proviennent de la plateforme de transparence ENTSO-E. Nous les collectons et les affichons sur le site avec la source indiquée à côté de chaque chiffre, mais les redistribuer par une API n’est pas la même chose que les afficher, et les conditions de réutilisation ne sont pas encore vérifiées ni enregistrées de notre côté.
D’ici là, les routes de prix renvoient 451 — le code signifiant « indisponible pour des raisons juridiques » — plutôt que de livrer discrètement ce que nous n’avons pas le droit de livrer. Le système de licences fonctionne par source, pas par pays ; leur ouverture ne demande donc aucune modification du code.
Règles de bonne conduite
Il n’y a pas de limite de requêtes, et nous aimerions qu’il ne soit pas nécessaire d’en fixer une. Les réponses portent un en-tête cache-control : respectez-le et vous obtiendrez exactement les mêmes chiffres sans demander deux fois. Les données en temps réel ne changent pas plus souvent que leur opérateur ne les publie — une requête par seconde pour un pays qui publie toutes les heures n’apporte rien de nouveau.
Si vous utilisez les données publiquement, citez la source d’origine (le gestionnaire de réseau de transport ou l’ENTSO-E), pas notre nom : nous les transportons, nous ne les produisons pas.
Voir aussi : Sources de données · Méthodologie · État du système · llms.txt