Financiar v1 / Bce

Curba randamentelor zonei euro

Randamentele spot pe 11 maturităţi, în două variante de emitent: doar emitenţi cu rating AAA şi toţi
emitenţii din zona euro. Punctele vin ordonate pe maturitate reală, nu alfabetic.

GET

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

Parametri de interogare

Ruta nu acceptă parametri de interogare.

Cum se comportă

Randamentele spot pe 11 maturităţi, de la 3 luni la 30 de ani, în două variante: doar emitenţi cu rating AAA şi toţi emitenţii guvernamentali din zona euro.
Punctele vin ordonate pe maturitate reală, nu alfabetic. Sortarea pe text ar da 10Y, 15Y, 1Y, 20Y, 2Y… — o curbă desenată aşa arată ca zgomot. luni e maturitatea în luni, folosită pentru ordonare şi utilă la interpolare.
Din cele 1.083 de serii ale fluxului luăm doar aceste două reprezentări: restul sunt aceeaşi mărime exprimată altfel — parametri Svensson, forward instantanee, par yields — adică milioane de rânduri fără informaţie nouă. Maturităţile sunt configurabile, deci setul se poate extinde fără cod.

La ce folosește

Desenarea curbei randamentelor.
Actualizarea unui flux de numerar la randamente de piaţă.

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.puncte[] object[] Numărul de puncte de date.

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

meta.maturitati integer

meta.variante.aaa string

meta.variante.toti_emitentii string

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

data.puncte[].maturitate string Eticheta maturităţii (3M, 10Y).

data.puncte[].luni integer Maturitatea în luni, pentru ordonare şi interpolare.

data.puncte[].aaa string Randamentul pe emitenţi AAA.

data.puncte[].toti_emitentii string Randamentul pe toţi emitenţii guvernamentali.

Exemple de răspuns

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

{
    "data": {
        "la_data": "2026-10-07",
        "unitate": "procent_pe_an",
        "puncte": [
            {
                "maturitate": "3M",
                "luni": 3,
                "aaa": "2.5582",
                "data": "2026-09-18",
                "toti_emitentii": "2.6349"
            }
        ]
    },
    "meta": {
        "sursa": "Banca Centrală Europeană — flux SDMX YC, curba randamentelor.",
        "maturitati": 11,
        "variante": {
            "aaa": "doar emitenţi cu rating AAA",
            "toti_emitentii": "toţi emitenţii guvernamentali din zona euro"
        },
        "nota": "Din cele 1.083 de serii ale fluxului luăm doar aceste două reprezentări pe 11 maturităţi: restul sunt aceeaşi mărime exprimată altfel — parametri Svensson, forward instantanee, par yields — adică milioane de rânduri fără informaţie nouă."
    }
}

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."
    }
}