oneapi
Autentificare
Financiar v1 / CursIstoricPerioada

Curs de închidere lunar în lei vechi

Cursul de la sfârşitul lunii în ROL, aşa cum îl publică BNR — cifra de reevaluare a epocii.

„Sfârşit de perioadă" e cotaţia ultimei zile bancare din lună. Din 1998 încolo, unde există
seria zilnică, răspunsul dă şi ziua din care vine cifra: pentru o notă de reevaluare, ziua e
ce se trece în ea. Sub 1998 martorul lipseşte şi răspunsul o spune.

GET
https://oneapi.ro/api/financiar/v1/curs-istoric/inchidere

Parametri de interogare

NumeTipDescriereValori acceptate
lunaobligatoriu string | null Obligatorie: luna, AAAA-LL, între 1991-01 şi 2005-06. ex. 2003-12ex. 2001-06ex. 2000-06
valutalistăopțional text Opţional, USD sau EUR, separate prin virgulă. Fără el, ambele. ex. USD

Cum se comportă

  • Cursul de la sfârşitul lunii în lei vechi — cifra de reevaluare a epocii. Dolarul din 1991-01, euro din 1999-01, amândoi până în 2005-06.
  • „Sfârşit de perioadă" e cotaţia ultimei zile bancare din lună, nu o medie şi nici cotaţia zilei 31. Unde există seria zilnică — din 1998-01-05 — răspunsul dă şi ziua din care vine cifra: pentru o notă de reevaluare, ziua e ce se trece în ea. Sub 1998 martorul nu există, iar răspunsul o spune.
  • BNR nu publică o închidere anuală pentru epoca leului vechi, aşa că nici nu există o rută pentru ea. O cale neînregistrată spune „nu există" mai clar decât una care ar da 404 pentru totdeauna.
  • Fiecare cifră vine şi ca echivalent_ron, împărţită la 10.000.

La ce folosește

  • Reevaluarea unei creanţe în valută la sfârşitul unei luni din anii ’90.
  • Închiderea unui exerciţiu vechi, cu ziua din care vine cursul.

Structura răspunsului

CâmpTipDescriere
data.perioada string Perioada la care se referă valoarea.
data.de_la string Începutul intervalului acoperit de răspuns.
data.pana_la string Sfârşitul intervalului acoperit de răspuns, inclusiv.
data.epoca string
data.fel string
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.
data.valute[].valuta string Codul ISO 4217 al valutei.
data.valute[].eticheta string Eticheta afişabilă a valorii — versiunea citibilă a codului de alături.
data.valute[].valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.
data.valute[].echivalent_ron string Cifra în lei noi, împărţită la 10.000.
data.valute[].verificare.disponibila boolean
data.valute[].verificare.metoda string
data.valute[].verificare.ultima_zi_cotata string Ziua bancară din care vine cifra — ce se trece în nota de reevaluare.
data.valute[].verificare.calculat string
data.valute[].verificare.diferenta string
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.acoperire.de_la string Prima perioadă pentru care avem date.
meta.acoperire.pana_la string Ultima perioadă pentru care avem date.
meta.nota_martor string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_denominare string Denominarea din 2005 (1 leu nou = 10.000 lei vechi) şi ce înseamnă pentru comparaţii.
meta.zilnic string
meta.epoca_urmatoare string
meta.fara_date data e null, iar aici stă motivul. Cotaţia există la sursă, dar importul nostru e în urmă; răspunsul spune până când avem date.
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/curs-istoric/inchidere?luna=2003-12
{
    "data": {
        "perioada": "2003-12",
        "de_la": "2003-12-01",
        "pana_la": "2003-12-31",
        "epoca": "ROL",
        "fel": "inchidere",
        "unitate": "ROL pentru o unitate de valută",
        "valute": [
            {
                "valuta": "USD",
                "eticheta": "dolarul SUA",
                "valoare": "32595.000000",
                "echivalent_ron": "3.2595",
                "verificare": {
                    "disponibila": true,
                    "metoda": "ultima cotaţie a lunii",
                    "ultima_zi_cotata": "2003-12-31",
                    "calculat": "32595.00",
                    "diferenta": "0.00"
                }
            }
        ]
    },
    "meta": {
        "sursa": "BNR — cursul de schimb, serii lunare în lei vechi (clasa 703).",
        "acoperire": {
            "de_la": "1991-01",
            "pana_la": "2005-06"
        },
        "nota_martor": "Valoarea de sfârşit de perioadă e cotaţia ultimei zile bancare din lună. Unde există seria zilnică, `verificare` dă şi ziua din care vine cifra.",
        "nota_denominare": "`echivalent_ron` e cifra împărţită la 10.000, rata denominării din 2005-07-01.",
        "zilnic": "Cotaţiile zi cu zi ale aceleiaşi luni: /financiar/v1/curs-istoric/interval?de_la=2003-12-01&pana_la=2003-12-31",
        "epoca_urmatoare": "Din iulie 2005, în lei noi: /financiar/v1/curs-inchidere?luna=AAAA-LL."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
404dupa_denominareLuna e de după 2005-06; răspunsul trimite la /curs-inchidere. negasit — ca la ruta de medie.
422valuta_necunoscutaPe perioadă, în lei vechi, sursa publică doar o parte din valute; răspunsul dă lista. Lună lipsă, scrisă altfel decât AAAA-LL ori în afara 1991–2005. an nu există aici: BNR n-a publicat închideri anuale în epoca ROL.
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": "valuta_necunoscuta",
        "mesaj": "Pe perioadă, în lei vechi, sursa publică doar o parte din valute; răspunsul dă lista. Lună lipsă, scrisă altfel decât AAAA-LL ori în afara 1991–2005. an nu există aici: BNR n-a publicat închideri anuale în epoca ROL.",
        "detalii": {
            "luna": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}