Financiar v1 / TitluriStat

Decontarea titlurilor de stat

Ce s-a decontat prin SaFIR şi — partea pe care nicio altă rută din modul n-o are — ce a eşuat.
Zilnic, din 15 octombrie 2012.

Eşecurile de decontare sunt rare, şi tocmai de aceea merită căutate. Operaţiuni nedecontate din
lipsă de instrumente: 64 de zile din 3.492 (1,8%), maximul 25,98 milioane euro pe 7 mai 2015.
Din lipsă de fonduri: 20 de zile (0,6%), maximul 47,31 milioane pe 29 februarie 2016. Ultimul eşec
a fost în martie 2022 — peste patru ani fără niciunul.

doar_esecuri=1 întoarce numai zilele cu incidente: altfel, cine le caută parcurge trei mii de zile
ca să găsească şaizeci.

NU se compară cu /titluri-stat/piata-secundara, şi asta e măsurat, nu presupus. Numele clasei
sugerează „aceeaşi piaţă fără BNR", dar datele nu susţin o relaţie de submulţime: valorile coincid
în lei doar în 47,0% din cele 3.492 de zile comune, la precizia de o zecimală a pieţei secundare
(numărul de operaţiuni coincide în 46,0%), iar seria de aici e peste cealaltă în 6,0% dintre ele. Ce anume le desparte — perimetru, moment, reguli de
includere — nu se poate stabili din date, deci ruta nu inventează o explicaţie şi nu oferă o
comparaţie.

Zero înseamnă zero, nu lipsă. În 98% din zile decontarea merge fără eşec, iar acela e un zero
real, nu o valoare neraportată.

total_echivalent_eur e suma celor două monede la cursul zilei — verificat: raportul faţă de
RON / curs + EUR stă între 0,9992 şi 1,0010, deci cifra e reconstruibilă, nu opacă.

rezumat se calculează pe toate zilele din fereastră, nu pe cele întoarse: cu doar_esecuri, un
rezumat făcut din rezultatul filtrat ar spune că 100% din zile au avut eşecuri.

GET

https://oneapi.ro/api/financiar/v1/titluri-stat/decontare

Parametri de interogare

NumeTipDescriereValori acceptate

de_laobligatoriu string Obligatoriu, YYYY-MM-DD. Nu poate fi în viitor. ex. 2024-06-15ex. 2024-01-02

pana_laopțional string | null Opţional. Implicit ultima zi publicată. Maximum 366 de zile. ex. 2024-06-30ex. 2024-06-28ex. 2024-06-15

doar_esecuriopțional boolean | null Opţional, 1/0. Întoarce numai zilele cu operaţiuni nedecontate. ex. true

Cum se comportă

Ce s-a decontat prin SaFIR şi — partea pe care nicio altă rută din modul n-o are — ce a eşuat. Zilnic, din 15 octombrie 2012.
Eşecurile de decontare sunt rare, şi tocmai de aceea merită căutate. Operaţiuni nedecontate din lipsă de instrumente: 64 de zile din 3.492 (1,8%), maximul 25,98 milioane euro pe 7 mai 2015. Din lipsă de fonduri: 20 de zile (0,6%), maximul 47,31 milioane pe 29 februarie 2016. Ultimul eşec a fost în martie 2022 — peste patru ani fără niciunul.
doar_esecuri=1 întoarce numai zilele cu incidente. Fără el, cine le caută parcurge trei mii de zile ca să găsească şaizeci. Când în fereastra cerută nu e niciunul, răspunsul e 404 fara_esecuri şi spune când a fost ultimul din toată seria.
NU se compară cu /titluri-stat/piata-secundara, şi asta e măsurat, nu presupus. Numele clasei sugerează „aceeaşi piaţă fără BNR", dar datele nu susţin o relaţie de submulţime: valorile în lei coincid, la precizia de o zecimală a pieţei secundare, în doar 47,0% din cele 3.492 de zile comune (numărul de operaţiuni coincide în 46,0%), iar seria de aici e peste cealaltă în 6,0% dintre ele. Ce anume le desparte — perimetru, moment, reguli de includere — nu se poate stabili din date, deci ruta nu inventează o explicaţie şi nu oferă o comparaţie.
Zero înseamnă zero, nu lipsă. În 98% din zile decontarea merge fără eşec, iar acela e un zero real, nu o valoare neraportată.
total_echivalent_eur e suma celor două monede la cursul zilei — verificat: raportul faţă de RON / curs + EUR stă între 0,9992 şi 1,0010, deci cifra e reconstruibilă, nu opacă.
rezumat se calculează pe TOATE zilele din fereastră, nu pe cele întoarse. Cu doar_esecuri, un rezumat făcut din rezultatul filtrat ar spune că 100% din zile au avut eşecuri — pentru 2015 spune corect 9 din 253.
Marginile din afara acoperirii se aliniază tăcut la ea, iar meta.ajustat spune ce s-a mutat şi de la ce. Plafonul e 366 de zile, ca la celelalte rute zilnice.

