Financiar v1 / Indici

Seria ROBOR pe un interval

Cotaţiile pentru 1–5 maturităţi între două date, grupate pe maturitate. Zilele fără publicare nu
apar în serie. Intervalul e limitat la 366 de zile.

GET

https://oneapi.ro/api/financiar/v1/robor/interval

Parametri de interogare

NumeTipDescriereValori acceptate

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

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

maturitatelistăopțional text Obligatoriu, 1–5: ?maturitate=3M,6M sau ?maturitate[]=3M&maturitate[]=6M. ONTN1W1M3M6M9M12M

Cum se comportă

Cotaţiile pentru una până la cinci maturităţi, între două date, grupate pe maturitate.
Zilele fără publicare nu apar în serie. Intervalul e limitat la 366 de zile — aceleaşi margini ca la seria de curs, ca cele două rute de serie să se comporte identic.
Seriile vin în ordinea maturităţilor cerute, nu în ordinea alfabetică a codurilor interne: 1M înaintea lui 3M, cum se aşteaptă cineva care citeşte o curbă.
meta.fara_valori listează maturităţile cerute care nu au nicio valoare în interval — tipic 9M pentru un interval de după 2019. Fără câmpul acesta, clientul ar primi mai puţine serii decât a cerut, fără să afle care lipsesc.

La ce folosește

Un grafic de evoluţie a ROBOR pe mai multe maturităţi.
Recalcularea unui grafic de rambursare pe toată perioada creditului.
Analiza formei curbei: cum se distanţează maturităţile între ele.

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.unitate string Mereu procent_pe_an.

data.serii[] object[] Câte o serie per maturitate cerută: {maturitate, denumire, valori[]}. Vector gol când nicio maturitate n-are valori în interval.

meta[] string[] Plicul răspunsului: sursa, prospeţimea şi precizările care însoţesc datele.

data.serii[].maturitate string Cheia din convenţia pieţei monetare (ON, 3M, 12M).

data.serii[].valori[] array Observaţiile maturităţii: {data, valoare}.

Exemple de răspuns

GEThttps://oneapi.ro/api/financiar/v1/robor/interval?de_la=2024-06-15&pana_la=2024-06-15&maturitate[]=ON

{
    "data": {
        "de_la": "2024-06-15",
        "pana_la": "2024-06-15",
        "unitate": "procent_pe_an",
        "serii": []
    },
    "meta": {
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "maturitati": 0,
        "valori": 0,
        "zile_interval": 1,
        "fara_valori": [
            "ON"
        ]
    }
}

GEThttps://oneapi.ro/api/financiar/v1/robor/interval?de_la=2024-06-15&pana_la=2024-06-30&maturitate[]=ON

{
    "data": {
        "de_la": "2024-06-15",
        "pana_la": "2024-06-30",
        "unitate": "procent_pe_an",
        "serii": [
            {
                "maturitate": "ON",
                "denumire": "overnight",
                "valori": [
                    {
                        "data": "2024-06-17",
                        "valoare": "6.00"
                    }
                ]
            }
        ]
    },
    "meta": {
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "maturitati": 1,
        "valori": 9,
        "zile_interval": 16
    }
}

GEThttps://oneapi.ro/api/financiar/v1/robor/interval?de_la=2024-06-01&pana_la=2024-06-14&maturitate[]=3M

{
    "data": {
        "de_la": "2024-06-01",
        "pana_la": "2024-06-14",
        "unitate": "procent_pe_an",
        "serii": [
            {
                "maturitate": "3M",
                "denumire": "trei luni",
                "valori": [
                    {
                        "data": "2024-06-03",
                        "valoare": "6.04"
                    }
                ]
            }
        ]
    },
    "meta": {
        "sursa": "Banca Naţională a României — baza de date interactivă.",
        "maturitati": 1,
        "valori": 10,
        "zile_interval": 14
    }
}

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), maturitate inexistentă, peste 5 maturităţi, `de_la` lipsă sau în viitor.
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), maturitate inexistentă, peste 5 maturităţi, de_la lipsă sau în viitor.",
        "detalii": {
            "de_la": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}