@allratestoday/nbrb-exchange-rate 1.3.9 → 1.3.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +41 -41
  2. package/package.json +11 -5
package/README.md CHANGED
@@ -42,40 +42,40 @@ The open endpoint serves the *latest* table only and asks for a visible attribut
42
42
  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.
43
43
 
44
44
  <!-- daily-table:start -->
45
- Published **2026-10-12** by National Bank of the Republic of Belarus — 30 rates. Updated 2026-10-12.
45
+ Published **2026-10-16** by National Bank of the Republic of Belarus — 30 rates. Updated 2026-10-16.
46
46
 
47
47
  | Base | Quote | Type | Rate |
48
48
  | --- | --- | --- | ---: |
49
- | AED | BYN | reference | 0.82756 |
50
- | AMD | BYN | reference | 0.0084209 |
51
- | AUD | BYN | reference | 2.1215 |
52
- | BRL | BYN | reference | 0.6053 |
53
- | CAD | BYN | reference | 2.1359 |
54
- | CHF | BYN | reference | 3.6588 |
55
- | CNY | BYN | reference | 0.45531 |
56
- | CZK | BYN | reference | 0.139968 |
57
- | DKK | BYN | reference | 0.45609 |
58
- | EUR | BYN | reference | 3.4097 |
59
- | GBP | BYN | reference | 4.0241 |
60
- | INR | BYN | reference | 0.03135 |
61
- | IRR | BYN | reference | 0.000001755 |
62
- | ISK | BYN | reference | 0.024926 |
63
- | JPY | BYN | reference | 0.019198 |
64
- | KGS | BYN | reference | 0.034754 |
65
- | KWD | BYN | reference | 9.7786 |
66
- | KZT | BYN | reference | 0.0067066 |
67
- | MDL | BYN | reference | 0.1695 |
68
- | NOK | BYN | reference | 0.31767 |
69
- | NZD | BYN | reference | 1.7056 |
70
- | PLN | BYN | reference | 0.77901 |
71
- | RUB | BYN | reference | 0.035899 |
72
- | SEK | BYN | reference | 0.30514 |
73
- | SGD | BYN | reference | 2.3741 |
74
- | TRY | BYN | reference | 0.06159 |
75
- | UAH | BYN | reference | 0.067872 |
76
- | USD | BYN | reference | 3.0392 |
77
- | VND | BYN | reference | 0.00011743 |
78
- | XDR | BYN | reference | 4.1085 |
49
+ | AED | BYN | reference | 0.81936 |
50
+ | AMD | BYN | reference | 0.0083357 |
51
+ | AUD | BYN | reference | 2.0815 |
52
+ | BRL | BYN | reference | 0.59825 |
53
+ | CAD | BYN | reference | 2.1186 |
54
+ | CHF | BYN | reference | 3.6272 |
55
+ | CNY | BYN | reference | 0.45018 |
56
+ | CZK | BYN | reference | 0.138598 |
57
+ | DKK | BYN | reference | 0.45145 |
58
+ | EUR | BYN | reference | 3.3749 |
59
+ | GBP | BYN | reference | 3.9898 |
60
+ | INR | BYN | reference | 0.031591 |
61
+ | IRR | BYN | reference | 0.000001681 |
62
+ | ISK | BYN | reference | 0.024745 |
63
+ | JPY | BYN | reference | 0.019082 |
64
+ | KGS | BYN | reference | 0.034409 |
65
+ | KWD | BYN | reference | 9.6756 |
66
+ | KZT | BYN | reference | 0.0066356 |
67
+ | MDL | BYN | reference | 0.16745 |
68
+ | NOK | BYN | reference | 0.31606 |
69
+ | NZD | BYN | reference | 1.6885 |
70
+ | PLN | BYN | reference | 0.77269 |
71
+ | RUB | BYN | reference | 0.036038 |
72
+ | SEK | BYN | reference | 0.30164 |
73
+ | SGD | BYN | reference | 2.3466 |
74
+ | TRY | BYN | reference | 0.06089 |
75
+ | UAH | BYN | reference | 0.066994 |
76
+ | USD | BYN | reference | 3.0091 |
77
+ | VND | BYN | reference | 0.000116303 |
78
+ | XDR | BYN | reference | 4.0708 |
79
79
 
80
80
  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.
81
81
  <!-- daily-table:end -->