La ce folosește

Sănătatea infrastructurii pieţei: cât de des eşuează o decontare şi din ce cauză.
Volumul zilnic decontat, pe lei şi pe euro, în echivalent euro.
Găsirea rapidă a zilelor cu incidente, fără parcurgerea întregii serii.

Structura răspunsului

CâmpTipDescriere

data.de_la string Începutul intervalului acoperit de răspuns.

data.pana_la string Sfârşitul intervalului acoperit de răspuns, inclusiv.

data.doar_esecuri boolean

data.zile[].data string

data.zile[].are_esecuri boolean true dacă ziua a avut cel puţin o operaţiune nedecontată.

data.zile[].total_echivalent_eur object Cele trei stări — decontate, lipsă instrumente, lipsă fonduri — în echivalent euro.

data.zile[].total_echivalent_eur.decontate string

data.zile[].total_echivalent_eur.lipsa_instrumente string

data.zile[].total_echivalent_eur.lipsa_fonduri string

data.zile[].pe_moneda object Aceleaşi trei stări, cu număr şi valoare, separat pe lei şi pe euro.

data.zile[].pe_moneda.lei.decontate.numar integer Numărul de elemente numărate.

data.zile[].pe_moneda.lei.decontate.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.

data.zile[].pe_moneda.lei.lipsa_instrumente.numar integer Numărul de elemente numărate.

data.zile[].pe_moneda.lei.lipsa_instrumente.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.

data.zile[].pe_moneda.lei.lipsa_fonduri.numar integer Numărul de elemente numărate.

data.zile[].pe_moneda.lei.lipsa_fonduri.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.

data.zile[].pe_moneda.lei.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.zile[].pe_moneda.euro.decontate.numar integer Numărul de elemente numărate.

data.zile[].pe_moneda.euro.decontate.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.

data.zile[].pe_moneda.euro.lipsa_instrumente.numar integer Numărul de elemente numărate.

data.zile[].pe_moneda.euro.lipsa_instrumente.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.

data.zile[].pe_moneda.euro.lipsa_fonduri.numar integer Numărul de elemente numărate.

data.zile[].pe_moneda.euro.lipsa_fonduri.valoare string Valoarea publicată de sursă pentru combinaţia de mai sus.

data.zile[].pe_moneda.euro.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.rezumat.zile integer Câte zile publicate are fereastra, indiferent de filtru.

data.rezumat.zile_cu_esecuri integer Câte dintre ele au avut incidente.

data.rezumat.total_echivalent_eur.decontate string

data.rezumat.total_echivalent_eur.lipsa_instrumente string

data.rezumat.total_echivalent_eur.lipsa_fonduri string

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

meta.acoperire.de_la string Prima perioadă pentru care avem date.

meta.acoperire.pana_la string Ultima perioadă pentru care avem date.

meta.zile_publicate integer Numărul total de cotaţii din răspuns, peste toate seriile.

meta.zile_intoarse integer

meta.zile_cu_esecuri integer

meta.zile_interval integer Câte zile calendaristice are intervalul cerut.

