oneapi
Autentificare
Financiar v1 / Inflatie

Indicele preţurilor de consum (INS)

Seria lunară a IPC-ului publicat de Institutul Naţional de Statistică.

Valorile sunt variaţii lunare, nu niveluri: 100,58 înseamnă +0,58% faţă de luna precedentă.
Câmpul variatie_procent dă aceeaşi cifră ca procent, ca să nu fie citită ca un indice cu bază.
Pentru variaţia cumulată pe o perioadă, foloseşte /calcul/indexare.

GET
https://oneapi.ro/api/financiar/v1/ipc

Parametri de interogare

NumeTipDescriereValori acceptate
de_laobligatoriu string Obligatoriu, YYYY-MM. ex. 2024-06ex. 2024ex. 2024-06-15
pana_laopțional string | null Opţional, implicit ultima lună publicată. ex. 2024-06-30
categorieopțional string | null total (implicit), alimentare, nealimentare, servicii. totalalimentarenealimentareservicii

Cum se comportă

  • Seria lunară a IPC-ului publicat de Institutul Naţional de Statistică, pe categorii.
  • Valorile sunt VARIAŢII lunare, nu niveluri: 100,58 înseamnă +0,58% faţă de luna precedentă. Câmpul variatie_procent dă aceeaşi cifră ca procent, ca să nu fie citită ca un indice cu bază. data.natura o declară explicit.
  • Pentru variaţia cumulată pe o perioadă foloseşte /calcul/indexare: e PRODUSUL factorilor lunari, nu diferenţa dintre două valori. Diferenţa dintre două valori din această serie nu are nicio semnificaţie.
  • Categoriile: total (coşul complet), alimentare, nealimentare, servicii.
  • Datele vin din INS TEMPO prin modulul Ins, ca vedere materializată — o singură sursă de adevăr, reîmprospătată automat la fiecare import.
  • Nu se compară direct cu HICP: coşuri şi metodologii diferite. Pentru decembrie 2022, HICP dă 14,14% iar IPC 16,37%.

La ce folosește

  • Grafic al inflaţiei lunare.
  • Verificarea unei luni anume.

Structura răspunsului

CâmpTipDescriere
data.de_la string Începutul intervalului acoperit de răspuns.
data.pana_la string Sfârşitul intervalului acoperit de răspuns, inclusiv.
data.categorie string Categoria din clasificarea sursei.
data.natura string Mereu variatie_lunara pe această rută.
data.valori[].luna string Luna la care se referă valoarea.
data.valori[].valoare string Indicele faţă de luna anterioară.
data.valori[].variatie_procent string Aceeaşi cifră ca procent: valoare − 100.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.valori integer Valorile seriei, pe perioade.
meta.acoperire string Cât acoperă datele pe care le avem, faţă de ce publică sursa.
meta.natura string
meta.nota string Precizare despre cum se citesc datele din răspuns — o capcană, o convenţie sau o limită a sursei.
meta.fara_date data e null, iar aici stă motivul. Nu există date de IPC în bază. in_afara_acoperirii.
meta.fara_date_cod Cuvântul scurt şi STABIL al motivului, pentru clienţii care comută pe el în cod: fara_date e proză şi se poate reformula, ăsta nu.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/ipc?de_la=2024-06
{
    "data": {
        "de_la": "2024-06",
        "pana_la": "2026-07",
        "categorie": "total",
        "natura": "variatie_lunara",
        "valori": [
            {
                "luna": "2024-06",
                "valoare": "100.24",
                "variatie_procent": "0.24"
            }
        ]
    },
    "meta": {
        "sursa": "Institutul Naţional de Statistică — indicele preţurilor de consum.",
        "valori": 26,
        "acoperire": "1991-01 → 2026-07",
        "natura": "Fiecare valoare e un indice faţă de LUNA ANTERIOARĂ: 100,58 = +0,58%. Nu e un indice cu bază fixă şi nu se compară direct cu HICP.",
        "nota": "Pentru variaţia cumulată pe o perioadă, foloseşte /financiar/v1/calcul/indexare — produsul factorilor lunari, nu diferenţa dintre două valori."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareinterval_gol, interval_prea_lung, lună sau categorie malformată.
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": "interval_gol, interval_prea_lung, lună sau categorie malformată.",
        "detalii": {
            "de_la": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}