@@ -132,10 +132,10 @@ const pair = await getRate('USD', 'BYN', { apiKey: 'art_live_...' });
132
132
  {
133
133
  bank: 'nbrb',
134
134
  name: 'National Bank of the Republic of Belarus',
135
- rate_date: '2026-10-12', // National Bank of the Republic of Belarus's own publication date
135
+ rate_date: '2026-10-14', // National Bank of the Republic of Belarus's own publication date
136
136
  source: 'USD',
137
137
  target: 'BYN',
138
- rate: 3.0392,
138
+ rate: 3.0098,
139
139
  rate_type: 'reference',
140
140
  derived: false,
141
141
  method: 'published',
@@ -160,9 +160,9 @@ console.log(table.rate_date, table.rates.length);
160
160
  {
161
161
  bank: 'nbrb',
162
162
  name: 'National Bank of the Republic of Belarus',
163
- rate_date: '2026-10-12',
163
+ rate_date: '2026-10-14',
164
164
  rates: [
165
- { "base": "USD", "quote": "BYN", "type": "reference", "value": 3.0392 },
165
+ { "base": "USD", "quote": "BYN", "type": "reference", "value": 3.0098 },
166
166
  // … the rest of the published table (31 currencies vs BYN)
167
167
  ],
168
168
  disclaimer: '…'
@@ -202,7 +202,7 @@ Paid plans. One resolved rate per publication date — ready for charting, reval
202
202
  import { getHistory } from '@allratestoday/nbrb-exchange-rate';
203
203
 
204
204
  const series = await getHistory(
205
- { source: 'USD', target: 'BYN', from: '2026-01-01', to: '2026-10-12' },
205
+ { source: 'USD', target: 'BYN', from: '2026-01-01', to: '2026-10-14' },
206
206
  { apiKey: 'art_live_...' }
207
207
  );
208
208
  ```
@@ -215,11 +215,11 @@ const series = await getHistory(
215
215
  source: 'USD',
216
216
  target: 'BYN',
217
217
  from: '2026-01-01',
218
- to: '2026-10-12',
218
+ to: '2026-10-14',
219
219
  count: 152,
220
220
  rates: [
221
221
  // one entry per publication date
222
- { date: '2026-10-12', rate: 3.0392, rate_type: 'reference', derived: false, method: 'published' },
222
+ { date: '2026-10-14', rate: 3.0098, rate_type: 'reference', derived: false, method: 'published' },
223
223
  // …
224
224
  ],
225
225
  disclaimer: '…'
@@ -269,7 +269,7 @@ curl "https://allratestoday.com/api/v1/central-bank/nbrb/latest?format=xml&api_k
269
269
  - 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
270
270
  - 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
271
271
  - 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
272
- - 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`
272
+ - Evaluating? 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 that covers the free-plan methods (latest table, pairs); dated tables and history need a [paid plan](https://allratestoday.com/pricing/). The MCP servers expose it as `request_trial_key`
273
273
  - Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) · [for-ai-agents](https://allratestoday.com/for-ai-agents/)
274
274
 
275
275
  ## ⚖️ Published vs derived rates
@@ -338,9 +338,9 @@ getRate('USD', 'BYN', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
338
338
 
339
339
  Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
340
340
 
341
- - Hugging Face: [AllRates/central-bank-exchange-rates](https://huggingface.co/datasets/AllRates/central-bank-exchange-rates) — one CSV per institution (`rates/nbrb.csv`)
341
+ - Hugging Face: [AllRatesToday/central-bank-exchange-rates](https://huggingface.co/datasets/AllRatesToday/central-bank-exchange-rates) — one CSV per institution (`rates/nbrb.csv`)
342
342
  - Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
343
- - CDN JSON: `https://cdn.jsdelivr.net/gh/AllRates-Today/central-bank-exchange-rates@main/data/nbrb/latest.json`
343
+ - Raw JSON on GitHub: `https://raw.githubusercontent.com/AllRates-Today/central-bank-exchange-rates/main/data/nbrb/latest.json`
344
344
 
345
345
  ## 🔗 Links
346
346
 
package/package.json CHANGED
@@ -1,25 +1,31 @@
1
1
  {
2
2
  "name": "@allratestoday/nbrb-exchange-rate",
3
- "version": "1.3.9",
3
+ "version": "1.3.14",
4
4
  "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.",
5
5
  "keywords": [
6
6
  "nbrb",
7
+ "national-bank-of-the-republic-of-belarus",
7
8
  "national",
8
9
  "bank",
9
- "of",
10
- "the",
11
10
  "republic",
12
- "of",
13
11
  "belarus",
14
12
  "exchange-rate",
15
13
  "exchange-rates",
14
+ "exchangerate",
15
+ "exchange rate",
16
+ "byn-exchange-rate",
16
17
  "currency",
17
18
  "forex",
18
19
  "fx",
19
20
  "byn",
21
+ "currency-api",
22
+ "currency-exchange-rates",
23
+ "forex-api",
24
+ "currency-conversion",
25
+ "currency-exchange",
26
+ "currency-rates",
20
27
  "central-bank",
21
28
  "official-rates",
22
- "belarus",
23
29
  "api",
24
30
  "typescript"
25
31
  ],