Cursul BNR#
GET/api/v1/curs-bnr
Filtrează după monedă și dată/perioadă. Până la 250 de rânduri pe pagină, 1 credit pe rând întors.
Parametri
monedastring· query- Moneda sau monedele, separate prin virgulă (EUR,USD). ex.: EUR
datastring· query- O zi anume (AAAA-LL-ZZ).
data_dedate (AAAA-LL-ZZ)· query- De la această dată (data ≥), format AAAA-LL-ZZ. ex.: 2026-01-01
data_panadate (AAAA-LL-ZZ)· query- Până la această dată (data ≤), format AAAA-LL-ZZ. ex.: 2026-12-31
paginainteger· query- Numărul paginii, de la 1. ex.: 1
per_paginainteger· query- Rezultate pe pagină, maxim 250. ex.: 20
ordinestring· query- Ordinea rezultatelor (vezi valorile permise pe endpoint).
recentevechiex.: recente
Câmpurile răspunsului
successboolean- true când cererea a reușit.
sursastring- Sursa datelor.
pagina · per_paginainteger- Pagina curentă și rezultatele pe pagină.
total · total_paginiinteger- Totalul rezultatelor care se potrivesc filtrelor și numărul de pagini pe care le poți parcurge.
rezultatearray- Rezultatele paginii.
rezultate[].monedastring- Codul monedei.
rezultate[].datadate- Ziua.
rezultate[].cursnumber- Cursul pentru O unitate de monedă (lei).
rezultate[].curs_brutnumber- Cursul publicat, pentru multiplicator unități.
rezultate[].multiplicatorinteger- Multiplicatorul (1 sau 100).
cost.credite_consumate · mod · tipinteger · string- Creditele consumate de cerere, modul de taxare (fix sau per_rezultat) și tipul creditelor (general sau premium).
Reguli pentru integrare
- 1Maximum 250 rezultate pe pagină. Paginile acoperă toate rezultatele care se potrivesc filtrelor; dacă o căutare e prea largă pentru a fi paginată până la capăt, răspunsul spune până unde poți merge.
- 2Costul se calculează pe numărul de rezultate întoarse; o căutare fără rezultate nu costă nimic.
curl -X GET "https://www.firmeapi.ro/api/v1/curs-bnr?moneda=EUR&data_de=2026-09-01" \ -H "X-API-KEY: CHEIA_TA_API" \ -H "Accept: application/json"
200 OK · se taxează 1 credit / rezultat
{
"success": true,
"sursa": "Banca Națională a României",
"pagina": 1,
"per_pagina": 2,
"total": 17,
"total_pagini": 9,
"rezultate": [
{
"moneda": "EUR",
"data": "2026-09-23",
"curs": 5.2788,
"curs_brut": 5.2788,
"multiplicator": 1
},
{
"moneda": "EUR",
"data": "2026-09-22",
"curs": 5.2647,
"curs_brut": 5.2647,
"multiplicator": 1
}
],
"cost": {
"credite_consumate": 2,
"mod": "per_rezultat",
"tip": "general"
}
}