oneapi
Autentificare
Financiar v1 / TitluriStat

Licitaţii de titluri de stat

Rezultatele licitaţiilor de emisiune: cât s-a anunţat, cât s-a cerut, cât s-a adjudecat şi la ce
randament, preţ sau discont. 1.834 de licitaţii din aprilie 2005 încoace, cu cele 34 de câmpuri ale
BNR traduse în structuri cu nume.

Codurile sursei se citesc pe două axe, iar de acolo vine forma răspunsului: cerere e ce s-a cerut,
adjudecat e ce s-a acceptat, fiecare cu valoarea nominală şi costul net, desfăcute pe oferte
competitive (cont propriu / contul clienţilor) şi necompetitive.

Moneda NU e publicată în această serie. Spre deosebire de seria de preschimbări, emisiunile
n-au câmp de denominare. Iar seria conţine aproape sigur şi emisiuni în euro: 118 licitaţii (6,4%)
au randamentul mult sub mediana lunii lor — 21 august 2026 dă 3,23% şi 3,97% în aceeaşi săptămână în
care restul se adjudecă la 6,7%. Aproape sigur nu e o cifră care se pune într-un câmp, deci ruta nu
inventează moneda şi nu însumează nimic peste licitaţii. Cine adună, adună ştiind.

Primele nouă licitaţii sunt în lei vechi (11 aprilie – 20 iunie 2005): 500.000.000.000 faţă de
150.000.000 după 1 iulie, iar valoarea nominală individuală trece de la 100.000.000 la 10.000 — exact
raportul 10.000. Valorile vin aşa cum sunt publicate, cu epoca şi factor_denominare alături.

O licitaţie poate eşua: 159 din 1.834 (8,7%) n-au adjudecat nimic. Sunt marcate nereusita, ca
să nu intre într-o medie de randament ca şi cum ar fi avut una. Şi 72,7% sunt redeschideri —
maturitatea reziduală e mai scurtă decât cea originală, marcate reluare.

suprasubscriere şi raport_prospect sunt calculate de noi, nu publicate. Prima are o capcană
declarată: BNR publică cererea totală în două câmpuri care se exclud — valoare nominală la 1.458 de
licitaţii, cost net la celelalte 376 — deci suprasubscriere_baza spune pe care s-a calculat.
Medianele diferă real: 1,66 pe bază nominală, 2,04 pe cost net. raport_prospect (adjudecat /
anunţat) are mediana 1,02, cu 925 de licitaţii peste anunţ şi 309 sub.

În 2006 nu există nicio licitaţie în serie: 13 în 2005, apoi nimic până în 2007.

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

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 cu licitaţie. Maximum 366 de zile. ex. 2024-06-30ex. 2024-03-29ex. 2024-06-15

Cum se comportă

  • Rezultatele licitaţiilor de emisiune: cât s-a anunţat, cât s-a cerut, cât s-a adjudecat şi la ce randament, preţ sau discont. 1.834 de licitaţii din aprilie 2005 încoace, cu cele 34 de câmpuri ale BNR traduse în structuri cu nume.
  • Codurile sursei se citesc pe două axe, iar de acolo vine forma răspunsului: cerere e ce s-a cerut, adjudecat e ce s-a acceptat, fiecare cu valoarea nominală şi costul net, desfăcute pe oferte competitive (cont propriu / contul clienţilor) şi necompetitive. cost_net / nominal dă preţul mediu al categoriei — verificat: 871.953.200 / 840.000.000 = 1,0380, faţă de preţul mediu publicat 103,83.
  • Moneda NU e publicată în această serie. Spre deosebire de cea de preschimbări, emisiunile n-au câmp de denominare. Iar seria conţine aproape sigur şi emisiuni în euro: 118 licitaţii (6,4%) au randamentul mult sub mediana lunii lor — 21 august 2026 dă 3,23% şi 3,97% în aceeaşi săptămână în care restul se adjudecă la 6,7%. Aproape sigur nu e o cifră care se pune într-un câmp, deci ruta nu inventează moneda şi nu însumează nimic peste licitaţii: un total ar amesteca monede. Cine adună, adună ştiind.
  • Primele nouă licitaţii sunt în lei vechi (11 aprilie – 20 iunie 2005): 500.000.000.000 faţă de 150.000.000 după 1 iulie, iar valoarea nominală individuală trece de la 100.000.000 la 10.000 — exact raportul 10.000. Valorile vin aşa cum sunt publicate: convertite tăcut, n-ar mai corespunde cu pagina BNR. epoca şi factor_denominare spun cu ce se înmulţeşte pentru a ajunge în lei de azi.
  • O licitaţie poate eşua: 159 din 1.834 (8,7%) n-au adjudecat nimic. Sunt marcate nereusita şi n-au randament — o medie care le include ca zerouri e greşită.
  • 72,7% sunt redeschideri: se emite în plus dintr-o serie care există deja, deci maturitatea reziduală e mai scurtă decât cea originală. Câmpul reluare le marchează.
  • suprasubscriere are o capcană declarată: BNR publică cererea totală în două câmpuri care se exclud — valoare nominală la 1.458 de licitaţii, cost net la celelalte 376, niciodată amândouă. De aceea suprasubscriere_baza spune pe care s-a calculat, iar medianele diferă real: 1,66 pe bază nominală, 2,04 pe cost net.
  • raport_prospect (adjudecat / anunţat) are mediana 1,02, cu 925 de licitaţii peste anunţ şi 309 sub: Trezoreria ia frecvent mai mult decât a anunţat, şi asta se vede.
  • În 2006 nu există nicio licitaţie: 13 în 2005, apoi nimic până în 2007. Un interval din 2006 primeşte 404 fara_licitatii, nu in_afara_acoperirii — anul e în mijlocul seriei.

