oneapi
Autentificare
Financiar v1 / Indici

Rata de referinţă BNR

Rata dobânzii de politică monetară în vigoare la o dată — rata de referinţă din OG 13/2011 art. 3
alin. (4). Seria e o listă de DECIZII, nu o valoare pe zi: rata hotărâtă ţine până la decizia
următoare, iar răspunsul spune din ce zi e în vigoare cea întoarsă.

GET
https://oneapi.ro/api/financiar/v1/dobanda-referinta

Parametri de interogare

NumeTipDescriereValori acceptate
dataopțional string | null Opţional, YYYY-MM-DD. Implicit ziua curentă. Nu poate fi în viitor şi nu poate fi anterioară lui 2011-09-01. ex. 2024-06-15ex. 2020-06-15

Cum se comportă

  • Rata dobânzii de politică monetară în vigoare la o dată — rata de referinţă din OG 13/2011 art. 3 alin. (4).
  • Seria e o listă de DECIZII, nu o valoare pe zi. Rata hotărâtă de BNR ţine până la decizia următoare, deci valoarea la o dată e ultima decizie anterioară. Răspunsul spune din ce zi e în vigoare (in_vigoare_din), ca să se vadă că nu e o cotaţie zilnică.
  • Din ea decurg dobânzile legale, dar cu reguli de ancorare diferite pe cele două regimuri — vezi /dobanda-legala/civila şi /dobanda-legala/profesionisti.
  • Datele anterioare lui 2011-09-01 sunt refuzate. Până atunci rata de referinţă a BNR era taxa oficială a scontului, o serie distinctă care diferă de rata de politică monetară în 56 din 115 luni comune. Rata de politică monetară nu se extrapolează înapoi: rezultatul ar fi plauzibil şi greşit.

La ce folosește

  • Calculul dobânzii legale penalizatoare, care porneşte de la rata de referinţă.
  • Fundamentarea unei clauze contractuale de dobândă.
  • Verificarea ratei în vigoare la data unei scadenţe.

Structura răspunsului

CâmpTipDescriere
data.la_data string Data la care sunt valabile valorile întoarse.
data.valoare string Rata în procente pe an, două zecimale, ca string.
data.in_vigoare_din string Data deciziei BNR din care rata întoarsă e în vigoare.
data.unitate string Unitatea de măsură a valorilor. Citeşte-o înainte de a le pune pe un grafic sau de a le aduna.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.temei string Temeiul legal al valorilor sau al modului de calcul.
meta.nota string Precizare despre cum se citesc datele din răspuns — o capcană, o convenţie sau o limită a sursei.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/dobanda-referinta
{
    "data": {
        "la_data": "2026-10-07",
        "valoare": "6.50",
        "in_vigoare_din": "2024-08-08",
        "unitate": "procent_pe_an"
    },
    "meta": {
        "sursa": "Banca Naţională a României — deciziile de politică monetară.",
        "temei": "OG 13/2011 art. 3 alin. (4): nivelul ratei de referinţă se publică ori de câte ori se modifică rata de politică monetară.",
        "nota": "Rata ţine de la data din `in_vigoare_din` până la decizia următoare. Pentru dobânzile legale derivate, vezi /dobanda-legala/civila şi /dobanda-legala/profesionisti."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitalt_regim_juridic pentru date anterioare lui 2011-09-01; negasit dacă nu există decizie aplicabilă.
422validareDată malformată sau în viitor.
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": "Dată malformată sau în viitor.",
        "detalii": {
            "data": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}