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ètre | Statut | Description |
|---|---|---|
| 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
[
{ "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
| Champ | Type | Description |
|---|---|---|
| date | string | Jour de livraison du créneau, YYYY-MM-DD (zone FR). Permet de distinguer les jours quand days renvoie plusieurs jours. |
| time | string | Début du créneau, HH:mm (Europe/Paris). |
| price | number | Prix tout compris en €/kWh, dans le taxMode demandé (spot + TURPE + accise + marge + CEE/capacité, +TVA si ttc). |
| rawPriceAmount | number | Prix spot de gros brut en €/kWh (HT uniquement), avant marge/frais/acheminement/taxes Sobry. Indépendant du taxMode. |
| colorLabel | enum | GREEN · ORANGE · RED: niveau de prix vs. le tarif réglementé (TRV). |
| color | string | Couleur hex correspondant à colorLabel. |
| estimated | boolean | true = 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