Developer

Limba: Română
Aspect

Tema

Culoarea de accent

Tema și culoarea te urmează pe satelit.md și în aplicație.

Intră

Unde schimbi tema?

Alege unde se aplică tema nouă.

Poți schimba oricând din antet.

Ghid · Node.js 18+

Widget curs valutar BNM

Un bloc HTML cu cursul oficial al Băncii Naționale a Moldovei, schimbarea pe 30 de zile și o linie mică pentru fiecare valută. Static: nicio cerere din browserul cititorului, nicio cheie în pagină.

Rulează pe
Node.js 18+
O rulare
4 credite
Pe lună
88 de credite
Pornit în
5 min
$ CODES=EUR,USD,RON DAYS=30 node rates_widget.mjsrates-widget.html: 3 currencies, 4 credits

Cum funcționează

  1. Ia cursurile zilei din /v1/rates și păstrează valutele din CODES.
  2. Pentru fiecare valută ia istoricul pe DAYS zile din /v1/rates/history.
  3. Desenează linia ca SVG în pagină, fără bibliotecă de grafice.
  4. Scrie rates-widget.html și rates.json, cu sursa BNM sub cifre, cum cere licența CC BY 4.0.

Cât costă: 1 credit pentru cursuri, 1 pentru fiecare istoric: 4 credite cu trei valute. O rulare în fiecare zi lucrătoare: 88 de credite pe lună. Încape în planul Start.

Cum îl rulezi

bash
export SATELIT_KEY=sat_live_...
CODES=EUR,USD,RON DAYS=30 node rates_widget.mjs

Ce scoate

stdout
rates-widget.html: 3 currencies, 4 credits

Scriptul complet

rates_widget.mjs
#!/usr/bin/env node
// Exchange rate widget: BNM's official rates with a 30-day line, as one HTML block for any site.
//   SATELIT_KEY=sat_live_... node rates_widget.mjs
// Optional: CODES (EUR,USD,RON), DAYS (30), OUT (rates-widget.html), WIDGET_LANG (ro).
// Writes the block and rates.json. No dependencies, Node 18 or newer, no script runs in the reader's browser.
// Put it in cron after BNM publishes: 15 13 * * 1-5 node /path/rates_widget.mjs
import { writeFileSync } from "node:fs";

const BASE = process.env.SATELIT_BASE ?? "https://api.satelit.md/v1";
const KEY = process.env.SATELIT_KEY;
const LANG = process.env.WIDGET_LANG ?? "ro";
const CODES = (process.env.CODES ?? "EUR,USD,RON").split(",").map((c) => c.trim().toUpperCase());
const DAYS = Number(process.env.DAYS ?? 30);
const OUT = process.env.OUT ?? "rates-widget.html";
if (!KEY) throw new Error("Set SATELIT_KEY");

const WORDS = {
  ro: { title: "Cursul oficial BNM", days: "zile" },
  ru: { title: "Официальный курс НБМ", days: "дней" },
  en: { title: "Official BNM rates", days: "days" },
  uk: { title: "Офіційний курс НБМ", days: "днів" },
};
const w = WORDS[LANG];
let credits = 0;

async function api(path, params = {}) {
  const url = new URL(BASE + path);
  for (const [k, v] of Object.entries({ lang: LANG, ...params })) url.searchParams.set(k, v);
  for (let attempt = 0; ; attempt++) {
    const res = await fetch(url, { headers: { Authorization: `Bearer ${KEY}` } });
    const retry = Number(res.headers.get("retry-after"));
    if ((res.status === 429 || res.status === 503) && retry && attempt < 2) {
      await new Promise((ok) => setTimeout(ok, retry * 1000));
      continue;
    }
    const body = await res.json();
    if (!res.ok) throw new Error(`${path}: ${body.error.code}: ${body.error.message}`);
    credits += body.meta.credits ?? 0;
    return body;
  }
}

const today = await api("/rates");
const rows = today.data.filter((r) => CODES.includes(r.code));
const history = await Promise.all(rows.map((r) => api("/rates/history", { code: r.code, days: DAYS })));

// a line of the last DAYS days, drawn as an inline SVG: no chart library, no request from the reader's page
function spark(points, width = 96, height = 28) {
  const v = points.map((p) => p.value);
  const min = Math.min(...v), max = Math.max(...v), span = max - min || 1;
  const xy = v.map((y, i) => `${((i / Math.max(v.length - 1, 1)) * width).toFixed(1)},${(height - 2 - ((y - min) / span) * (height - 4)).toFixed(1)}`);
  return `<svg viewBox="0 0 ${width} ${height}" width="${width}" height="${height}" aria-hidden="true"><polyline fill="none" stroke="currentColor" stroke-width="1.5" points="${xy.join(" ")}"/></svg>`;
}
const sign = (n) => (n > 0 ? `+${n}` : `${n}`);
const items = rows.map((r, i) => `  <li><b>${r.code}</b> <span class="v">${r.value.toFixed(4)}</span> <span class="c ${r.change_30d_pct >= 0 ? "up" : "down"}">${sign(r.change_30d_pct)}% / ${DAYS} ${w.days}</span> ${spark(history[i].data.points)}</li>`);

// BNM's licence (CC BY 4.0) asks for the source next to the numbers: the attribution line comes from the answer
const html = `<section class="satelit-rates" lang="${LANG}">
  <h3>${w.title}, ${rows[0]?.date ?? ""}</h3>
  <ul>
${items.join("\n")}
  </ul>
  <p class="src">${today.meta.attribution}</p>
</section>
<style>
.satelit-rates{font:14px/1.4 system-ui,sans-serif}.satelit-rates ul{list-style:none;margin:0;padding:0}
.satelit-rates li{display:flex;gap:.6em;align-items:center;padding:.3em 0}.satelit-rates .v{font-variant-numeric:tabular-nums}
.satelit-rates .up{color:#b42318}.satelit-rates .down{color:#067647}.satelit-rates .src{font-size:12px;opacity:.7}
</style>
`;
writeFileSync(OUT, html);
writeFileSync("rates.json", JSON.stringify({ date: rows[0]?.date, rates: rows, attribution: today.meta.attribution }, null, 2));
console.log(`${OUT}: ${rows.length} currencies, ${credits} credits`);

Rutele folosite

Datele din ghid

Actualizat:

Întrebări despre acest ghid

De ce să nu chem API-ul direct din pagină?

Cheia ar ajunge în browserul oricui deschide pagina. Scriptul rulează pe server o dată pe zi și scrie un fișier static: cheia rămâne la tine, iar pagina se încarcă fără cereri în plus.

Când publică BNM cursul?

BNM stabilește cursul oficial în fiecare zi lucrătoare. Cronul din ghid rulează la 13:15, de luni până vineri; câmpul date din răspuns spune pentru ce zi e cursul.

Pot folosi datele BNM pe un site comercial?

Datele BNM sunt sub licența CC BY 4.0: le poți folosi cu sursa menționată. Widgetul pune sub cifre rândul din meta.attribution. Aceleași date sunt gratuite la bnm.md.