Financiar v1 / Indici

IRCC zilnic

Seria zilnică a indicelui, pe un interval. E informativă: contractele de credit nu se indexează
pe valoarea zilnică, ci pe media trimestrială — pentru rata care se aplică efectiv, vezi /ircc.

GET

https://oneapi.ro/api/financiar/v1/ircc/zilnic

Parametri de interogare

NumeTipDescriereValori acceptate

de_laobligatoriu string Obligatoriu, YYYY-MM-DD. ex. 2024-06-15ex. 2024-01-01

pana_laopțional string | null Opţional, implicit ziua curentă. ex. 2024-06-15ex. 2024-06-30

Cum se comportă

Seria zilnică a indicelui, pe un interval.
Contractele de credit NU se indexează pe valoarea zilnică, ci pe media trimestrială. Pentru rata care se aplică efectiv, foloseşte /ircc. Ruta asta e separată tocmai ca cele două să nu fie confundate: într-un răspuns comun, cineva ar lua inevitabil cifra greşită.
meta.medie_interval e media pe intervalul cerut. Coincide cu rata aplicabilă doar dacă intervalul e exact un trimestru calendaristic — altfel e doar o medie, nu o rată.
Intervalul e limitat la 366 de zile, acelaşi plafon ca la seria de curs, din acelaşi motiv: o margine declarată, nu o limită de performanţă.

La ce folosește

Grafic al evoluţiei zilnice a indicelui.
Recalcularea unei medii trimestriale pas cu pas.

Structura răspunsului

CâmpTipDescriere

data.de_la string Începutul intervalului, cum l-ai trimis.

data.pana_la string Sfârşitul intervalului, cum l-ai trimis.

data.valori[].data string Ziua observaţiei.

data.valori[].valoare string Indicele zilei, în procente pe an. ⚠️ Informativ: rata care se aplică unui credit e media TRIMESTRIALĂ, de la /financiar/v1/ircc.

meta.valori integer Observaţiile zilnice din interval: {data, valoare}. Vector GOL când intervalul n-are publicări, nu null.

meta.medie_interval string | null

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/ircc/zilnic?de_la=2024-06-15&pana_la=2024-06-15

{
    "data": {
        "de_la": "2024-06-15",
        "pana_la": "2024-06-15",
        "valori": []
    },
    "meta": {
        "valori": 0,
        "medie_interval": null,
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "nota": "Valoare informativă. Rata care se aplică unui credit e media trimestrială — vezi /financiar/v1/ircc. `medie_interval` e media pe intervalul cerut, care coincide cu rata aplicabilă doar dacă intervalul e exact un trimestru calendaristic."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/ircc/zilnic?de_la=2024-06-15&pana_la=2024-06-30

{
    "data": {
        "de_la": "2024-06-15",
        "pana_la": "2024-06-30",
        "valori": [
            {
                "data": "2024-06-17",
                "valoare": "5.93"
            }
        ]
    },
    "meta": {
        "valori": 9,
        "medie_interval": "6.00",
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "nota": "Valoare informativă. Rata care se aplică unui credit e media trimestrială — vezi /financiar/v1/ircc. `medie_interval` e media pe intervalul cerut, care coincide cu rata aplicabilă doar dacă intervalul e exact un trimestru calendaristic."
    }
}

GEThttps://oneapi.ro/api/financiar/v1/ircc/zilnic?de_la=2024-01-01&pana_la=2024-06-30

{
    "data": {
        "de_la": "2024-01-01",
        "pana_la": "2024-06-30",
        "valori": [
            {
                "data": "2024-01-03",
                "valoare": "5.96"
            }
        ]
    },
    "meta": {
        "valori": 105,
        "medie_interval": "5.92",
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "nota": "Valoare informativă. Rata care se aplică unui credit e media trimestrială — vezi /financiar/v1/ircc. `medie_interval` e media pe intervalul cerut, care coincide cu rata aplicabilă doar dacă intervalul e exact un trimestru calendaristic."
    }
}

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.
422	validare	`interval_prea_lung` (peste 366 de zile), `de_la` lipsă sau în viitor, `pana_la` înainte de `de_la`.
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": "validare",
        "mesaj": "interval_prea_lung (peste 366 de zile), de_la lipsă sau în viitor, pana_la înainte de de_la.",
        "detalii": {
            "de_la": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}