oneapi
Autentificare
Energie v1 / Piaţa de energie

Consumul zonei de ofertare

Sarcina realizată a zonei de ofertare, în MW pe fiecare interval — consumul efectiv, nu prognoza.

GET
https://oneapi.ro/api/energie/v1/piata/consum

Parametri de interogare

NumeTipDescriereValori acceptate
de_laopțional string | null Începutul ferestrei. Implicit acum 7 zile. ex. 2026-09-05
pana_laopțional string | null Sfârşitul ferestrei. Implicit acum. ex. 2026-09-06
zonaopțional string | null Codul EIC al zonei de ofertare. Implicit România. Singura zonă importată azi e 10YRO-TEL------P; orice altă valoare dă 422, nu o serie goală. Lista e în /piata/acoperire, la zone_ofertare. 10YRO-TEL------P
per_paginaopțional text Câte intervale pe pagină, până la 2000. ex. 96
paginaopțional text Pagina, numărată de la 1. ex. 1

Cum se comportă

  • Istoricul are un gol, şi el se vede la /piata/acoperire. Seria începe în 2015, dar importul de istoric e încă în curs: în prezent lipsesc ~28-30 de luni (2015-03 → 2017-08). O cerere care cade în gol întoarce 200 cu listă goală — ceea ce NU înseamnă că piaţa n-a avut activitate, ci că perioada n-a fost adusă încă. Câmpul goluri din acoperire listează exact lunile care lipsesc, calculat din date, deci se micşorează singur pe măsură ce istoricul se completează.
  • E consumul realizat al zonei de ofertare (actual total load), nu prognoza publicată în avans. Sunt două serii diferite la sursă şi se abat una de la alta tocmai în zilele interesante.
  • Ca la producţie, valoarea e putere medie pe interval. Energia se obţine înmulţind cu durata — ruta de sumar o dă gata calculată.
  • Cifra nu se compară cu consumul din zona sen: acolo e o citire instantanee Transelectrica, aici e valoarea medie a intervalului, din altă sursă şi cu altă definiţie.

La ce folosește

  • Compari curba consumului cu cea a preţului, ca să vezi unde se formează vârfurile.
  • Normalizezi propriul consum la sarcina naţională, pentru un raport de eficienţă.
  • Alimentezi un model de prognoză cu sarcina realizată, nu cu cea prognozată.

Structura răspunsului

CâmpTipDescriere
data.serie[].valoare_mw number Consumul, ca putere medie pe interval, în MW.
data.serie[].rezolutie_min integer Durata intervalului, în minute.
data.serie[].moment string Începutul intervalului, în UTC.
data.fara_date null Prezent (nenul) DOAR când seria e goală, şi spune DE CE: motiv e dupa_acoperire (fereastra cerută e după ultimul punct importat), inainte_de_acoperire sau gol_in_acoperire (lipsă în mijlocul istoricului). acoperire dă capetele reale ale seriei. ⚠️ O serie goală NU înseamnă că piaţa n-a avut activitate.
data.observatie string Că e consum realizat, nu prognoză.
data.sursa object ENTSO-E Transparency Platform, cu atribuirea obligatorie.
meta.paginare.pagina integer Pagina curentă, numărată de la 1.
meta.paginare.per_pagina integer Câte înregistrări are o pagină.
meta.paginare.total integer Totalul înregistrărilor care se potrivesc, dincolo de pagina curentă.
meta.paginare.pagini integer Câte pagini are lista.

Exemple de răspuns

GEThttps://oneapi.ro/api/energie/v1/piata/consum
{
    "data": {
        "zona": "10YRO-TEL------P",
        "de_la": "2026-09-29 20: 39: 53",
        "pana_la": "2026-10-06 20: 39: 53",
        "fara_date": null,
        "serie": [
            {
                "moment": "2026-09-29T20: 45: 00+03: 00",
                "rezolutie_min": 15,
                "valoare_mw": 6879
            }
        ],
        "observatie": "E consumul REALIZAT al zonei de ofertare, nu prognoza. Putere medie pe interval, în MW.",
        "sursa": {
            "nume": "ENTSO-E Transparency Platform",
            "url": "https://transparency.entsoe.eu",
            "atribuire": "Date din ENTSO-E Transparency Platform.",
            "licenta": "Reutilizare permisă cu ATRIBUIRE obligatorie către Transparency Platform. Drepturile nu sunt sublicențiabile.",
            "observatie": "Zona `piata` e seria oficială europeană; zona `sen` e instantaneul Transelectrica. Au surse, pași și definiții diferite — cifrele lor nu se compară direct."
        }
    },
    "meta": {
        "paginare": {
            "pagina": 1,
            "per_pagina": 500,
            "total": 152,
            "pagini": 1
        }
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareFereastra e inversată.
429cota_depasitaCota lunară a planului a fost depăşită (vezi Retry-After).

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "Fereastra e inversată.",
        "detalii": {
            "de_la": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}