Financiar v1 / Bce

Randamentele de convergenţă Maastricht

Randamentul obligaţiunilor de stat pe termen lung, criteriul de convergenţă din Tratat, pentru statele
UE şi câteva agregate BCE — inclusiv România.

Atenţie: U2 (zona euro), D0, I9, I10 şi V5 nu sunt ţări, ci agregate BCE. Câmpul este_tara
le separă, ca să nu ajungă pe o hartă.

Unele serii nu se mai actualizează — Regatul Unit se opreşte în ianuarie 2020, iar Bulgaria are o
serie în leva încheiată la trecerea la euro, lângă cea nouă în euro. Ele poartă oprita: true şi
moneda, ca ultima lor valoare să nu fie citită drept actuală.

GET

https://oneapi.ro/api/financiar/v1/bce/convergenta

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Randamentul obligaţiunilor de stat pe termen lung — criteriul de convergenţă din Tratat — pentru statele UE şi câteva agregate BCE, inclusiv România.
Seria e lunară şi comparabilă între ţări tocmai pentru că metodologia e comună. Era piesa care lipsea: aveam ratele interne (ROBOR, IRCC, politica BNR), dar nu costul împrumutului statului pe termen lung, comparabil european.
U2 (zona euro), D0, I9, I10 şi V5 nu sunt ţări, ci agregate BCE. Câmpul este_tara le separă, ca să nu ajungă pe o hartă sau într-un clasament de ţări. meta.agregate numără câte astfel de entităţi sunt în răspuns.
Unele serii nu se mai actualizează: Regatul Unit se opreşte în ianuarie 2020, iar Bulgaria are două serii — în leva, încheiată la trecerea la euro, şi în euro. Ele poartă oprita: true (meta.oprite le numără), iar moneda deosebeşte cele două serii ale aceleiaşi ţări.

La ce folosește

Compararea costului de finanţare al statelor membre.
Urmărirea criteriului de convergenţă pentru România.

Structura răspunsului

CâmpTipDescriere

data.la_data string Data la care sunt valabile valorile întoarse.

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.randamente[].cod string Codul din nomenclatorul sursei — cheia pe care se filtrează.

data.randamente[].entitate string Codul entităţii, de regulă un cod de ţară.

data.randamente[].este_tara boolean false la agregate.

data.randamente[].moneda string Moneda obligaţiunilor (Z01 = toate monedele la un loc, la agregate).

data.randamente[].valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.

data.randamente[].luna string Luna ultimei observaţii — seria e lunară.

data.randamente[].oprita boolean true când seria nu mai are valori în ultima lună publicată pe restul grupului.

meta.sursa string Sursa oficială din care vin datele, cu licenţa ei acolo unde e cerută.

meta.entitati integer

meta.agregate integer Agregatele disponibile în răspuns.

meta.oprite integer

meta.nota string Precizare despre cum se citesc datele din răspuns — o capcană, o convenţie sau o limită a sursei.

meta.nota_oprite string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/bce/convergenta

{
    "data": {
        "la_data": "2026-10-07",
        "unitate": "procent_pe_an",
        "randamente": [
            {
                "cod": "IRS.M.AT.L.L40.CI.0000.EUR.N.Z",
                "entitate": "AT",
                "este_tara": true,
                "moneda": "EUR",
                "valoare": "3.4125",
                "luna": "2026-08",
                "oprita": false
            }
        ]
    },
    "meta": {
        "sursa": "Banca Centrală Europeană — flux SDMX IRS, randamente de convergenţă.",
        "entitati": 34,
        "agregate": 5,
        "oprite": 2,
        "nota": "Seria e lunară. Randamentul e cel al obligaţiunilor de stat pe circa 10 ani, folosit ca criteriu de convergenţă — comparabil între ţări tocmai pentru că metodologia e comună.",
        "nota_oprite": "`oprita: true` = seria nu mai are valori în ultima lună publicată pe restul grupului; `luna` e ultima ei observaţie, nu luna curentă. O ţară poate apărea de două ori când şi-a schimbat moneda (vezi `moneda`)."
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă sau invalid.
403	feature_indisponibil	`financiar.bce` nu e în planul curent.
429	cota_depasita	Rata sau cota planului a fost depăşită.

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": "neautentificat",
        "mesaj": "Token lipsă sau invalid."
    }
}