cursdevaluta.ro

Vreau să schimb

În sucursală sau casă de schimb valutar, cursul poate include alte marje decât în aplicația mobilă sau în internet banking.

în

API date curs valutar

Trei endpoint-uri publice, gratuite, fără autentificare: cursul de referință BNR, cursurile live la 14 bănci comerciale și istoricul BNR (JSON sau CSV). CORS deschis (`Access-Control-Allow-Origin: *`), orice site, aplicație sau agent AI le poate consuma direct.

Notă: valorile provin din surse publice și pot diferi de ratele finale afișate în aplicația fiecărei bănci.

GET /api/rates, cursul de referință BNR

Cursul oficial BNR pentru EUR, USD, GBP, CHF, HUF, JPY, NOK, PLN, SEK, CAD, parsat din XML-ul BNR și cache-uit 10 minute.

curl https://cursdevaluta.ro/api/rates
{
  "date": "20 august 2026",
  "rates": { "EUR": 5.2535, "USD": 4.4884, "...": "..." },
  "source": "BNR",
  "fetchedAt": "2026-08-05T12:00:00.000Z"
}

GET /api/bank-rates, cursuri live la 14 bănci

Cursuri buy/sell per bancă și canal (online, fizic, card), plus un câmp coverage, numărul de bănci distincte cu date reale per valută, ca să poți detecta degradări. Cache 30 minute.

curl https://cursdevaluta.ro/api/bank-rates
{
  "date": "20 august 2026",
  "currencies": { "EUR": [{ "bank": "BCR", "slug": "bcr", "buy": 5.19, "sell": 5.29, "channel": "physical" }, "..."] },
  "coverage": { "EUR": 13, "...": "..." },
  "source": "cursvalutar.ro + Libra Bank",
  "fetchedAt": "2026-08-05T12:00:00.000Z"
}

GET /api/history, istoric BNR (JSON sau CSV)

Ultimele N zile (implicit 30, max 90) din arhivele anuale XML BNR, pentru o singură valută. Parametri: currency (implicit EUR), days (1–90), format (json implicit, sau csv pentru export descărcabil). Cache 6 ore.

curl "https://cursdevaluta.ro/api/history?currency=EUR&days=30"
curl "https://cursdevaluta.ro/api/history?currency=EUR&days=30&format=csv"
date,rate
2026-07-06,5.2535
2026-07-07,5.2535
...

CORS și limite de utilizare

Toate cele trei endpoint-uri sunt publice, fără autentificare, cu Access-Control-Allow-Origin: *, le poți apela direct din browser (fetch/XHR), dintr-un server, sau dintr-un agent AI. Nu există un rate-limit explicit dedicat, dar te rugăm să respecți timpii de cache de mai sus (10 min / 30 min / 6h) în loc să faci polling mai des, datele oricum nu se schimbă mai rapid decât atât. Planul gratuit e gândit pentru uz personal, widget-uri (vezi mai jos) și proiecte cu volum redus, cerem doar un link vizibil către cursdevaluta.ro acolo unde afișezi datele.

Plan Business, pentru uz comercial

Dacă integrezi datele într-un produs comercial (aplicație, ERP, contabilitate, alt site) și ai nevoie de mai mult decât planul gratuit, oferim un plan Business: fără cerința de atribuire, SLA, istoric complet (nu doar 90 de zile), acces bulk și suport direct. Datele noastre, curs BNR + 14 bănci românești numite + case de schimb pe oraș, nu au echivalent la furnizorii globali de cursuri valutare. Preț: de la 500 lei/lună per integrare, scrie-ne pentru detalii și volum.

Convertorul ca unealtă agent-invocabilă (WebMCP)

Convertorul valutar de pe fiecare pagină și formularul de contact expun atribute declarative tool-name / tool-description (WebMCP), agenții AI care navighează pagina pot identifica și folosi aceste unelte direct din DOM, fără un API separat. Vezi convert-currency pe orice pagină cu convertor și send-contact-message pe pagina de contact.

Pagini conexe

Întrebări frecvente

API-ul cursdevaluta.ro necesită autentificare sau cheie API?

Nu. Toate cele trei endpoint-uri (/api/rates, /api/bank-rates, /api/history) sunt publice și gratuite, fără cheie API sau autentificare.

Pot folosi API-ul cursdevaluta.ro dintr-un alt site sau aplicație?

Da. Toate răspunsurile au CORS deschis (Access-Control-Allow-Origin: *), deci poți apela endpoint-urile direct din JavaScript în browser, dintr-un server sau dintr-un agent AI.

Cât de des se actualizează datele din API?

/api/rates (cursul BNR) e cache-uit 10 minute, /api/bank-rates 30 de minute, iar /api/history 6 ore, reflectă cadența reală de publicare a surselor (BNR publică o dată pe zi, băncile își actualizează cursurile de mai multe ori pe zi).

Pot descărca istoricul cursului valutar ca fișier CSV?

Da. Adaugă &format=csv la /api/history, de exemplu /api/history?currency=EUR&days=30&format=csv, pentru un export CSV direct descărcabil.

Cât costă un plan Business pentru uz comercial?

De la 500 lei/lună per integrare, fără cerința de atribuire, cu SLA, istoric complet și suport direct. Scrie-ne prin pagina de contact pentru un preț exact în funcție de volum.