API pentru preluarea cursului BNR

CursBnr.ro pune la dispoziție un API pentru preluarea cursului valutar BNR. API-ul oferă cursurile oficiale comunicate de BNR în format JSON sau ca text simplu, atât pentru ziua curentă, cât și pentru orice dată din arhivă.

Răspunsul este un obiect JSON care conține data și valorile cotațiilor valutare solicitate. Fără parametri, API-ul returnează cel mai recent curs BNR pentru euro. Data și valuta (sau mai multe valute) pot fi transmise ca parametri GET (date, currency) în cererea către API.

Raspunsul are aceeași structură indiferent daca cereți o singura valută sau mai multe. Există o limită de 30 de cereri pe minut.

Cum se poate apela API-ul curs bnr

1. Spre exemplu, cel mai recent curs pentru euro poate fi obtinut prin apelul

GET https://www.cursbnr.ro/api/v1/rates

Răspunsul primit va fi

{
    "date": "2026-10-28",
    "quote": "RON",
    "rates": {
        "EUR": 5.3495
    }
}

2. Mai multe valute prin folosirea parametrului currency=EUR,USD,100HUF

GET https://www.cursbnr.ro/api/v1/rates?currency=EUR,USD,100HUF

va genera următorul obiect JSON

{
    "date": "2026-10-28",
    "quote": "RON",
    "rates": {
        "EUR": 5.3495,
        "USD": 4.8088,
        "100HUF": 1.4569
    }
}

3. Cursul dintr-o anumită zi din arhivă, cu data în format YYYY-MM-DD

GET https://www.cursbnr.ro/api/v1/rates/2026-10-27?currency=GBP

sau

GET https://www.cursbnr.ro/api/v1/rates?date=2026-10-27&currency=GBP

va returna

{
    "date": "2026-10-27",
    "quote": "RON",
    "rates": {
        "GBP": 6.3892
    }
}

4. Doar valoarea, ca text simplu (de ex. pt. inserare într-un spreadsheet), folosind format=text

GET https://www.cursbnr.ro/api/v1/rates?currency=USD&format=text

si va oferi drept raspuns doar

4.8088

Spre exemplu în Google Spreadsheets, daca aveti nevoie sa inserati cursul USD intr-o celula, veti scrie: =IMPORTDATA("https://www.cursbnr.ro/api/v1/rates?currency=USD&format=text")

Toate detaliile necesare implementarii API le gasiți în documentația de mai jos.

Documentație curs bnr API in limba română

API Documentation for NBR (BNR) Exchange Rates (EN)

Dacă aveți nevoie de ajutor sau doriți mai multe detalii vă rugăm să ne contactați prin formularul de contact.