API de planification des prix de l'électricité

Pourquoi un appareil doit-il connaître le prix de l'heure suivante ?

Pour intégrer davantage d'énergie renouvelable au réseau, c'est la demande qui doit suivre la production, et non l'inverse. Cette tâche revient aux appareils pilotables : une borne de recharge, un boiler, une batterie domestique ou un chauffage commandé par une application.

Le signal qui relie l'offre à la demande, c'est le prix, mais encore faut-il que l'appareil puisse le lire. Un boiler ne sait pas interpréter un contrat d'électricité, et son fabricant ne peut pas tenir à jour toutes les offres belges, encore moins celles de quinze pays. C'est exactement la lacune que comble cette API : elle transforme une offre commerciale, avec ses options et ses particularités locales, en une suite de périodes tarifées qu'une machine peut exploiter.

Que fait l'API de planification de Selectra ?

Elle qualifie le consommateur, puis expose le prix des périodes à venir. Trois points d'entrée, appelés dans cet ordre :

Une précision sur la qualification : c'est l'API elle-même qui construit le questionnaire, marché par marché. Elle renvoie la question suivante et les réponses admises, et l'intégrateur se contente de les afficher. Personne, côté client, n'a à maintenir la liste des fournisseurs belges ou de leurs options, qui changent sans cesse.

Quelles données renvoie l'API ?

La réponse est un tableau de périodes successives. Chacune porte une date de début, une date de fin, un prix du kWh, le nom de la plage tel que le fournisseur l'affiche, et la référence de l'index de compteur communicant correspondant. La réponse indique aussi la devise et l'heure de la prochaine actualisation.

{
  "prices": [
    {
      "name": "Heures pleines",
      "price": 0.3012,
      "start": "2026-09-09T07:00:00+02:00",
      "end": "2026-09-09T22:00:00+02:00",
      "distributor_reference": "1"
    },
    {
      "name": "Heures creuses",
      "price": 0.2189,
      "start": "2026-09-09T22:00:00+02:00",
      "end": "2026-09-10T07:00:00+02:00",
      "distributor_reference": "2"
    }
  ],
  "next_update": "2026-09-10T08:00:00+02:00",
  "currency": "EUR"
}

Quels pays sont couverts ?

L'API de planification des prix de Selectra est désormais active dans plus de 200 pays. En Europe, elle couvre 99 % de toutes les offres publiées, des tarifs fixes et bihoraires aux prix dynamiques et aux signaux d'effacement, et s'étend bien au-delà de l'Europe, jusqu'aux Amériques, à l'Asie, à l'Afrique, au Moyen-Orient et à l'Océanie. La Belgique est pleinement intégrée.

À l'échelle mondiale, l'API couvre plus de 3 700 fournisseurs et plus de 23 000 offres, de nouveaux marchés s'ajoutant régulièrement. La couverture porte sur les segments résidentiel et petites entreprises, les seuls dont les prix sont publiés ; les besoins de puissance supérieurs faisant généralement l'objet de prix sur mesure.

Et en détail pour la Belgique ?

En Belgique, l'API couvre tous les fournisseurs qui publient leurs prix résidentiels, en Flandre comme en Wallonie et à Bruxelles, soit 99 % des ménages. Le prix du kWh renvoyé additionne la composante énergie et les frais de distribution régulés, TVA comprise. Or ces frais dépendent du gestionnaire de réseau de l'adresse, qui fixe aussi les heures creuses : l'API tient compte des plages propres à chaque commune. Elle gère :

• les tarifs simples, et la redevance fixe qui accompagne le prix du kWh ;
• les tarifs bihoraires : les heures creuses commencent à 22 h et couvrent tout le week-end en Flandre et à Bruxelles, tandis que la Wallonie y ajoute chaque jour la plage de 11 h à 17 h ;
• les compteurs exclusif nuit, circuit séparé réservé au chauffage à accumulation ;
• l'option tarifaire « Impact » des gestionnaires de réseau wallons ;
• les contrats indexés ;
• plus de 40 contrats dynamiques, dont le prix suit heure par heure la bourse EPEX SPOT Belgique (Belpex), source utilisée sous licence ;
• le prix d'injection, pour un client équipé de panneaux solaires et soumis au tarif prosumer : chaque fournisseur fixe le sien, qui varie selon la région et suit, comme le prélèvement, un tarif simple ou bihoraire.

La couverture belge complète, les tarifs et une console de test figurent sur la page Belgique du catalogue.

Et pour classer toutes les offres belges ? L'API Comparateur

L'API de planification répond à la question « combien coûtera mon contrat dans les prochaines heures ? ». L'API Comparateur de Selectra répond à une autre question : combien coûterait chaque offre du marché à ce ménage précis, de la moins chère à la plus chère ? Elle alimente les pages de comparaison, les outils de changement de fournisseur et les systèmes de facturation. Active dans huit marchés européens, elle couvre en Belgique l'électricité et le gaz, séparément ou en offre combinée, avec des libellés renvoyés en français ou en néerlandais.

