@allratestoday/nbu-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 +55 -55
  2. package/package.json +11 -3
package/README.md CHANGED
@@ -42,55 +42,55 @@ 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-08** by National Bank of Ukraine — 45 rates. Updated 2026-10-12.
45
+ Published **2026-10-16** by National Bank of Ukraine — 45 rates. Updated 2026-10-16.
46
46
 
47
47
  | Base | Quote | Type | Rate |
48
48
  | --- | --- | --- | ---: |
49
- | AED | UAH | reference | 12.2143 |
50
- | AUD | UAH | reference | 31.1876 |
51
- | AZN | UAH | reference | 26.3947 |
52
- | BDT | UAH | reference | 0.36496 |
53
- | CAD | UAH | reference | 31.4872 |
54
- | CHF | UAH | reference | 53.888 |
55
- | CNY | UAH | reference | 6.6901 |
56
- | CZK | UAH | reference | 2.0531 |
57
- | DKK | UAH | reference | 6.7104 |
58
- | DZD | UAH | reference | 0.33334 |
59
- | EGP | UAH | reference | 0.8563 |
60
- | EUR | UAH | reference | 50.1569 |
61
- | GBP | UAH | reference | 59.2589 |
62
- | GEL | UAH | reference | 17.2536 |
63
- | HKD | UAH | reference | 5.7164 |
64
- | HUF | UAH | reference | 0.136731 |
65
- | IDR | UAH | reference | 0.0025082 |
66
- | ILS | UAH | reference | 14.6203 |
67
- | INR | UAH | reference | 0.46364 |
68
- | JPY | UAH | reference | 0.28358 |
69
- | KRW | UAH | reference | 0.033488 |
70
- | KZT | UAH | reference | 0.100184 |
49
+ | AED | UAH | reference | 12.2208 |
50
+ | AUD | UAH | reference | 31.0282 |
51
+ | AZN | UAH | reference | 26.4081 |
52
+ | BDT | UAH | reference | 0.3645 |
53
+ | CAD | UAH | reference | 31.6004 |
54
+ | CHF | UAH | reference | 54.0698 |
55
+ | CNY | UAH | reference | 6.7084 |
56
+ | CZK | UAH | reference | 2.0661 |
57
+ | DKK | UAH | reference | 6.7302 |
58
+ | DZD | UAH | reference | 0.33343 |
59
+ | EGP | UAH | reference | 0.8395 |
60
+ | EUR | UAH | reference | 50.3081 |
61
+ | GBP | UAH | reference | 59.47 |
62
+ | GEL | UAH | reference | 17.2875 |
63
+ | HKD | UAH | reference | 5.72 |
64
+ | HUF | UAH | reference | 0.138395 |
65
+ | IDR | UAH | reference | 0.0025027 |
66
+ | ILS | UAH | reference | 14.4751 |
67
+ | INR | UAH | reference | 0.47231 |
68
+ | JPY | UAH | reference | 0.28427 |
69
+ | KRW | UAH | reference | 0.03337 |
70
+ | KZT | UAH | reference | 0.099145 |
71
71
  | LBP | UAH | reference | 0.000501 |
72
- | MDL | UAH | reference | 2.5172 |
73
- | MXN | UAH | reference | 2.4787 |
74
- | MYR | UAH | reference | 10.9793 |
75
- | NOK | UAH | reference | 4.6837 |
76
- | NZD | UAH | reference | 25.1036 |
77
- | PLN | UAH | reference | 11.4481 |
78
- | RON | UAH | reference | 9.3678 |
79
- | RSD | UAH | reference | 0.42713 |
80
- | SAR | UAH | reference | 11.9499 |
81
- | SEK | UAH | reference | 4.4694 |
82
- | SGD | UAH | reference | 35.0409 |
83
- | THB | UAH | reference | 1.33117 |
84
- | TND | UAH | reference | 14.8989 |
85
- | TRY | UAH | reference | 0.9119 |
86
- | USD | UAH | reference | 44.8639 |
87
- | VND | UAH | reference | 0.0017268 |
88
- | XAG | UAH | reference | 2701.42 |
89
- | XAU | UAH | reference | 184852.82 |
90
- | XDR | UAH | reference | 60.6468 |
91
- | XPD | UAH | reference | 51125.69 |
92
- | XPT | UAH | reference | 73468.81 |
93
- | ZAR | UAH | reference | 2.6876 |
72
+ | MDL | UAH | reference | 2.5027 |
73
+ | MXN | UAH | reference | 2.4227 |
74
+ | MYR | UAH | reference | 10.9963 |
75
+ | NOK | UAH | reference | 4.7241 |
76
+ | NZD | UAH | reference | 25.1583 |
77
+ | PLN | UAH | reference | 11.5141 |
78
+ | RON | UAH | reference | 9.4299 |
79
+ | RSD | UAH | reference | 0.42844 |
80
+ | SAR | UAH | reference | 11.9608 |
81
+ | SEK | UAH | reference | 4.5018 |
82
+ | SGD | UAH | reference | 34.9915 |
83
+ | THB | UAH | reference | 1.33884 |
84
+ | TND | UAH | reference | 14.9435 |
85
+ | TRY | UAH | reference | 0.9083 |
86
+ | USD | UAH | reference | 44.8871 |
87
+ | VND | UAH | reference | 0.0017346 |
88
+ | XAG | UAH | reference | 2543.75 |
89
+ | XAU | UAH | reference | 186185.54 |
90
+ | XDR | UAH | reference | 60.7631 |
91
+ | XPD | UAH | reference | 50703.57 |
92
+ | XPT | UAH | reference | 72577.59 |
93
+ | ZAR | UAH | reference | 2.7109 |
94
94
 
