(NdM : Tempo est une offre commerciale d'EDF, cette dépêche traite des API et flux de données ouverts permettant de connaître et prédire les coûts du kWh.)

En avril 2025, une dépêche faisait le point sur les sources accessibles sans jeton pour connaître la couleur Tempo du jour, après la fermeture des anciennes URL d'EDF. La saison des jours rouges reprend le 1er novembre : voici une mise à jour, avec une nouveauté, des prévisions au delà de demain en JSON et en données ouvertes. Transparence d'abord : je fais partie de l'équipe de Calendrier Tempo EDF, l'une des sources présentées plus bas.

Rappel du contexte

L'option Tempo d'EDF compte 300 jours bleus, 43 blancs et 22 rouges par saison. Les jours rouges tombent entre le 1er novembre et le 31 mars, jamais un samedi ni un dimanche, et le kWh y coûte nettement plus cher. La couleur du lendemain est fixée par RTE et annoncée la veille. Pour piloter un chauffage ou une machine à laver depuis une box domotique, il faut donc une source lisible par une machine.

La couleur officielle (aujourd'hui et demain)

• RTE : la source officielle. Son API passe par un compte et un jeton sur le portail data de RTE. Les couleurs passées sont aussi publiées en données ouvertes : Tempo Like Supply Contract sur data.gouv.fr.
• api-couleur-tempo.fr : déjà citée en 2025, toujours là. JSON simple, sans clé, très utilisé dans les forums domotiques.
• Calendrier Tempo EDF : relaie la couleur officielle (via api-couleur-tempo.fr) sur /api/today et /api/tomorrow, qui renvoie "status": "unavailable" tant que la couleur de demain n'est pas publiée. Si vous lisez déjà RTE directement, gardez cette source : c'est l'originale.

Exemple :

curl https://www.calendrier-tempo.fr/api/today
{"status": "ok", "date": "2026-10-09", "couleur": "BLEU", "code": 1}

Les prévisions (après demain)

C'est ce qui a changé depuis 2025 : on trouve maintenant des prévisions en JSON, sans compte.

• Open DPE publie un fichier de prévisions jour par jour, avec une probabilité : https://open-dpe.fr/assets/tempo_days_lite.json
• Calendrier Tempo EDF publie /api/predictions : une prévision par jour jusqu'à J+15, avec la probabilité de chaque couleur et la température moyenne prévue, recalculée chaque soir à partir des prévisions de consommation de RTE, de la météo (Open‑Meteo) et des règles officielles de Tempo. /api/remaining donne les jours restants par couleur dans la saison.

Une prévision reste une prévision, et seule la couleur publiée fait foi. Plus l'échéance est lointaine, plus c'est une tendance qu'une certitude.

Vérifier avant de faire confiance

Plusieurs fils de forums domotiques l'ont montré l'hiver dernier : des prévisions affichées sans historique, on ne sait jamais ce qu'elles valent. Chez Calendrier Tempo EDF, chaque prévision est figée au moment où elle est émise, de J‑15 à la veille, puis comparée à la couleur réelle. L'historique complet, erreurs comprises, est consultable en ligne et téléchargeable en CSV sous licence CC BY 4.0 :

• Historique des prévisions sur data.gouv.fr
• CSV mis à jour chaque jour : https://www.calendrier-tempo.fr/historique-previsions.csv

De quoi mesurer soi‑même la fiabilité par échéance, et comparer les sources cet hiver.

Côté domotique

L'API ne demande ni compte ni clé, et les réponses sont en cache deux minutes : une requête toutes les trente minutes suffit largement. Des configurations prêtes à copier pour Home Assistant (intégration installable via HACS, sous licence MIT), Jeedom et Domoticz sont réunies sur une page : intégrations domotique. Documentation de l'API : https://www.calendrier-tempo.fr/api-tempo

Pour finir

Comme en 2025 : si vous connaissez d'autres sources sans jeton, ou si vous suivez la fiabilité des prévisions de votre côté, les commentaires sont là pour ça.

Suite à une question posée en 2023, cette dépêche propose un état des lieux des sources librement accessibles (sans imposer un jeton pour accéder aux API pour obtenir de manière structurée l’information) permettant de suivre les jours en tensions pris en compte dans l’option tarifaire TEMPO chez EDF. Cette option tarifaire consiste à payer moins cher l’électricité à condition de la payer 3 fois plus cher 22 jours dans l’année : les jours en tensions, généralement durant l’hiver.

Cette option permet de lisser la charge sur le réseau de transport de l’électricité. Pour faire bon usage de cette option, il faut surveiller la couleur du jour pour déterminer s’il vaut mieux réduire le chauffage électrique et les autres sources de consommations électriques. L’information est affichée le jour même sur le compteur électrique, mais il peut être utile d’être prévenu. On peut consulter le site de EDF, mais il peut être plus intéressant de disposer d’une API pour récupérer cette information, et ainsi pouvoir l’intégrer dans un système domotique, par exemple.

Sommaire

• Les anciennes APIs ne fonctionnent plus
• À la recherche d’une solution de remplacement
• Conclusion

Les anciennes APIs ne fonctionnent plus

En effet, les forums domotiques attestent que c’était pourtant très utilisé, depuis le 29/08/2024 (avant-veille du changement de saison Tempo) les URL concernées (resp. couleur du jour+lendemain et compteurs saison en cours) répondent en erreur:

Couleurs jour/lendemain
Totaux en cours

À la recherche d’une solution de remplacement

On voit une autre URL apparaître ces derniers jours sur les forums, mais elle ne donne pas spécifiquement les couleurs jour/lendemain mais des compteurs: nombre de jours bleus, rouges et blancs depuis le début de l’année. Il faudrait donc déduire la couleur du jour en fonction de ce qui change d’un jour à l’autre! On a vu plus simple, mais comme ça marche pas on ne risque pas de l’utiliser:
URL nouvelle

{
    “errors”: [],
    “content”: [
        {
            “typeJourEff”: « TEMPO_BLANC »,
            “libelle”: « TEMPO BLANC 2024 2025 »,
            “nombreJours”: 43,
            “premierJour”: « 2024-09-01 »,
            “dernierJour”: « 2025-08-31 »,
            “premierJourExclu”: null,
            “dernierJourExclu”: null,
            “nombreJoursTires”: 0,
            “etat”: “OUVERTE”
        },
        {
            “typeJourEff”: « TEMPO_BLEU »,
            “libelle”: « TEMPO BLEU 2024 2025 »,
            “nombreJours”: 300,
            “premierJour”: « 2024-09-01 »,
            “dernierJour”: « 2025-08-31 »,
            “premierJourExclu”: null,
            “dernierJourExclu”: null,
            “nombreJoursTires”: 12,
            “etat”: “OUVERTE”
        },
        {
            “typeJourEff”: « TEMPO_ROUGE »,
            “libelle”: « TEMPO ROUGE 2024 2025 »,
            “nombreJours”: 22,
            “premierJour”: « 2024-11-01 »,
            “dernierJour”: « 2025-03-31 »,
            “premierJourExclu”: null,
            “dernierJourExclu”: null,
            “nombreJoursTires”: 0,
            “etat”: « NON_COMMENCEE »
        }
    ]
}

Le site d’EDF utilise une API interne indiquant la couleur, jour par jour, pour une plage de dates donnée. Il faut remplir quelques en-têtes HTTP pour que la requête soit acceptée :

curl \
    'https://api-commerce.edf.fr/commerce/activet/v1/calendrier-jours-effacement?option=TEMPO&dateApplicationBorneInf=2023-9-12&dateApplicationBorneSup=2023-9-15&identifiantConsommateur=src' \
    -H 'accept: application/json, text/plain, */*' \
    -H 'cache-control: no-cache' \
    -H 'content-type: application/json'

Exemple de réponse:

{
    “errors”: [],
    “content”: {
        “dateApplicationBorneInf”: « 2023-09-12 »,
        “dateApplicationBorneSup”: « 2023-09-16 »,
        “dateHeureTraitementActivET”: « 2024-09-11T11:19:26Z »,
        “options”: [
            {
                “option”: “TEMPO”,
                “calendrier”: [
                    {
                        “dateApplication”: « 2023-09-12 »,
                        “statut”: « TEMPO_BLEU »
                    },
                    {
                        “dateApplication”: « 2023-09-13 »,
                        “statut”: « TEMPO_BLEU »
                    },
                    {
                        “dateApplication”: « 2023-09-14 »,
                        “statut”: « TEMPO_BLEU »
                    },
                    {
                        “dateApplication”: « 2023-09-15 »,
                        “statut”: « TEMPO_BLEU »
                    }
                ]
            }
        ]
    }
}

Ces APIs semblent répondre en erreur « La syntaxe de la requête est erronée » aléatoirement lorsqu’on y accède avec curl. Une requête peut fonctionner une fois puis subitement cesser de répondre. S’agit-il d’une limitation du nombre de requêtes venant de la même IP? D’une authentification à effectuer pour avoir le droit de faire des requêtes? Ou juste d’un système complètement buggé qui plante une fois sur 10?

Pour ceux, que j’imagine nombreux, a qui cela va poser problème et qui ne veulent (ou peuvent) obtenir l’info via un module téléinfo à monter sur son compteur, il y a une URL dont je n’ai pas trouvé référence sur le site de RTE (qui ne propose que des API à jetons) qui se trouve en regardant le github source d’un site tiers donnant également l’info:
Source tierce

L’info délivrée par le compteur arrive en prime bien plus tardivement: En début de soirée au lieu de fin de matinée. C’est parce qu’elle transite par Enedis, une autre entreprise qui se charge de la distribution de l’électricité (les lignes à basse tension et les compteurs électriques).

On peut donc utiliser cette indirection ou regarder les sources afin de trouver l’URL en question, pour laquelle on a une info hélas bien plus verbeuse où il faut faire son marché : on récupère un JSON de tous les jours écoulés depuis le début de la saison en cours, et il faut :

— extraire l’info aux bonnes dates,
— refaire ses compteurs de jours bleu/blanc/rouge pour savoir s’il reste des jours rouges ou blancs prévus avant la fin de l’hiver,
— traiter le flag “fallback” qui, selon la documentation, indique un mode dégradé, mais ce flag ne semble jamais être mis à “true” dans l’historique des données disponibles, et son rôle exact n’est pas clair.

Conclusion

Il est au final navrant qu’EDF remplace un truc simple qui marchait très bien par un machin alambiqué qui tombe en marche une fois sur 10…

Je ne donne pas l’URL librement accessible, mais non documentée, de RTE car je n’aimerais pas qu’elle croule sous les demandes: Ceux qui sont capables de l’utiliser de manière raisonnée sans exploser des quotas sauront bien la trouver avec les infos données!

(RTE, Réseau de Transport de l’Électricité est l’entreprise qui s’occupe du réseau électrique à haute tension en France. Ce sont eux qui déterminent les jours où le réseau va être très chargé, et c’est ça qui détermine le prix de l’électricité).

Un avantage à l’utiliser, c’est que l’info est disponible encore plus tôt qu’elle ne l’était chez EDF (c’était généralement MAJ peu après 11h00), permettant d’anticiper encore un peu plus un jour rouge, sachant qu’ils sont souvent en série, si on a quelques lessives à lancer…

S’il y a des suggestions d’alternatives (sans jetons d’API) non citées, merci de les indiquer en commentaires.