API Curs valutar BNR

Cursul de schimb oficial al Băncii Naționale a României, ca API: fixing-ul zilei, cursul la orice dată, istoric multianual și conversii între valute — totul normalizat la 1 unitate, în JSON, gratuit.

  • Gratuit
  • Funcționează fără cheie API
  • Actualizat zilnic (~13:00)
  • Sursă: BNR
Obține o cheie API gratuită Documentație API
Terminal — încearcă fără cheie API

$ curl "https://api.datero.ro/v1/fx-rates?currency=EUR,USD,CHF" 

{
  "date": "2026-06-11",
  "target": "RON",
  "source": "BNR",
  "items": [
    { "currency": "CHF", "rate": 5.6794 },
    { "currency": "EUR", "rate": 5.239  },
    { "currency": "USD", "rate": 4.5422 }
  ]
}

Endpoint-uri

GET /v1/fx-rates

Cursul unei zile (toate valutele sau o selecție)

Fără parametri returnează ultimul fixing publicat, cu toate valutele cotate de BNR. Pentru zile nebancare (weekend, sărbători) răspunde cu fixing-ul anterior, iar câmpul date indică ziua efectivă.

Parametri pentru /v1/fx-rates
Parametru Tip Descriere
date string (YYYY-MM-DD) Ziua cerută. Implicit: ultimul fixing publicat.
currency string Filtru de valute ISO 4217, separate prin virgulă. Ex: currency=EUR,USD.
Exemplu — cURL 
curl "https://api.datero.ro/v1/fx-rates?date=2026-06-07&currency=EUR"
Răspuns — 7 iunie a fost duminică — răspunsul indică fixing-ul de vineri 
{
  "date": "2026-06-05",
  "requestedDate": "2026-06-07",
  "target": "RON",
  "source": "BNR",
  "items": [
    { "currency": "EUR", "rate": 5.2488 }
  ]
}
GET /v1/fx-rates/history

Istoricul unei valute

Serie zilnică (doar zile bancare) pentru o valută față de RON. Interval maxim 366 de zile per cerere; pentru istorii mai lungi, paginează pe ani.

Parametri pentru /v1/fx-rates/history
Parametru Tip Descriere
currency obligatoriu string Valuta ISO 4217. Ex: EUR.
from string (YYYY-MM-DD) Începutul intervalului. Implicit: to − 30 zile.
to string (YYYY-MM-DD) Sfârșitul intervalului. Implicit: azi.
Exemplu — cURL 
curl "https://api.datero.ro/v1/fx-rates/history?currency=EUR&from=2026-06-08&to=2026-06-11"
Răspuns 
{
  "currency": "EUR",
  "target": "RON",
  "source": "BNR",
  "from": "2026-06-08",
  "to": "2026-06-11",
  "items": [
    { "date": "2026-06-08", "rate": 5.2436 },
    { "date": "2026-06-09", "rate": 5.2386 },
    { "date": "2026-06-10", "rate": 5.2344 },
    { "date": "2026-06-11", "rate": 5.239  }
  ]
}
GET /v1/fx-rates/convert

Conversie între valute la cursul BNR

Convertește o sumă între orice două valute cotate de BNR (RON inclus), la fixing-ul zilei alese. Conversiile încrucișate (ex. EUR→USD) trec prin RON.

Parametri pentru /v1/fx-rates/convert
Parametru Tip Descriere
amount obligatoriu number Suma de convertit. Ex: 1000 sau 99.90.
from obligatoriu string Valuta sursă. Ex: EUR.
to obligatoriu string Valuta țintă. Ex: RON, USD.
date string (YYYY-MM-DD) Ziua fixing-ului. Implicit: ultimul publicat.
Exemplu — cURL 
curl "https://api.datero.ro/v1/fx-rates/convert?amount=1000&from=EUR&to=RON"
Răspuns 
{
  "amount": 1000,
  "from": "EUR",
  "to": "RON",
  "date": "2026-06-11",
  "rate": 5.239,
  "result": 5239,
  "source": "BNR"
}

Bine de știut

  • Gratuit, cu sau fără cheie. Endpoint-urile de curs valutar nu consumă credite. Fără autentificare se aplică o limită de rată per IP; cu o cheie API gratuită limita devine dedicată contului tău (nu partajată per IP) și primești acces și la datele de firme.
  • Mereu per 1 unitate. BNR cotează HUF, JPY și KRW la 100 de unități — API-ul normalizează totul, deci rate înseamnă întotdeauna RON per 1 unitate de valută.
  • Actualizare zilnică. Fixing-ul BNR e publicat în jurul orei 13:00 în zilele bancare și preluat automat în aceeași zi.
  • MCP pentru agenți AI. Aceleași operații sunt disponibile ca tool-uri MCP (get_fx_rates, get_fx_rate_history, convert_currency) la https://api.datero.ro/mcp.

Întrebări frecvente

De unde provine cursul valutar?

Din fixing-ul oficial al Băncii Naționale a României (BNR), publicat în fiecare zi bancară în jurul orei 13:00. API-ul îl preia automat în aceeași zi.

Ce se întâmplă în weekend și de sărbători?

BNR nu publică curs în zilele nebancare. API-ul returnează automat ultimul fixing disponibil, iar câmpul "date" din răspuns indică ziua efectivă a cotației (requestedDate păstrează ziua cerută).

Ratele sunt pentru 1 unitate de valută?

Da, întotdeauna. Inclusiv pentru valutele pe care BNR le cotează la 100 de unități (HUF, JPY, KRW) — API-ul le normalizează, deci rate înseamnă mereu "câți RON valorează 1 unitate".

Pot converti direct EUR în USD (fără RON)?

Da. GET /v1/fx-rates/convert acceptă orice pereche de valute cotate de BNR, inclusiv RON. Conversiile încrucișate trec prin RON: EUR→USD = (EUR→RON) / (USD→RON), la fixing-ul zilei alese.

Cât istoric este disponibil?

Istoric multianual, zi de zi (doar zile bancare). O singură cerere acoperă maximum 366 de zile — pentru perioade mai lungi, paginează pe ani.

API-ul de curs valutar este gratuit?

Da. Endpoint-urile de curs valutar sunt gratuite și funcționează și fără cheie API (cu limită de rată per IP). Cu o cheie API gratuită limita e dedicată contului tău, iar accesul la restul API-urilor Datero e inclus.

Alte API-uri Datero

API Date firme

2,7M companii: profil după CUI, căutare, bilanțuri ANAF.

API Coduri CAEN

Nomenclatorul CAEN Rev.3 complet: căutare, ierarhie, echivalențe Rev.2.

API Județe și localități

Toate județele și localitățile din România, cu coduri ANAF și SIRUTA.