oneapi
Autentificare
Financiar v1 / Indici

ROBOR, toate maturităţile

Cotaţiile ROBOR pentru toate maturităţile care se mai publică (ON, TN, 1W, 1M, 3M, 6M, 12M), la
cea mai recentă zi publicată sau la o dată cerută. BNR publică în zilele bancare — răspunsul spune
cărei zile aparţin cotaţiile şi dacă e ziua cerută.

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

Parametri de interogare

NumeTipDescriereValori acceptate
dataobligatoriu string Obligatoriu, YYYY-MM-DD. Nu poate fi în viitor. ex. 2024-06-14ex. 2024-06-15ex. 2020-03-16

Cum se comportă

  • ?data= e obligatorie, iar răspunsul are mereu aceeaşi formă: data (ziua cerută), valoare (completată numai dacă avem exact ziua aia) şi ultima (ultima zi publicată la sau înainte de ea, cu valoarea ei). valoare rămâne gol DELIBERAT când ziua cerută n-are publicare — cifra de altă zi stă separat, sub ultima, ca să nu poată fi folosită din greşeală într-un calcul. Lipsa datelor nu mai e o eroare: răspunsul e 200, iar comparaţia data vs ultima.data spune tot.
  • Cotaţiile ROBOR pentru toate maturităţile care se mai publică: ON, TN, 1W, 1M, 3M, 6M şi 12M.
  • BNR publică în zilele bancare. Când ziua cerută nu e una dintre ele, cotaţiile aplicabile vin în ultima, cu ziua lor — acelaşi vocabular ca la cursul valutar.
  • Nu există plafon de vechime: ruta raportează ce există, iar cât de veche e cifra se vede din ultima.data. Pentru referinţă, pauza reală maximă între zile de publicare, pe seria din 1995 până azi, e de 7 zile.
  • Maturitatea 9M a fost oprită în noiembrie 2019 şi nu apare între cele curente. Istoricul ei rămâne interogabil cu o dată din perioada în care se publica.
  • Valorile sunt procente pe an, cu două zecimale, ca string — o rată nu circulă ca float.

La ce folosește

  • Afişarea cotaţiilor ROBOR ale zilei.
  • Rata de referinţă pentru un credit indexat la ROBOR.

Structura răspunsului

CâmpTipDescriere
data.data string Ziua cerută, exact cum ai trimis-o.
data.valoare.unitate string Mereu procent_pe_an.
data.valoare.cotatii[].maturitate string Cheia din convenţia pieţei monetare (ON, 3M, 12M).
data.valoare.cotatii[].denumire string Maturitatea în cuvinte.
data.valoare.cotatii[].valoare string Cotaţiile zilei cerute: {unitate, cotatii[]}. null dacă ziua aia n-are publicare.
data.ultima object Ultima zi publicată la sau înainte de data, cu cotaţiile ei: {data, valoare}. null doar dacă nu există nimic înaintea zilei cerute.
data.ultima.data string
data.ultima.valoare.unitate string Unitatea de măsură a valorilor. Citeşte-o înainte de a le pune pe un grafic sau de a le aduna.
data.ultima.valoare.cotatii[].maturitate string
data.ultima.valoare.cotatii[].denumire string Denumirea, aşa cum o publică sursa.
data.ultima.valoare.cotatii[].valoare string Cotaţiile zilei cerute: {unitate, cotatii[]}. null dacă ziua aia n-are publicare.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.nota_zi string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.maturitati integer
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/robor?data=2024-06-14
{
    "data": {
        "data": "2024-06-14",
        "valoare": {
            "unitate": "procent_pe_an",
            "cotatii": [
                {
                    "maturitate": "ON",
                    "denumire": "overnight",
                    "valoare": "6.00"
                }
            ]
        },
        "ultima": {
            "data": "2024-06-14",
            "valoare": {
                "unitate": "procent_pe_an",
                "cotatii": [
                    {
                        "maturitate": "ON",
                        "denumire": "overnight",
                        "valoare": "6.00"
                    }
                ]
            }
        }
    },
    "meta": {
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "nota_zi": "Valoare publicată în ziua cerută.",
        "maturitati": 7,
        "nota": "Maturitatea 9M a fost oprită în noiembrie 2019 şi nu apare între cele curente; istoricul ei se poate cere pe /financiar/v1/robor/9M?data=2019-11-08 (orice zi de până atunci) sau pe /financiar/v1/robor/interval?maturitate=9M&de_la=2019-01-01&pana_la=2019-11-08."
    }
}

Coduri de eroare

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