Documentație API Public

Acces programatic la datele cursului valutar BNR.

Informații Generale

Acest API public oferă o metodă simplă de a prelua cele mai recente cursuri de schimb valutar sau cursuri istorice pentru o anumită dată.

URL de bază: https://cursbnr.servicii-informatice.ro/api_public.php

Limită de Acces (Rate Limiting)

Pentru a asigura o disponibilitate ridicată pentru toți utilizatorii, API-ul este limitat la 1 cerere pe secundă per adresă IP.

Dacă depășiți această limită, veți primi un răspuns HTTP cu status 429 Too Many Requests și un mesaj de eroare în format JSON.

{
    "error": "Limită de cereri atinsă. Vă rugăm să așteptați o secundă."
}
Parametri
Parametru Tip Obligatoriu Descriere
action string Nu Acțiune specifică. Folosiți valoarea get_symbols pentru a obține lista tuturor simbolurilor disponibile.
simbol string Nu Codul valutei de 3 litere (ex: EUR, USD, XAU). Dacă lipsește, se vor returna toate cursurile pentru data specificată.
data string Nu Data pentru care se dorește cursul, în format YYYY-MM-DD. Dacă lipsește, se va folosi cea mai recentă dată disponibilă.
Exemple de Utilizare
1. Preluare ultimul curs pentru EUR

Cerere:

https://cursbnr.servicii-informatice.ro/api_public.php?simbol=EUR

Răspuns posibil:

{
    "simbol": "EUR",
    "valoare": "4.9773",
    "data": "2024-05-21"
}
2. Preluare curs pentru USD la o dată specifică

Cerere pentru un singur simbol:

https://cursbnr.servicii-informatice.ro/api_public.php?simbol=USD&data=2024-01-15

Răspuns posibil (API-ul va returna cursul din 2024-01-15, deoarece a fost o zi lucrătoare):

{
    "simbol": "USD",
    "valoare": "4.5529",
    "data": "2024-01-15"
}
3. Preluare toate cursurile pentru cea mai recentă dată

Cerere (fără parametrul simbol):

https://cursbnr.servicii-informatice.ro/api_public.php

Răspuns posibil:

{
    "data": "2024-05-21",
    "rates": {
        "EUR": {
            "valoare": "4.9773",
            "multiplicator": 1
        },
        "USD": {
            "valoare": "4.5883",
            "multiplicator": 1
        },
        "XAU": {
            "valoare": "356.5368",
            "multiplicator": 1
        }
        // ... și celelalte valute
    }
}
4. Preluare toate cursurile pentru o dată specifică

Cerere (doar cu data):

https://cursbnr.servicii-informatice.ro/api_public.php?data=2024-01-15
5. Preluare lista tuturor simbolurilor disponibile

Cerere:

https://cursbnr.servicii-informatice.ro/api_public.php?action=get_symbols

Răspuns posibil:

{
    "symbols": [
        "AED",
        "AUD",
        "BGN",
        "BRL",
        "CAD",
        "CHF",
        "CNY",
        "CZK",
        "DKK",
        "EGP",
        "EUR",
        // ... și celelalte simboluri
    ]
}
6. Răspuns de eroare (simbol invalid)

Cerere:

https://cursbnr.servicii-informatice.ro/api_public.php?simbol=XYZ

Răspuns (cu status HTTP 404 Not Found):

{
    "error": "Nu s-au găsit date pentru simbolul sau data specificată."
}