La ce folosește

  • Costul real la care se împrumută statul, licitaţie cu licitaţie.
  • Apetitul pieţei pentru datoria suverană, urmărit prin suprasubscriere.
  • Calendarul emisiunilor şi cât s-a abătut adjudecarea de la ce s-a anunţat în prospect.

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.licitatii[].data string Ziua licitaţiei.
data.licitatii[].linie integer A câta licitaţie din ziua respectivă — sunt zile cu două. Cheia e perechea dată + linie.
data.licitatii[].instrument string obligatiuni (cu cupon), certificate_discont, sau nedeterminat pentru cele 51 fără niciun câmp de preţ care să le distingă.
data.licitatii[].epoca string ROL sau RON — în ce monedă sunt scrise valorile.
data.licitatii[].factor_denominare integer 10000 în epoca leului vechi, 1 după. Cu cât se înmulţesc valorile pentru a ajunge în lei de azi.
data.licitatii[].maturitate.zile integer Maturitatea originală a seriei, în zile.
data.licitatii[].maturitate.ani string Aceeaşi, în ani (împărţită la 365,25) — pentru citit, nu pentru calcule exacte.
data.licitatii[].maturitate.reziduala_zile integer Cât mai are de trăit seria de la decontare. Mai mică decât cea originală la redeschideri.
data.licitatii[].maturitate.reluare boolean true la redeschidere.
data.licitatii[].decontare_zile integer Decalajul dintre licitaţie şi decontare.
data.licitatii[].cupon string Rata cuponului, în procente pe an. null la certificatele cu discont.
data.licitatii[].dobanda_acumulata_titlu string
data.licitatii[].oferta.anuntat string Valoarea din prospect.
data.licitatii[].oferta.subscris string Valoarea nominală cerută. null la cele 376 de licitaţii pentru care BNR a publicat doar costul net al cererii — acela e în cerere.total.cost_net.
data.licitatii[].oferta.adjudecat string Valoarea nominală acceptată.
data.licitatii[].oferta.nereusita boolean true când nu s-a adjudecat nimic.
data.licitatii[].oferta.suprasubscriere string De câte ori a fost cererea mai mare decât adjudecarea. Calculat de noi.
data.licitatii[].oferta.suprasubscriere_baza string nominal sau cost_net — pe ce bază s-a putut calcula raportul.
data.licitatii[].oferta.raport_prospect string Adjudecat / anunţat. Peste 1 înseamnă că s-a luat mai mult decât s-a anunţat.
data.licitatii[].oferta.valoare_nominala_titlu string
data.licitatii[].oferta.oferta_minima string
data.licitatii[].cerere object Ce s-a cerut: nominal şi cost_net, pe total, competitive (cont propriu / contul clienţilor) şi necompetitive.
data.licitatii[].cerere.total.nominal string Valoarea în preţuri curente, nedeflatată.
data.licitatii[].cerere.total.cost_net null Costul net, după scăderea a ce se compensează.
data.licitatii[].cerere.competitive.nominal string Valoarea în preţuri curente, nedeflatată.
data.licitatii[].cerere.competitive.cost_net string Costul net, după scăderea a ce se compensează.
data.licitatii[].cerere.competitive_cont_propriu.nominal string Valoarea în preţuri curente, nedeflatată.
data.licitatii[].cerere.competitive_cont_propriu.cost_net string Costul net, după scăderea a ce se compensează.
data.licitatii[].cerere.competitive_cont_clienti.nominal string Valoarea în preţuri curente, nedeflatată.
data.licitatii[].cerere.competitive_cont_clienti.cost_net string Costul net, după scăderea a ce se compensează.
data.licitatii[].cerere.necompetitive.nominal string Valoarea în preţuri curente, nedeflatată.
data.licitatii[].cerere.necompetitive.cost_net null Costul net, după scăderea a ce se compensează.
data.licitatii[].adjudecat object Ce s-a acceptat, cu aceeaşi desfacere.
data.licitatii[].adjudecat.total.nominal string Valoarea în preţuri curente, nedeflatată.
data.licitatii[].adjudecat.total.cost_net string Costul net, după scăderea a ce se compensează.
data.licitatii[].adjudecat.competitive.nominal string Valoarea în preţuri curente, nedeflatată.
data.licitatii[].adjudecat.competitive.cost_net string Costul net, după scăderea a ce se compensează.
data.licitatii[].adjudecat.competitive_cont_propriu.nominal string Valoarea în preţuri curente, nedeflatată.
data.licitatii[].adjudecat.competitive_cont_propriu.cost_net string Costul net, după scăderea a ce se compensează.
data.licitatii[].adjudecat.competitive_cont_clienti.nominal string Valoarea în preţuri curente, nedeflatată.
data.licitatii[].adjudecat.competitive_cont_clienti.cost_net string Costul net, după scăderea a ce se compensează.
data.licitatii[].adjudecat.necompetitive.nominal string Valoarea în preţuri curente, nedeflatată.
data.licitatii[].adjudecat.necompetitive.cost_net string Costul net, după scăderea a ce se compensează.
data.licitatii[].randament object Randamentul mediu şi cel maxim acceptat, procente pe an.
data.licitatii[].randament.mediu string Mediul de rezidenţă (urban ori rural).
data.licitatii[].randament.maxim string Cea mai mare valoare din interval.
data.licitatii[].pret object Preţul mediu şi cel maxim acceptat, ca procent din valoarea nominală.
data.licitatii[].pret.mediu string Mediul de rezidenţă (urban ori rural).
data.licitatii[].pret.maxim string Cea mai mare valoare din interval.
data.licitatii[].discont object Rata medie şi maximă a discontului. Doar la certificate.
data.licitatii[].discont.mediu null Mediul de rezidenţă (urban ori rural).
data.licitatii[].discont.maxim null Cea mai mare valoare din interval.
data.licitatii[].coeficient_marginal object Cât s-a alocat din ofertele aflate la nivelul marginal, separat pentru competitive şi necompetitive.
data.licitatii[].coeficient_marginal.competitive string
data.licitatii[].coeficient_marginal.necompetitive 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.acoperire.licitatii integer
meta.licitatii integer
meta.nereusite integer
meta.zile_interval integer Câte zile calendaristice are intervalul cerut.
meta.nota_moneda string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_denominare string Denominarea din 2005 (1 leu nou = 10.000 lei vechi) şi ce înseamnă pentru comparaţii.
meta.nota_structura string Cum se citeşte structura din răspuns şi ce niveluri nu se adună.
meta.nota_calculate string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_subscris string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_nereusite string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.nota_2006 string Precizare despre cum se citeşte răspunsul: o capcană, o convenţie sau o limită a sursei.
meta.fara_date string data e null, iar aici stă motivul. Intervalul e în întregime în afara seriei. Intervalul e în acoperire, dar nu s-a ţinut nicio licitaţie în el (cazul lui 2006).
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/emisiuni?de_la=2024-06-15&pana_la=2024-06-30
{
    "data": {
        "de_la": "2024-06-15",
        "pana_la": "2024-06-30",
        "licitatii": [
            {
                "data": "2024-06-17",
                "linie": 1,
                "instrument": "obligatiuni",
                "epoca": "RON",
                "factor_denominare": 1,
                "maturitate": {
                    "zile": 3934,
                    "ani": "10.77",
                    "reziduala_zile": 3696,
                    "reluare": true
                },
                "decontare_zile": 4,
                "cupon": "7.10",
                "dobanda_acumulata_titlu": "312.32",
                "oferta": {
                    "anuntat": "500000000.00",
                    "subscris": "1239870000.00",
                    "adjudecat": "1022500000.00",
                    "nereusita": false,
                    "suprasubscriere": "1.21",
                    "suprasubscriere_baza": "nominal",
                    "raport_prospect": "2.05",
                    "valoare_nominala_titlu": "5000.00",
                    "oferta_minima": "5000.00"
                },
                "cerere": {
                    "total": {
                        "nominal": "1239870000.00",
                        "cost_net": null
                    },
                    "competitive": {
                        "nominal": "1042500000.00",
                        "cost_net": "1059899000.00"
                    },
                    "competitive_cont_propriu": {
                        "nominal": "1042500000.00",
                        "cost_net": "1059899000.00"
                    },
                    "competitive_cont_clienti": {
                        "nominal": "0.00",
                        "cost_net": "0.00"
                    },
                    "necompetitive": {
                        "nominal": "197370000.00",
                        "cost_net": null
                    }
                },
                "adjudecat": {
                    "total": {
                        "nominal": "1022500000.00",
                        "cost_net": "1039720140.00"
                    },
                    "competitive": {
                        "nominal": "897500000.00",
                        "cost_net": "912614890.00"
                    },
                    "competitive_cont_propriu": {
                        "nominal": "897500000.00",
                        "cost_net": "912614890.00"
                    },
                    "competitive_cont_clienti": {
                        "nominal": "0.00",
                        "cost_net": "0.00"
                    },
                    "necompetitive": {
                        "nominal": "125000000.00",
                        "cost_net": "127105250.00"
                    }
                },
                "randament": {
                    "mediu": "6.86",
                    "maxim": "6.86"
                },
                "pret": {
                    "mediu": "101.68",
                    "maxim": "101.65"
                },
                "discont": {
                    "mediu": null,
                    "maxim": null
                },
                "coeficient_marginal": {
                    "competitive": "100.00",
                    "necompetitive": "63.33"
                }
            }
        ]
    },
    "meta": {
        "sursa": "BNR — licitaţii de titluri de stat (baza de date interactivă).",
        "acoperire": {
            "de_la": "2005-04-11",
            "pana_la": "2026-09-23",
            "licitatii": 1838
        },
        "licitatii": 5,
        "nereusite": 1,
        "zile_interval": 16,
        "nota_moneda": "Seria de emisiuni NU publică denominarea, iar 118 licitaţii din 1.834 (6,4%) au randamentul mult sub mediana lunii lor — aproape sigur emisiuni în euro. De aceea nu există câmp `moneda` şi nu se însumează nimic peste licitaţii: un total ar amesteca monede.",
        "nota_denominare": "Primele nouă licitaţii (11 aprilie – 20 iunie 2005) sunt în lei vechi. Valorile sunt cele publicate, netransformate; `epoca` şi `factor_denominare` spun cu ce se înmulţeşte pentru a ajunge în lei de azi.",
        "nota_structura": "`cerere` e ce s-a cerut, `adjudecat` e ce s-a acceptat — fiecare cu `nominal` şi `cost_net`, pe competitive (cont propriu / contul clienţilor) şi necompetitive. `cost_net / nominal` dă preţul mediu al categoriei.",
        "nota_calculate": "`suprasubscriere` şi `raport_prospect` sunt calculate de noi. BNR publică cererea totală în două câmpuri care se exclud — valoare nominală la 1.458 de licitaţii, cost net la 376 — deci `suprasubscriere_baza` spune pe care s-a calculat; medianele istorice diferă real: 1,66 nominal, 2,04 cost net. `raport_prospect` are mediana 1,02.",
        "nota_subscris": "`oferta.subscris` e valoarea nominală cerută. E `null` la cele 376 de licitaţii pentru care BNR a publicat doar costul net al cererii — acela stă în `cerere.total.cost_net`, nu s-a pierdut.",
        "nota_nereusite": "Licitaţia cu `nereusita: true` n-a adjudecat nimic — 8,7% din toate. Nu are randament, deci nu intră într-o medie.",
        "nota_2006": "În 2006 nu există nicio licitaţie în serie: 13 în 2005, apoi nimic până în 2007."
    }
}

Coduri de eroare

CodSlugCând apare
401neautentificatToken lipsă, invalid, expirat sau revocat.
403feature_indisponibilPlanul curent nu include funcţia de care ţine ruta.
422validareinterval_prea_lung peste 366 de zile, dată malformată, pana_la înainte de de_la, sau interval î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": "interval_prea_lung peste 366 de zile, dată malformată, pana_la înainte de de_la, sau interval în viitor.",
        "detalii": {
            "de_la": [
                "Valoarea trimisă nu respectă regula parametrului."
            ]
        }
    }
}