@allratestoday/nbrb-exchange-rate 1.3.6 → 1.3.9

package/README.md

@@ -4,6 +4,8 @@
 [![license](https://img.shields.io/npm/l/@allratestoday%2Fnbrb-exchange-rate.svg)](https://github.com/AllRates-Today/nbrb-exchange-rate/blob/main/LICENSE)
 [![zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](https://www.npmjs.com/package/@allratestoday/nbrb-exchange-rate)
 [![TypeScript](https://img.shields.io/badge/TypeScript-types%20included-3178C6.svg)](https://www.typescriptlang.org/)
+[![USD/BYN today](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fallratestoday.com%2Fapi%2Fopen%2Fcentral-bank%2Fnbrb%3Fsource%3DUSD%26target%3DBYN&query=%24.rate&label=USD%2FBYN%20published%20by%20National%20Bank%20of%20the%20Republic%20of%20Belarus&color=0A7E8C&cacheSeconds=3600)](https://allratestoday.com/central-bank-rates-api/nbrb/)
+[![rate date](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fallratestoday.com%2Fapi%2Fopen%2Fcentral-bank%2Fnbrb%3Fsource%3DUSD%26target%3DBYN&query=%24.rate_date&label=rate%20date&color=555&cacheSeconds=3600)](https://allratestoday.com/central-bank-rates-api/nbrb/)
 
 **Official National Bank of the Republic of Belarus (Belarus) daily exchange rates for Node.js and TypeScript. The published central bank rates behind tax filings, customs valuations, audits, and compliant invoicing — not market estimates, but the numbers National Bank of the Republic of Belarus itself prints, every business day.**
 
@@ -33,6 +35,51 @@ console.log(r.rate_date, r.rates.length); // the central bank's latest published
 
 The open endpoint serves the *latest* table only and asks for a visible attribution link. The client below uses the keyed API, which adds point-in-time tables, history, and CSV/XML/Excel output.
 
+## 📈 Latest published table
+
+[![Latest National Bank of the Republic of Belarus table](https://allratestoday.com/api/open/central-bank/nbrb/table.svg)](https://allratestoday.com/central-bank-rates-api/nbrb/)
+
+The image is rendered live from the keyless endpoint above, so it follows the central bank's publications on npm and on GitHub alike without a new release. The text copy below is there for search and copy-paste: on GitHub [a daily Action](.github/workflows/daily-table.yml) refreshes it whenever the central bank publishes a new table; on npm it is as of the package's publish date.
+
+<!-- daily-table:start -->
+Published **2026-10-12** by National Bank of the Republic of Belarus — 30 rates. Updated 2026-10-12.
+
+| Base | Quote | Type | Rate |
+| --- | --- | --- | ---: |
+| AED | BYN | reference | 0.82756 |
+| AMD | BYN | reference | 0.0084209 |
+| AUD | BYN | reference | 2.1215 |
+| BRL | BYN | reference | 0.6053 |
+| CAD | BYN | reference | 2.1359 |
+| CHF | BYN | reference | 3.6588 |
+| CNY | BYN | reference | 0.45531 |
+| CZK | BYN | reference | 0.139968 |
+| DKK | BYN | reference | 0.45609 |
+| EUR | BYN | reference | 3.4097 |
+| GBP | BYN | reference | 4.0241 |
+| INR | BYN | reference | 0.03135 |
+| IRR | BYN | reference | 0.000001755 |
+| ISK | BYN | reference | 0.024926 |
+| JPY | BYN | reference | 0.019198 |
+| KGS | BYN | reference | 0.034754 |
+| KWD | BYN | reference | 9.7786 |
+| KZT | BYN | reference | 0.0067066 |
+| MDL | BYN | reference | 0.1695 |
+| NOK | BYN | reference | 0.31767 |
+| NZD | BYN | reference | 1.7056 |
+| PLN | BYN | reference | 0.77901 |
+| RUB | BYN | reference | 0.035899 |
+| SEK | BYN | reference | 0.30514 |
+| SGD | BYN | reference | 2.3741 |
+| TRY | BYN | reference | 0.06159 |
+| UAH | BYN | reference | 0.067872 |
+| USD | BYN | reference | 3.0392 |
+| VND | BYN | reference | 0.00011743 |
+| XDR | BYN | reference | 4.1085 |
+
+Source: [Official rates published by NBRB, served by AllRatesToday](https://allratestoday.com/central-bank-rates-api/nbrb/). Rates are as printed by the central bank; AllRatesToday is not affiliated with it.
+<!-- daily-table:end -->
+
 ## 🔑 Get your API key
 
 Get a free API key at [allratestoday.com/register](https://allratestoday.com/register) — no credit card required. Latest rates are on every plan, including free.
@@ -85,10 +132,10 @@ const pair = await getRate('USD', 'BYN', { apiKey: 'art_live_...' });
 {
   bank: 'nbrb',
   name: 'National Bank of the Republic of Belarus',
-  rate_date: '2026-10-08',   // National Bank of the Republic of Belarus's own publication date
+  rate_date: '2026-10-12',   // National Bank of the Republic of Belarus's own publication date
   source: 'USD',
   target: 'BYN',
-  rate: 3.0667,
+  rate: 3.0392,
   rate_type: 'reference',
   derived: false,
   method: 'published',
@@ -113,9 +160,9 @@ console.log(table.rate_date, table.rates.length);
 {
   bank: 'nbrb',
   name: 'National Bank of the Republic of Belarus',
-  rate_date: '2026-10-08',
+  rate_date: '2026-10-12',
   rates: [
-    { "base": "USD", "quote": "BYN", "type": "reference", "value": 3.0667 },
+    { "base": "USD", "quote": "BYN", "type": "reference", "value": 3.0392 },
     // … the rest of the published table (31 currencies vs BYN)
   ],
   disclaimer: '…'
@@ -155,7 +202,7 @@ Paid plans. One resolved rate per publication date — ready for charting, reval
 import { getHistory } from '@allratestoday/nbrb-exchange-rate';
 
 const series = await getHistory(
-  { source: 'USD', target: 'BYN', from: '2026-01-01', to: '2026-10-08' },
+  { source: 'USD', target: 'BYN', from: '2026-01-01', to: '2026-10-12' },
   { apiKey: 'art_live_...' }
 );
 ```
@@ -168,11 +215,11 @@ const series = await getHistory(
   source: 'USD',
   target: 'BYN',
   from: '2026-01-01',
-  to: '2026-10-08',
+  to: '2026-10-12',
   count: 152,
   rates: [
     // one entry per publication date
-    { date: '2026-10-08', rate: 3.0667, rate_type: 'reference', derived: false, method: 'published' },
+    { date: '2026-10-12', rate: 3.0392, rate_type: 'reference', derived: false, method: 'published' },
     // …
   ],
   disclaimer: '…'
@@ -222,6 +269,7 @@ curl "https://allratestoday.com/api/v1/central-bank/nbrb/latest?format=xml&api_k
 - MCP server: `npx -y @allratestoday/central-bank-mcp` (stdio) or the hosted endpoint `https://allratestoday.com/api/mcp` — tools for official rates, history, cross-bank comparison and publication calendars
 - Already using the general SDK or MCP server? Since 2026-10-01 [`@allratestoday/sdk`](https://www.npmjs.com/package/@allratestoday/sdk) 1.4+ has `officialRates('nbrb')` and [`@allratestoday/mcp-server`](https://www.npmjs.com/package/@allratestoday/mcp-server) 0.6+ has a `get_official_rates` tool — both return this source's latest table with no key, so you can add it without a second dependency
 - Claude Code plugin (no key): `/plugin marketplace add AllRates-Today/claude-code-plugin` then `/plugin install allratestoday@allratestoday` — bundles both MCP servers plus an `/official-rate nbrb ...` command
+- Need dated tables or history for an evaluation? Agents can self-issue a trial key with no signup: `POST https://allratestoday.com/api/agent/keys` (send `Content-Type: application/json`) returns a 100-call key valid 7 days; the MCP servers expose it as `request_trial_key`
 - Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) · [for-ai-agents](https://allratestoday.com/for-ai-agents/)
 
 ## ⚖️ Published vs derived rates

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allratestoday/nbrb-exchange-rate",
-  "version": "1.3.6",
+  "version": "1.3.9",
   "description": "Official National Bank of the Republic of Belarus (Belarus) daily exchange rates — 31 currencies vs BYN, history since 2016. Zero-dependency Node.js/TypeScript client.",
   "keywords": [
     "nbrb",