oneapi
Autentificare
Financiar v1 / Indici

IRCC aplicabil

Indicele de referinţă pentru creditele consumatorilor care se aplică efectiv la o dată — implicit
azi. Rata unui trimestru e media valorilor zilnice de acum DOUĂ trimestre (Q−2), iar răspunsul spune
din ce trimestru s-a calculat şi dacă valoarea vine din seria publicată de BNR sau a fost
calculată de noi din zilnice.

Atenţie: seria trimestrială publicată de BNR e media propriului trimestru, nu rata aplicabilă în
el. Citită direct, dă rata unui trimestru greşit.

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

Parametri de interogare

NumeTipDescriereValori acceptate
dataopțional string | null Opţional, YYYY-MM-DD. Implicit ziua curentă. Nu poate fi în viitor. ex. 2024-06-15ex. 2024-06-14

Cum se comportă

  • Indicele de referinţă pentru creditele consumatorilor care se aplică efectiv la o dată — implicit ziua curentă.
  • Rata unui trimestru e media valorilor zilnice de acum DOUĂ trimestre — T3 foloseşte media lui T1. Răspunsul spune din ce trimestru s-a calculat, în aplicabil.calculat_din, ca relaţia să fie verificabilă.
  • De ce două trimestre, nu unul (corectat 15 sep 2026): BNR publică media unui trimestru abia spre finalul trimestrului următor — pe 15 septembrie 2026 media T2 nu era încă publicată, deci nu putea fi rata aplicată din 1 iulie. Ratele raportate public se leagă la fel: 5,66% din ianuarie 2025 (media T3 2024), 5,55% din aprilie 2025 (T4 2024), 6,06% din octombrie 2025 (T2 2025). Până la corectare, ruta aplica media trimestrului anterior şi dădea rata cu un trimestru prea devreme.
  • Atenţie la seria publicată de BNR: valoarea trimestrială din baza interactivă e media PROPRIULUI trimestru, etichetată cu prima lui zi — nu rata aplicabilă în el. Citită direct, dă rata unui trimestru greşit. Verificat pe toate cele 30 de trimestre publicate: media propriului trimestru coincide exact cu valoarea oficială, zero diferenţe. De aceea ruta face decalajul, în loc să lase clientul să-l descopere.
  • Greşeala e greu de observat, fiindcă ambele cifre sunt reale şi de obicei apropiate. Nu mereu: în T4 2025 rata aplicabilă e 6,06 (media T2 2025), iar cine ia eticheta T4 2025 citeşte 5,58. Un credit indexat pe cifra greşită produce o rată plauzibilă şi incorectă.
  • aplicabil.sursa spune de unde vine valoarea: bnr dacă BNR a publicat deja media trimestrului-sursă, calculat dacă am calculat-o noi din seria zilnică. Cu decalajul de două trimestre, a doua situaţie apare practic doar la urmatorul_trimestru, înainte ca BNR să publice media — formula e aceeaşi, validată pe istoric.
  • urmatorul_trimestru apare doar când e deja determinabil: rata din T4 e media lui T2, deci se ştie din 1 iulie (întâi calculată de noi, apoi publicată de BNR), dar nu la mijlocul lui T2. O medie parţială ar arăta la fel şi n-ar fi rata — de aceea se întoarce null, cu motivul.
  • Prima rată aplicabilă e cea din trimestrul II 2019 (media trimestrului IV 2018, primul publicat). Pentru date anterioare răspunsul e 404.

La ce folosește

  • Rata de referinţă pentru un credit de consum cu dobândă variabilă.
  • Verificarea ratei aplicate de bancă într-un trimestru trecut.

Structura răspunsului

CâmpTipDescriere
data.aplicabil.la_data string
data.aplicabil.trimestru string Trimestrul în care se aplică (2026-T3), cu marginile lui.
data.aplicabil.de_la string Începutul intervalului acoperit.
data.aplicabil.pana_la string Sfârşitul intervalului acoperit, inclusiv.
data.aplicabil.valoare string Rata în procente, două zecimale, ca string.
data.aplicabil.sursa string bnr sau calculat.
data.aplicabil.calculat_din object Trimestrul din care s-a obţinut media, cu marginile şi — la valorile calculate — numărul de zile folosite.
data.aplicabil.calculat_din.trimestru string Trimestrul la care se referă valoarea.
data.aplicabil.calculat_din.de_la string Începutul intervalului acoperit.
data.aplicabil.calculat_din.pana_la string Sfârşitul intervalului acoperit, inclusiv.
data.aplicabil.calculat_din.valori_zilnice integer
data.urmatorul_trimestru null Rata trimestrului următor, dacă e deja determinabilă; altfel null.
data.motiv_urmator string trimestru_sursa_neincheiat când rata următoare nu se poate încă stabili.
meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.
meta.regula string Regula după care s-a calculat sau s-a ales valoarea.
meta.nota string Precizare despre cum se citesc datele din răspuns — o capcană, o convenţie sau o limită a sursei.
meta.avertisment_urmator string
meta.fara_date data e null, iar aici stă motivul. Trimestrul-sursă nu e acoperit de date (date anterioare lui 2019-T2, primul trimestru cu rată aplicabilă).
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/ircc
{
    "data": {
        "aplicabil": {
            "la_data": "2026-10-07",
            "trimestru": "2026-T4",
            "de_la": "2026-10-01",
            "pana_la": "2026-12-31",
            "valoare": "5.57",
            "sursa": "calculat",
            "calculat_din": {
                "trimestru": "2026-T2",
                "de_la": "2026-04-01",
                "pana_la": "2026-06-30",
                "valori_zilnice": 61
            }
        },
        "urmatorul_trimestru": null,
        "motiv_urmator": "trimestru_sursa_neincheiat"
    },
    "meta": {
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "regula": "Rata aplicabilă într-un trimestru e media aritmetică a valorilor zilnice de acum două trimestre (T3 foloseşte media lui T1). Seria BNR e etichetată cu trimestrul de calcul: media propriului trimestru coincide exact cu valoarea oficială pe toate trimestrele publicate.",
        "nota": "Valoarea e calculată de noi din seria zilnică, fiindcă BNR nu a publicat încă media trimestrului-sursă (o publică de regulă spre finalul trimestrului următor). Aceeaşi formulă, verificată pe seria istorică.",
        "avertisment_urmator": "Rata trimestrului următor devine determinabilă abia când se încheie trimestrul din care se calculează. O medie parţială ar arăta la fel, dar nu ar fi rata."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
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."
            ]
        }
    }
}