meta.ultimul_esec string Ultima zi cu eşec din TOATĂ seria, nu doar din fereastra cerută.

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

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

meta.nota_zero string Ce înseamnă un zero aici: valoare măsurată nulă, nu lipsă de date.

meta.nota_total string Ce cuprinde totalul şi ce rămâne în afara lui.

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

meta.piata_secundara string

meta.fara_date string data e null, iar aici stă motivul. Nu există date de decontare în bază. S-a cerut doar_esecuri dar fereastra n-are niciunul; răspunsul spune când a fost ultimul. Intervalul e în întregime în afara acoperirii. Se suprapune peste ea, dar n-are nicio valoare în el.

meta.fara_date_cod string 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/titluri-stat/decontare?de_la=2024-06-15&pana_la=2024-06-30

{
    "data": {
        "de_la": "2024-06-15",
        "pana_la": "2024-06-30",
        "doar_esecuri": false,
        "zile": [
            {
                "data": "2024-06-17",
                "are_esecuri": false,
                "total_echivalent_eur": {
                    "decontate": "411523888.81",
                    "lipsa_instrumente": "0.00",
                    "lipsa_fonduri": "0.00"
                },
                "pe_moneda": {
                    "lei": {
                        "decontate": {
                            "numar": 163,
                            "valoare": "2048195546.99"
                        },
                        "lipsa_instrumente": {
                            "numar": 0,
                            "valoare": "0.00"
                        },
                        "lipsa_fonduri": {
                            "numar": 0,
                            "valoare": "0.00"
                        },
                        "unitate": "RON"
                    },
                    "euro": {
                        "decontate": {
                            "numar": 0,
                            "valoare": "0.00"
                        },
                        "lipsa_instrumente": {
                            "numar": 0,
                            "valoare": "0.00"
                        },
                        "lipsa_fonduri": {
                            "numar": 0,
                            "valoare": "0.00"
                        },
                        "unitate": "EUR"
                    }
                }
            }
        ],
        "rezumat": {
            "zile": 9,
            "zile_cu_esecuri": 0,
            "total_echivalent_eur": {
                "decontate": "5174248433.46",
                "lipsa_instrumente": "0.00",
                "lipsa_fonduri": "0.00"
            }
        }
    },
    "meta": {
        "sursa": "BNR — decontarea titlurilor de stat prin SaFIR, serii zilnice.",
        "acoperire": {
            "de_la": "2012-10-15",
            "pana_la": "2026-09-21"
        },
        "zile_publicate": 9,
        "zile_intoarse": 9,
        "zile_cu_esecuri": 0,
        "zile_interval": 16,
        "ultimul_esec": "2022-03-14",
        "nota_esecuri": "Eşecurile sunt rare: 64 de zile din 3.492 din lipsă de instrumente, 20 din lipsă de fonduri. Ultimul din toată seria a fost în martie 2022. `doar_esecuri=1` întoarce numai zilele cu incidente.",
        "nota_necomparabil": "NU se compară cu /financiar/v1/titluri-stat/piata-secundara. Valorile în lei coincid, la precizia de o zecimală a pieţei secundare, în doar 47,0% din zilele comune (numărul de operaţiuni în 46,0%), iar seria de aici e peste cealaltă în 6,0% dintre ele — o relaţie de submulţime nu ar permite asta. Ce le desparte nu se poate stabili din date, deci nu oferim o comparaţie.",
        "nota_zero": "Zero înseamnă zero: în 98% din zile decontarea merge fără eşec, iar acela e un zero real, nu o valoare neraportată.",
        "nota_total": "`total_echivalent_eur` e suma celor două monede la cursul zilei. Verificat faţă de `RON / curs + EUR`: raport între 0,9992 şi 1,0010.",
        "nota_rezumat": "`rezumat` se calculează pe toate zilele din fereastră, nu pe cele întoarse — altfel, cu `doar_esecuri`, ar spune că 100% din zile au avut eşecuri.",
        "piata_secundara": "/financiar/v1/titluri-stat/piata-secundara"
    }
}