95
95
  Source: [Official rates published by NBU, served by AllRatesToday](https://allratestoday.com/central-bank-rates-api/nbu/). Rates are as printed by the central bank; AllRatesToday is not affiliated with it.
96
96
  <!-- daily-table:end -->
@@ -147,10 +147,10 @@ const pair = await getRate('USD', 'UAH', { apiKey: 'art_live_...' });
147
147
  {
148
148
  bank: 'nbu',
149
149
  name: 'National Bank of Ukraine',
150
- rate_date: '2026-10-08', // National Bank of Ukraine's own publication date
150
+ rate_date: '2026-10-13', // National Bank of Ukraine's own publication date
151
151
  source: 'USD',
152
152
  target: 'UAH',
153
- rate: 44.8639,
153
+ rate: 44.9567,
154
154
  rate_type: 'reference',
155
155
  derived: false,
156
156
  method: 'published',
@@ -175,9 +175,9 @@ console.log(table.rate_date, table.rates.length);
175
175
  {
176
176
  bank: 'nbu',
177
177
  name: 'National Bank of Ukraine',
178
- rate_date: '2026-10-08',
178
+ rate_date: '2026-10-13',
179
179
  rates: [
180
- { "base": "USD", "quote": "UAH", "type": "reference", "value": 44.8639 },
180
+ { "base": "USD", "quote": "UAH", "type": "reference", "value": 44.9567 },
181
181
  // … the rest of the published table (45 currencies vs UAH)
182
182
  ],
183
183
  disclaimer: '…'
@@ -217,7 +217,7 @@ Paid plans. One resolved rate per publication date — ready for charting, reval
217
217
  import { getHistory } from '@allratestoday/nbu-exchange-rate';
218
218
 
219
219
  const series = await getHistory(
220
- { source: 'USD', target: 'UAH', from: '2026-01-01', to: '2026-10-08' },
220
+ { source: 'USD', target: 'UAH', from: '2026-01-01', to: '2026-10-13' },
221
221
  { apiKey: 'art_live_...' }
222
222
  );
223
223
  ```
@@ -230,11 +230,11 @@ const series = await getHistory(
230
230
  source: 'USD',
231
231
  target: 'UAH',
232
232
  from: '2026-01-01',
233
- to: '2026-10-08',
233
+ to: '2026-10-13',
234
234
  count: 152,
235
235
  rates: [
236
236
  // one entry per publication date
237
- { date: '2026-10-08', rate: 44.8639, rate_type: 'reference', derived: false, method: 'published' },
237
+ { date: '2026-10-13', rate: 44.9567, rate_type: 'reference', derived: false, method: 'published' },
238
238
  // …
239
239
  ],
240
240
  disclaimer: '…'
@@ -285,7 +285,7 @@ curl "https://allratestoday.com/api/v1/central-bank/nbu/latest?format=xml&api_ke
285
285
  - 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
286
286
  - 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('nbu')` 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
287
287
  - 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 nbu ...` command
288
- - 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`
288
+ - 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`
289
289
  - Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) · [for-ai-agents](https://allratestoday.com/for-ai-agents/)
290
290
 
291
291
  ## ⚖️ Published vs derived rates
@@ -354,9 +354,9 @@ getRate('USD', 'UAH', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
354
354
 
355
355
  Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
356
356
 
357
- - Hugging Face: [AllRates/central-bank-exchange-rates](https://huggingface.co/datasets/AllRates/central-bank-exchange-rates) — one CSV per institution (`rates/nbu.csv`)
357
+ - Hugging Face: [AllRatesToday/central-bank-exchange-rates](https://huggingface.co/datasets/AllRatesToday/central-bank-exchange-rates) — one CSV per institution (`rates/nbu.csv`)
358
358
  - Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
359
- - CDN JSON: `https://cdn.jsdelivr.net/gh/AllRates-Today/central-bank-exchange-rates@main/data/nbu/latest.json`
359
+ - Raw JSON on GitHub: `https://raw.githubusercontent.com/AllRates-Today/central-bank-exchange-rates/main/data/nbu/latest.json`
360
360
 
361
361
  ## 🔗 Links
362
362
 
package/package.json CHANGED
@@ -1,22 +1,30 @@
1
1
  {
2
2
  "name": "@allratestoday/nbu-exchange-rate",
3
- "version": "1.3.9",
3
+ "version": "1.3.14",
4
4
  "description": "Official National Bank of Ukraine (Ukraine) daily exchange rates — 45 currencies vs UAH, history since 1996. Zero-dependency Node.js/TypeScript client.",
5
5
  "keywords": [
6
6
  "nbu",
7
+ "national-bank-of-ukraine",
7
8
  "national",
8
9
  "bank",
9
- "of",
10
10
  "ukraine",
11
11
  "exchange-rate",
12
12
  "exchange-rates",
13
+ "exchangerate",
14
+ "exchange rate",
15
+ "uah-exchange-rate",
13
16
  "currency",
14
17
  "forex",
15
18
  "fx",
16
19
  "uah",
20
+ "currency-api",
21
+ "currency-exchange-rates",
22
+ "forex-api",
23
+ "currency-conversion",
24
+ "currency-exchange",
25
+ "currency-rates",
17
26
  "central-bank",
18
27
  "official-rates",
19
- "ukraine",
20
28
  "api",
21
29
  "typescript"
22
30
  ],