cupiu-bnr

Official BNR (National Bank of Romania) exchange rates in Python — zero dependencies.

Pulls the daily curs valutar BNR reference rates straight from the National Bank's public feed. Pure standard library, works on Python 3.8+, installs in one line. Built and maintained by the team behind cupiu.ro — where you can see the same rates with live charts and the full 2005→today history for humans.

👉 Live rates, charts & history: cupiu.ro

Install

npm install cupiu-bnr

Library

const bnr = require('cupiu-bnr');

const rates = await bnr.latest();        // today's official reference rates
console.log(rates.get('EUR').ronPerUnit); // 5.2411

// Convert between any two BNR-listed currencies (crossed via RON)
await bnr.convert(100, 'EUR', 'USD');

// History straight from the BNR archive
for (const day of await bnr.year(2024)) {
  console.log(day.date, day.get('EUR').ronPerUnit);
}

Rate values are kept as exact strings (rate.value) and normalise BNR's multiplier convention automatically, so HUF, JPY, etc. are always per-single-unit via ronPerUnit.

Command line

npx cupiu-bnr                     # all of today's rates
npx cupiu-bnr EUR                 # 1 EUR = 5.2411 RON  (2026-07-15)
npx cupiu-bnr convert 100 eur ron # 100 EUR = 524.11 RON

Why

BNR publishes one official reference set per banking day (~13:00 Bucharest). Every accounting workflow in Romania — PFA invoices (Art. 290 Cod fiscal), importers, bookkeeping — needs that exact number. cupiu-bnr gives you it programmatically; cupiu.ro gives you it in the browser with charts, per-currency pages and the historical archive.

Data & attribution

Source data © National Bank of Romania, used under their public data terms. This is an independent open-source client, not affiliated with the BNR. Maintained by cupiu.ro.

License

MIT — see LICENSE.