Financiar v1 / Serii

O serie BNR

Metadatele unei serii după codul ei: denumire, clasa din care provine, unitatea de măsură,
periodicitatea, acoperirea şi starea de prospeţime.

GET

https://oneapi.ro/api/financiar/v1/serii/{cod}

Parametri de cale

NumeTipDescriereExemplu

codobligatoriu string Codul seriei din baza de date interactivă a BNR (ex. AEDZ_DEN).

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Metadatele unei serii: denumire, clasa din care provine, unitatea de măsură, periodicitatea, acoperirea, numărul de valori şi starea de prospeţime.
404-ul are două cauze, deosebite prin codul din corp: negasit = codul nu există în catalog; nu_e_serie_temporala = codul aparţine unei clase de tip registru. A doua e informaţie utilă — datele există, doar nu ca serie temporală, iar un 404 gol ar lăsat impresia că lipsesc.
meta.valori dă direct calea către valorile seriei.
O serie cu stare: "fara_valori" există în catalogul BNR dar n-a fost completată niciodată: metadatele sunt reale, /serii/{cod}/valori întoarce o listă goală. Nu e o eroare, e un anunţ al sursei fără conţinut.

La ce folosește

Verificarea, înainte de a trage datele, ce unitate şi ce periodicitate are seria.
Afişarea unei etichete corecte pe un grafic, cu unitatea de măsură.
Controlul prospeţimii: până când merge seria şi câte valori are.

Structura răspunsului

CâmpTipDescriere

data[] object[]

meta[] string[] Plicul răspunsului: sursa, prospeţimea şi precizările care însoţesc datele.

data.cod string Codul seriei, cum l-ai cerut.

data.nume string Denumirea seriei.

data.clasa string Clasa din care face parte.

data.unitate string Unitatea de măsură, cum o publică sursa.

data.periodicitate string Pasul seriei; necunoscut unde sursa nu îl declară.

data.prima_data null Prima observaţie. null la seriile fără valori.

data.ultima_data null Ultima observaţie. null la seriile fără valori.

data.numar_valori integer Câte observaţii are seria.

data.stare string cu_valori ori fara_valori.

data.nota null Observaţie proprie seriei, unde există.

data.motiv_fara_valori string De CE n-are valori, în cuvinte — nu toate seriile din antetul BNR au observaţii sub ele. null la seriile cu valori.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/serii/AEDZ_DEN

{
    "data": {
        "cod": "AEDZ_DEN",
        "nume": "Monedă",
        "clasa": "Operaţiuni de piaţă monetară ale BNR - Active eligibile - diferenţe",
        "unitate": "(txt)",
        "periodicitate": "necunoscut",
        "prima_data": null,
        "ultima_data": null,
        "numar_valori": 0,
        "stare": "fara_valori",
        "nota": null,
        "motiv_fara_valori": "Sursa publică antetul clasei „Operaţiuni de piaţă monetară ale BNR — Active eligibile — diferenţe\" şi nicio observaţie sub el. Cele zece câmpuri (monedă, data emisiunii, data scadenţei, nivel haircut) descriu forma unui registru care n-a fost niciodată completat."
    },
    "meta": {
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "valori": "/financiar/v1/serii/AEDZ_DEN/valori",
        "nota_clasa_goala": "Clasa e anunţată de sursă şi niciodată completată. Artefactul adus de pipeline conţine antetul şi rândul `Data`, fără nicio observaţie sub el — nu e un import ratat, iar un fetch repetat n-ar aduce nimic."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/serii/BBZ_BOR3M

{
    "data": {
        "cod": "BBZ_BOR3M",
        "nume": "ROBOR 3 luni",
        "clasa": "ROBID - ROBOR - serii zilnice",
        "unitate": "% p.a.",
        "periodicitate": "zilnic",
        "prima_data": "1995-08-01",
        "ultima_data": "2026-09-21",
        "numar_valori": 7880,
        "stare": "pare_in_urma",
        "nota": "serii disponibile începând din august 1995",
        "urmatoarea_perioada": "2026-09-22",
        "importat_la": "2026-10-01 13: 41: 04"
    },
    "meta": {
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "valori": "/financiar/v1/serii/BBZ_BOR3M/valori"
    }
}

GEThttps://oneapi.ro/api/financiar/v1/serii/AEDZ_DIF

{
    "data": {
        "cod": "AEDZ_DIF",
        "nume": "Stare",
        "clasa": "Operaţiuni de piaţă monetară ale BNR - Active eligibile - diferenţe",
        "unitate": "(txt)",
        "periodicitate": "necunoscut",
        "prima_data": null,
        "ultima_data": null,
        "numar_valori": 0,
        "stare": "fara_valori",
        "nota": null,
        "motiv_fara_valori": "Sursa publică antetul clasei „Operaţiuni de piaţă monetară ale BNR — Active eligibile — diferenţe\" şi nicio observaţie sub el. Cele zece câmpuri (monedă, data emisiunii, data scadenţei, nivel haircut) descriu forma unui registru care n-a fost niciodată completat."
    },
    "meta": {
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "valori": "/financiar/v1/serii/AEDZ_DIF/valori",
        "nota_clasa_goala": "Clasa e anunţată de sursă şi niciodată completată. Artefactul adus de pipeline conţine antetul şi rândul `Data`, fără nicio observaţie sub el — nu e un import ratat, iar un fetch repetat n-ar aduce nimic."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
404	negasit	`negasit`, `nu_e_serie_temporala`, sau `serie_retrasa` — codul există în catalogul BNR, dar clasa lui e retrasă din API fiindcă valorile publicate acolo nu sunt observaţii.
429	cota_depasita	Cota 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": "negasit",
        "mesaj": "negasit, nu_e_serie_temporala, sau serie_retrasa — codul există în catalogul BNR, dar clasa lui e retrasă din API fiindcă valorile publicate acolo nu sunt observaţii."
    }
}