oneapi
Autentificare
Financiar v1 / Indici

ROBOR pe o maturitate

Cotaţia unei maturităţi la ziua cerută — ?data= e obligatorie. Zilele fără publicare au
valoare gol, iar ultima cotaţie anterioară vine în ultima, cu ziua ei.

GET
https://oneapi.ro/api/financiar/v1/robor/{maturitate}

Parametri de cale

NumeTipDescriereExemplu
maturitateobligatoriu string Maturitatea cotaţiei (ON, TN, 1W, 1M, 3M, 6M, 9M, 12M).

Parametri de interogare

NumeTipDescriereValori acceptate
dataobligatoriu string Obligatoriu: ziua, AAAA-LL-ZZ (?data=2020-03-16). Nu poate fi în viitor. ex. 2024-06-14ex. 2020-03-16ex. 2019-06-14

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ţia unei singure maturităţi, la ziua cerută (?data=AAAA-LL-ZZ, obligatorie).
  • Zilele fără publicare au valoare gol, iar ultima cotaţie anterioară vine în ultima. Fără plafon de vechime: la o maturitate oprită, ultima.data arată exact unde s-a încheiat seria.
  • O maturitate scrisă greşit (5M) întoarce 422 cu lista celor valabile, nu un 404 gol.
  • Maturitatea oprită nu mai e o eroare, ci un fapt despre serie: la 9M (oprită în noiembrie 2019) ultima arată unde s-a încheiat, iar meta.oprita spune de ce nu mai creşte. Cu o data din perioada în care se publica, 9M întoarce cotaţia reală în valoare. Un cod inexistent (5M) rămâne 422, cu lista celor valabile.

La ce folosește

  • Calculul unei dobânzi variabile legate de ROBOR la o zi anume.
  • Verificarea ratei folosite într-un extras sau într-un grafic de rambursare.
  • Un indicator afişat într-un tablou de bord financiar.
  • Reconstituirea ratei folosite la o scadenţă din trecut.
  • Verificarea dobânzii aplicate de bancă la o dată anume.

Structura răspunsului

CâmpTipDescriere
data.data string Ziua cerută, exact cum ai trimis-o.
data.valoare.maturitate string
data.valoare.denumire string Denumirea, aşa cum o publică sursa.
data.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.valoare.valoare string Cotaţia zilei cerute: {maturitate, denumire, unitate, valoare}. null dacă ziua aia n-are publicare.
data.ultima object Ultima zi publicată la sau înainte de data, cu cotaţia ei: {data, valoare}. La o maturitate oprită (9M), aici se vede exact unde s-a încheiat seria.
data.ultima.data string
data.ultima.valoare.maturitate string Maturitatea, aşa cum o numeşte BNR.
data.ultima.valoare.denumire string Denumirea, aşa cum o publică sursa.
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.valoare string Cotaţia zilei cerute: {maturitate, denumire, unitate, valoare}. 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 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/3M?data=2024-06-14
{
    "data": {
        "data": "2024-06-14",
        "valoare": {
            "maturitate": "3M",
            "denumire": "trei luni",
            "unitate": "procent_pe_an",
            "valoare": "6.02"
        },
        "ultima": {
            "data": "2024-06-14",
            "valoare": {
                "maturitate": "3M",
                "denumire": "trei luni",
                "unitate": "procent_pe_an",
                "valoare": "6.02"
            }
        }
    },
    "meta": {
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "nota": "Valoare publicată în ziua cerută."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404negasitNu există nimic pentru maturitate din cale.
422validareMaturitate inexistentă (răspunsul le listează), dată lipsă, malformată ori î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": "Maturitate inexistentă (răspunsul le listează), dată lipsă, malformată ori în viitor.",
        "detalii": {
            "maturitate": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}