GEThttps://oneapi.ro/api/financiar/v1/titluri-stat/decontare?de_la=2024-01-02&pana_la=2024-06-28

{
    "data": {
        "de_la": "2024-01-02",
        "pana_la": "2024-06-28",
        "doar_esecuri": false,
        "zile": [
            {
                "data": "2024-01-03",
                "are_esecuri": false,
                "total_echivalent_eur": {
                    "decontate": "325145918.37",
                    "lipsa_instrumente": "0.00",
                    "lipsa_fonduri": "0.00"
                },
                "pe_moneda": {
                    "lei": {
                        "decontate": {
                            "numar": 81,
                            "valoare": "1615856476.98"
                        },
                        "lipsa_instrumente": {
                            "numar": 0,
                            "valoare": "0.00"
                        },
                        "lipsa_fonduri": {
                            "numar": 0,
                            "valoare": "0.00"
                        },
                        "unitate": "RON"
                    },
                    "euro": {
                        "decontate": {
                            "numar": 2,
                            "valoare": "324530.32"
                        },
                        "lipsa_instrumente": {
                            "numar": 0,
                            "valoare": "0.00"
                        },
                        "lipsa_fonduri": {
                            "numar": 0,
                            "valoare": "0.00"
                        },
                        "unitate": "EUR"
                    }
                }
            }
        ],
        "rezumat": {
            "zile": 123,
            "zile_cu_esecuri": 0,
            "total_echivalent_eur": {
                "decontate": "55491093841.64",
                "lipsa_instrumente": "0.00",
                "lipsa_fonduri": "0.00"
            }
        }
    },
    "meta": {
        "sursa": "BNR — decontarea titlurilor de stat prin SaFIR, serii zilnice.",
        "acoperire": {
            "de_la": "2012-10-15",
            "pana_la": "2026-09-21"
        },
        "zile_publicate": 123,
        "zile_intoarse": 123,
        "zile_cu_esecuri": 0,
        "zile_interval": 179,
        "ultimul_esec": "2022-03-14",
        "nota_esecuri": "Eşecurile sunt rare: 64 de zile din 3.492 din lipsă de instrumente, 20 din lipsă de fonduri. Ultimul din toată seria a fost în martie 2022. `doar_esecuri=1` întoarce numai zilele cu incidente.",
        "nota_necomparabil": "NU se compară cu /financiar/v1/titluri-stat/piata-secundara. Valorile în lei coincid, la precizia de o zecimală a pieţei secundare, în doar 47,0% din zilele comune (numărul de operaţiuni în 46,0%), iar seria de aici e peste cealaltă în 6,0% dintre ele — o relaţie de submulţime nu ar permite asta. Ce le desparte nu se poate stabili din date, deci nu oferim o comparaţie.",
        "nota_zero": "Zero înseamnă zero: în 98% din zile decontarea merge fără eşec, iar acela e un zero real, nu o valoare neraportată.",
        "nota_total": "`total_echivalent_eur` e suma celor două monede la cursul zilei. Verificat faţă de `RON / curs + EUR`: raport între 0,9992 şi 1,0010.",
        "nota_rezumat": "`rezumat` se calculează pe toate zilele din fereastră, nu pe cele întoarse — altfel, cu `doar_esecuri`, ar spune că 100% din zile au avut eşecuri.",
        "piata_secundara": "/financiar/v1/titluri-stat/piata-secundara"
    }
}

GEThttps://oneapi.ro/api/financiar/v1/titluri-stat/decontare?de_la=2024-06-15&pana_la=2024-06-15

{
    "data": null,
    "meta": {
        "de_la": "2024-06-15",
        "pana_la": "2024-06-15",
        "acoperire": {
            "de_la": "2012-10-15",
            "pana_la": "2026-09-21"
        },
        "fara_date": "Intervalul se suprapune peste acoperire (2012-10-15 → 2026-09-21), dar nu are nicio valoare în el.",
        "fara_date_cod": "interval_gol"
    }
}

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, dată malformată, sau `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, dată malformată, sau pana_la înainte de de_la.",
        "detalii": {
            "de_la": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}