@allratestoday/nbrb-exchange-rate 1.3.7 โ†’ 1.3.13

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 +44 -41
  2. package/package.json +11 -5
package/README.md CHANGED
@@ -37,43 +37,45 @@ The open endpoint serves the *latest* table only and asks for a visible attribut
37
37
 
38
38
  ## ๐Ÿ“ˆ Latest published table
39
39
 
40
- Today's full National Bank of the Republic of Belarus table, straight from the central bank's latest publication. On GitHub it is refreshed by [a daily Action](.github/workflows/daily-table.yml) that reads the keyless endpoint above and commits only when the central bank publishes a new table; the copy on npm is as of the package's publish date.
40
+ [![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/)
41
+
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.
41
43
 
42
44
  <!-- daily-table:start -->
43
- Published **2026-10-08** by National Bank of the Republic of Belarus โ€” 30 rates. Updated 2026-10-08.
45
+ Published **2026-10-14** by National Bank of the Republic of Belarus โ€” 30 rates. Updated 2026-10-14.
44
46
 
45
47
  | Base | Quote | Type | Rate |
46
48
  | --- | --- | --- | ---: |
47
- | AED | BYN | reference | 0.83504 |
48
- | AMD | BYN | reference | 0.0084755 |
49
- | AUD | BYN | reference | 2.1372 |
50
- | BRL | BYN | reference | 0.61579 |
51
- | CAD | BYN | reference | 2.1563 |
52
- | CHF | BYN | reference | 3.6808 |
53
- | CNY | BYN | reference | 0.45843 |
54
- | CZK | BYN | reference | 0.140587 |
55
- | DKK | BYN | reference | 0.45933 |
56
- | EUR | BYN | reference | 3.4338 |
57
- | GBP | BYN | reference | 4.0576 |
58
- | INR | BYN | reference | 0.031613 |
59
- | IRR | BYN | reference | 0.00000177 |
60
- | ISK | BYN | reference | 0.025028 |
61
- | JPY | BYN | reference | 0.019368 |
62
- | KGS | BYN | reference | 0.035068 |
63
- | KWD | BYN | reference | 9.8767 |
64
- | KZT | BYN | reference | 0.0068585 |
65
- | MDL | BYN | reference | 0.17219 |
66
- | NOK | BYN | reference | 0.32072 |
67
- | NZD | BYN | reference | 1.7193 |
68
- | PLN | BYN | reference | 0.78327 |
69
- | RUB | BYN | reference | 0.035871 |
70
- | SEK | BYN | reference | 0.30566 |
71
- | SGD | BYN | reference | 2.3961 |
72
- | TRY | BYN | reference | 0.06233 |
73
- | UAH | BYN | reference | 0.068307 |
74
- | USD | BYN | reference | 3.0667 |
75
- | VND | BYN | reference | 0.000118039 |
76
- | XDR | BYN | reference | 4.1541 |
49
+ | AED | BYN | reference | 0.81955 |
50
+ | AMD | BYN | reference | 0.00831 |
51
+ | AUD | BYN | reference | 2.0987 |
52
+ | BRL | BYN | reference | 0.60352 |
53
+ | CAD | BYN | reference | 2.1111 |
54
+ | CHF | BYN | reference | 3.6136 |
55
+ | CNY | BYN | reference | 0.45057 |
56
+ | CZK | BYN | reference | 0.138149 |
57
+ | DKK | BYN | reference | 0.45019 |
58
+ | EUR | BYN | reference | 3.3652 |
59
+ | GBP | BYN | reference | 3.9846 |
60
+ | INR | BYN | reference | 0.031535 |
61
+ | IRR | BYN | reference | 0.000001691 |
62
+ | ISK | BYN | reference | 0.024708 |
63
+ | JPY | BYN | reference | 0.019043 |
64
+ | KGS | BYN | reference | 0.034417 |
65
+ | KWD | BYN | reference | 9.653 |
66
+ | KZT | BYN | reference | 0.0066937 |
67
+ | MDL | BYN | reference | 0.16749 |
68
+ | NOK | BYN | reference | 0.31512 |
69
+ | NZD | BYN | reference | 1.688 |
70
+ | PLN | BYN | reference | 0.76845 |
71
+ | RUB | BYN | reference | 0.036006 |
72
+ | SEK | BYN | reference | 0.3011 |
73
+ | SGD | BYN | reference | 2.3514 |
74
+ | TRY | BYN | reference | 0.06097 |
75
+ | UAH | BYN | reference | 0.066737 |
76
+ | USD | BYN | reference | 3.0098 |
77
+ | VND | BYN | reference | 0.000116143 |
78
+ | XDR | BYN | reference | 4.073 |
77
79
 
78
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.
79
81
  <!-- daily-table:end -->
@@ -130,10 +132,10 @@ const pair = await getRate('USD', 'BYN', { apiKey: 'art_live_...' });
130
132
  {
131
133
  bank: 'nbrb',
132
134
  name: 'National Bank of the Republic of Belarus',
133
- rate_date: '2026-10-08', // 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
134
136
  source: 'USD',
135
137
  target: 'BYN',
136
- rate: 3.0667,
138
+ rate: 3.0098,
137
139
  rate_type: 'reference',
138
140
  derived: false,
139
141
  method: 'published',
@@ -158,9 +160,9 @@ console.log(table.rate_date, table.rates.length);
158
160
  {
159
161
  bank: 'nbrb',
160
162
  name: 'National Bank of the Republic of Belarus',
161
- rate_date: '2026-10-08',
163
+ rate_date: '2026-10-14',
162
164
  rates: [
163
- { "base": "USD", "quote": "BYN", "type": "reference", "value": 3.0667 },
165
+ { "base": "USD", "quote": "BYN", "type": "reference", "value": 3.0098 },
164
166
  // โ€ฆ the rest of the published table (31 currencies vs BYN)
165
167
  ],
166
168
  disclaimer: 'โ€ฆ'
@@ -200,7 +202,7 @@ Paid plans. One resolved rate per publication date โ€” ready for charting, reval
200
202
  import { getHistory } from '@allratestoday/nbrb-exchange-rate';
201
203
 
202
204
  const series = await getHistory(
203
- { source: 'USD', target: 'BYN', from: '2026-01-01', to: '2026-10-08' },
205
+ { source: 'USD', target: 'BYN', from: '2026-01-01', to: '2026-10-14' },
204
206
  { apiKey: 'art_live_...' }
205
207
  );
206
208
  ```
@@ -213,11 +215,11 @@ const series = await getHistory(
213
215
  source: 'USD',
214
216
  target: 'BYN',
215
217
  from: '2026-01-01',
216
- to: '2026-10-08',
218
+ to: '2026-10-14',
217
219
  count: 152,
218
220
  rates: [
219
221
  // one entry per publication date
220
- { date: '2026-10-08', rate: 3.0667, rate_type: 'reference', derived: false, method: 'published' },
222
+ { date: '2026-10-14', rate: 3.0098, rate_type: 'reference', derived: false, method: 'published' },
221
223
  // โ€ฆ
222
224
  ],
223
225
  disclaimer: 'โ€ฆ'
@@ -267,6 +269,7 @@ curl "https://allratestoday.com/api/v1/central-bank/nbrb/latest?format=xml&api_k
267
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
268
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
269
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`
270
273
  - Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) ยท [for-ai-agents](https://allratestoday.com/for-ai-agents/)
271
274
 
272
275
  ## โš–๏ธ Published vs derived rates
@@ -335,9 +338,9 @@ getRate('USD', 'BYN', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
335
338
 
336
339
  Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
337
340
 
338
- - 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`)
339
342
  - Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
340
- - 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`
341
344
 
342
345
  ## ๐Ÿ”— Links
343
346
 
package/package.json CHANGED
@@ -1,25 +1,31 @@
1
1
  {
2
2
  "name": "@allratestoday/nbrb-exchange-rate",
3
- "version": "1.3.7",
3
+ "version": "1.3.13",
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
  ],