Méthode 1 : classer à partir d'une consommation annuelle

C'est ce dont a besoin une page de comparaison : le visiteur connaît à peu près sa consommation annuelle, pas les heures auxquelles il consomme. Un seul appel GET reçoit le code postal, la consommation en kWh et le type de compteur (simple, bihoraire, exclusif nuit ou Impact), et renvoie toutes les offres classées de la moins chère à la plus chère, taxes comprises pour un ménage. Pour un compteur bihoraire, un paramètre facultatif indique la part de consommation en heures creuses.

GET /v3/be/compare?energy_type=electricity&client_type=domestic&postcode=1000&car_base=3500

Méthode 2 : classer à partir des relevés du compteur

Un compteur communicant enregistre la consommation tous les quarts d'heure. Envoyez ces relevés (jusqu'à une année complète, directement ou sous forme de fichier CSV) et chaque intervalle est tarifé dans la plage où il tombe réellement. Plus besoin d'estimer la part d'heures creuses : elle est mesurée, avec les plages du gestionnaire de réseau de l'adresse. C'est aussi la seule façon juste de comparer un contrat dynamique à un contrat fixe, car les offres dynamiques sont calculées sur les prix EPEX SPOT publiés pour la période couverte. Une année complète au quart d'heure est tarifée en quatre secondes environ.

Pourquoi le code postal compte autant en Belgique

La Belgique est le marché où l'adresse pèse le plus. Le code postal désigne le gestionnaire de réseau, qui fixe les frais de distribution, détermine la région dont dépend la grille tarifaire du fournisseur, et publie la plage d'heures creuses du compteur. Un seul code postal règle les trois : c'est pourquoi les deux méthodes le demandent. Autre subtilité : les frais de réseau au kWh varient selon la tranche de consommation, si bien qu'une même offre ne coûte pas le même prix au kWh à 2 000 et à 6 000 kWh par an. L'API applique la bonne tranche.

Comment accéder à l'API, et à quel prix ?

L'accès passe par le catalogue sur api.selectra.com, qui héberge la documentation, une console de test et l'abonnement. Un accès gratuit, sans carte bancaire, ouvre les trois points d'entrée sur chaque marché couvert, de quoi construire une première intégration et juger les données avant d'envisager un contrat.

Au-delà, la facturation combine trois volets : un abonnement mensuel aux marchés utiles (marché par marché, ou un forfait Europe), un prix par appel qui diminue avec le volume, et des frais de mise en route incluant le support technique jusqu'à la production. Les montants à jour figurent en direct sur la page tarifs du catalogue, car ils sont lus directement depuis la facturation.

L'API Comparateur suit le même modèle : un abonnement mensuel par marché (la Belgique est vendue seule), un prix par appel et un accès gratuit avec un lot d'appels de test pour l'essayer sur des données réelles. Ses marchés et ses tarifs figurent sur la page de l'API Comparateur. Les requêtes répétées sont prévues pour ne rien coûter : quand une réponse n'a pas changé depuis le dernier appel, elle revient vide et n'est pas décomptée du quota.

À qui s'adresse l'API ?

Les intégrateurs se répartissent en quatre familles : les fabricants d'appareils pilotables et les éditeurs de systèmes de gestion de l'énergie (HEMS), qui ont besoin du prix pour décider quand s'allumer ; les fournisseurs d'énergie, qui veulent offrir le pilotage intelligent sans reconstruire une base de tarifs ; les acteurs de la flexibilité et de l'effacement, qui arbitrent entre prix de détail et signal réseau ; et les opérateurs de recharge, dont la valeur tient précisément au décalage d'une recharge de quelques heures.

Leur point commun : aucun n'a intérêt à devenir éditeur de données tarifaires. Maintenir les tarifs d'un seul pays mobilise déjà une équipe à temps plein, et la difficulté n'est pas le nombre de fournisseurs mais la vitesse à laquelle les options changent.

Pourquoi Selectra propose-t-elle cette API ?

Selectra compare les offres d'électricité depuis 2007. Ses fondateurs, Xavier Pinon et Aurian de Maupeou, ont vu dès l'ouverture des marchés que les offres se complexifieraient et que les consommateurs auraient besoin d'une meilleure information fondée sur les données de prix. L'API de planification suit la même logique : simplifier un sujet complexe pour accompagner l'électrification des usages.

Selectra opère dans 15 pays avec une équipe de 50 spécialistes des marchés de l'énergie qui tiennent à jour, en temps réel, ses sites et ses bases de données. Avec plus de 100 millions d'euros de chiffre d'affaires en 2024 et 2 000 collaborateurs, elle a les moyens de tenir cet entretien dans la durée. C'est la seule question qui compte vraiment lorsqu'on confie ses données tarifaires à un tiers.

Questions fréquentes