Sobry
Parce que chaque heure compte
API publique

Prix journaliers: v2

v2 Auth par clé API Serveur à serveur HTTPS uniquement
🔑

Présentation

L'API v2 de Sobry expose un unique endpoint pour lire les prix journaliers d'un contrat, le prix complet tout compris payé par le client, créneau par créneau, avec un indicateur vert/orange/rouge. Elle est conçue pour des intégrations serveur à serveur (scripts, tâches cron, domotique).

Authentification. Chaque requête nécessite une clé API par contrat transmise comme jeton Bearer dans l'en-tête Authorization. La clé est liée à un seul contrat : le contrat est déterminé automatiquement par la clé, vous n'avez rien à préciser.

Authorization: Bearer sob_apikey_<43 caractères>

Les clés API sont émises par Sobry (admin uniquement, pas en self-service). Demandez-en une à support@sobry.co. Pour des intégrations OAuth multi-utilisateurs, référez-vous plutôt à la documentation partenaire.

Sommaire
URL de base
https://api.sobry.co/v2
HTTPS uniquement

Authentification

Transmettez votre clé API par contrat comme jeton Bearer à chaque requête. La clé est un secret en clair préfixé sob_apikey_ suivi de 43 caractères base64url.

Schéma
Bearer sob_apikey_…
Scope
price:read
Liaison
1 clé = 1 contrat
Émission
Admin Sobry (support@sobry.co)

Gardez la clé côté serveur, ne l'exposez jamais dans un navigateur. La révocation est immédiate : une clé révoquée ou expirée renvoie 401 INVALID_API_KEY à la requête suivante.

GET /user/daily-prices clé API · price:read

Renvoie les prix journaliers du contrat lié à votre clé API, un point par créneau, chacun avec un indicateur de couleur (vert/orange/rouge) relatif au tarif réglementé (TRV).

Paramètres de requête

ParamètreStatutDescription
day OPTIONNEL Début de la plage, format YYYY-MM-DD. Par défaut : aujourd'hui.
days OPTIONNEL Étendue de la plage après day (entier 0–10). day et days se composent → renvoie day → day+days. Au-delà du day-ahead publié, les jours sont en prévision (estimated: true).
granularity OPTIONNEL 15m · 1h. Défaut 15m.
taxMode OPTIONNEL ht · ttc. Défaut ht. S'applique à price uniquement.

day seul → ce jour · days=N seul → aujourd'hui → J+N · day=X&days=N → X → X+N · aucun → aujourd'hui. Plafond : 10 jours (days ≤ 10).

Exemples

# un seul jour (le contrat vient de la clé API)
curl "https://api.sobry.co/v2/user/daily-prices?day=2026-06-12&granularity=15m&taxMode=ttc" \
  -H "Authorization: Bearer $SOBRY_API_KEY"

# plage multi-jours : aujourd'hui → J+3 (prévision au-delà du day-ahead)
curl "https://api.sobry.co/v2/user/daily-prices?days=3&granularity=1h" \
  -H "Authorization: Bearer $SOBRY_API_KEY"
const params = new URLSearchParams({
  day:         '2026-06-12',
  granularity: '15m',    // '15m' | '1h'
  taxMode:     'ttc'     // 'ht' | 'ttc'
});

const res = await fetch(`https://api.sobry.co/v2/user/daily-prices?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SOBRY_API_KEY}` }
});
const prices = await res.json();
import os, requests

r = requests.get(
    'https://api.sobry.co/v2/user/daily-prices',
    params={
        'day':         '2026-06-12',
        'granularity': '15m',         # '15m' | '1h'
        'taxMode':     'ttc',         # 'ht' | 'ttc'
    },
    headers={'Authorization': f"Bearer {os.environ['SOBRY_API_KEY']}"},
)
prices = r.json()

Réponse

200 OK application/json
[
  { "date": "2026-06-12", "time": "00:00", "color": "#F03131", "colorLabel": "RED",    "price": 0.18362, "rawPriceAmount": 0.11167, "estimated": false },
  { "date": "2026-06-12", "time": "11:15", "color": "#6CC264", "colorLabel": "GREEN",  "price": 0.07194, "rawPriceAmount": -0.00001, "estimated": false },
  { "date": "2026-06-13", "time": "00:00", "color": "#F0A631", "colorLabel": "ORANGE", "price": 0.15858, "rawPriceAmount": 0.09163, "estimated": true }
  // … un point par créneau et par jour (96/jour en 15m, 24 en 1h).
  // rawPriceAmount négatif = spot gratuit/négatif ; estimated=true = prévision (au-delà du day-ahead publié).
]

Champs de la réponse

ChampTypeDescription
datestringJour de livraison du créneau, YYYY-MM-DD (zone FR). Permet de distinguer les jours quand days renvoie plusieurs jours.
timestringDébut du créneau, HH:mm (Europe/Paris).
pricenumberPrix tout compris en €/kWh, dans le taxMode demandé (spot + TURPE + accise + marge + CEE/capacité, +TVA si ttc).
rawPriceAmountnumberPrix spot de gros brut en €/kWh (HT uniquement), avant marge/frais/acheminement/taxes Sobry. Indépendant du taxMode.
colorLabelenumGREEN · ORANGE · RED: niveau de prix vs. le tarif réglementé (TRV).
colorstringCouleur hex correspondant à colorLabel.
estimatedbooleantrue = prévision (jour futur, avant publication du day-ahead) ; false = day-ahead réalisé. Uniforme sur tous les créneaux d'un même jour.

Règle de couleur

GREEN: prix < 0,15 €/kWh  ·  ORANGE: 0,15 €/kWh ≤ prix ≤ TRV  ·  RED: prix > TRV

Codes d'erreur

Changelog