@allratestoday/nbk-exchange-rate 1.3.5 โ†’ 1.3.7

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 +71 -7
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -4,6 +4,8 @@
4
4
  [![license](https://img.shields.io/npm/l/@allratestoday%2Fnbk-exchange-rate.svg)](https://github.com/AllRates-Today/nbk-exchange-rate/blob/main/LICENSE)
5
5
  [![zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](https://www.npmjs.com/package/@allratestoday/nbk-exchange-rate)
6
6
  [![TypeScript](https://img.shields.io/badge/TypeScript-types%20included-3178C6.svg)](https://www.typescriptlang.org/)
7
+ [![USD/KZT today](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fallratestoday.com%2Fapi%2Fopen%2Fcentral-bank%2Fnbk%3Fsource%3DUSD%26target%3DKZT&query=%24.rate&label=USD%2FKZT%20published%20by%20National%20Bank%20of%20Kazakhstan&color=0A7E8C&cacheSeconds=3600)](https://allratestoday.com/central-bank-rates-api/nbk/)
8
+ [![rate date](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fallratestoday.com%2Fapi%2Fopen%2Fcentral-bank%2Fnbk%3Fsource%3DUSD%26target%3DKZT&query=%24.rate_date&label=rate%20date&color=555&cacheSeconds=3600)](https://allratestoday.com/central-bank-rates-api/nbk/)
7
9
 
8
10
  **Official National Bank of Kazakhstan (Kazakhstan) 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 Kazakhstan itself prints, every business day.**
9
11
 
@@ -33,6 +35,67 @@ console.log(r.rate_date, r.rates.length); // the central bank's latest published
33
35
 
34
36
  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.
35
37
 
38
+ ## ๐Ÿ“ˆ Latest published table
39
+
40
+ Today's full National Bank of Kazakhstan 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.
41
+
42
+ <!-- daily-table:start -->
43
+ Published **2026-10-09** by National Bank of Kazakhstan โ€” 48 rates. Updated 2026-10-09.
44
+
45
+ | Base | Quote | Type | Rate |
46
+ | --- | --- | --- | ---: |
47
+ | AED | KZT | reference | 122.24 |
48
+ | AMD | KZT | reference | 1.247 |
49
+ | AUD | KZT | reference | 311.7 |
50
+ | AZN | KZT | reference | 264.86 |
51
+ | BRL | KZT | reference | 89.41 |
52
+ | BYN | KZT | reference | 147.02 |
53
+ | CAD | KZT | reference | 314.89 |
54
+ | CHF | KZT | reference | 538.68 |
55
+ | CNY | KZT | reference | 66.98 |
56
+ | CZK | KZT | reference | 20.58 |
57
+ | DKK | KZT | reference | 67.18 |
58
+ | EGP | KZT | reference | 8.58 |
59
+ | EUR | KZT | reference | 502.05 |
60
+ | GBP | KZT | reference | 592.69 |
61
+ | GEL | KZT | reference | 175.03 |
62
+ | HKD | KZT | reference | 57.21 |
63
+ | HUF | KZT | reference | 1.37 |
64
+ | IDR | KZT | reference | 0.02509 |
65
+ | ILS | KZT | reference | 145.76 |
66
+ | INR | KZT | reference | 4.64 |
67
+ | IRR | KZT | reference | 0.000254 |
68
+ | JPY | KZT | reference | 2.84 |
69
+ | KGS | KZT | reference | 5.13 |
70
+ | KRW | KZT | reference | 0.3338 |
71
+ | KWD | KZT | reference | 1457.12 |
72
+ | MDL | KZT | reference | 25.25 |
73
+ | MNT | KZT | reference | 0.1249 |
74
+ | MXN | KZT | reference | 24.89 |
75
+ | MYR | KZT | reference | 109.82 |
76
+ | NOK | KZT | reference | 46.89 |
77
+ | OMR | KZT | reference | 1166.17 |
78
+ | PKR | KZT | reference | 1.62 |
79
+ | PLN | KZT | reference | 114.67 |
80
+ | QAR | KZT | reference | 123.17 |
81
+ | RON | KZT | reference | 93.98 |
82
+ | RUB | KZT | reference | 5.26 |
83
+ | SAR | KZT | reference | 119.58 |
84
+ | SEK | KZT | reference | 44.8 |
85
+ | SGD | KZT | reference | 350.21 |
86
+ | THB | KZT | reference | 13.33 |
87
+ | TJS | KZT | reference | 48.96 |
88
+ | TRY | KZT | reference | 9.12 |
89
+ | UAH | KZT | reference | 10 |
90
+ | USD | KZT | reference | 448.94 |
91
+ | UZS | KZT | reference | 0.038 |
92
+ | VND | KZT | reference | 0.01734 |
93
+ | XDR | KZT | reference | 607.05 |
94
+ | ZAR | KZT | reference | 26.91 |
95
+
96
+ Source: [Official rates published by NBK, served by AllRatesToday](https://allratestoday.com/central-bank-rates-api/nbk/). Rates are as printed by the central bank; AllRatesToday is not affiliated with it.
97
+ <!-- daily-table:end -->
98
+
36
99
  ## ๐Ÿ”‘ Get your API key
37
100
 
38
101
  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 +148,10 @@ const pair = await getRate('USD', 'KZT', { apiKey: 'art_live_...' });
85
148
  {
86
149
  bank: 'nbk',
87
150
  name: 'National Bank of Kazakhstan',
88
- rate_date: '2026-10-06', // National Bank of Kazakhstan's own publication date
151
+ rate_date: '2026-10-08', // National Bank of Kazakhstan's own publication date
89
152
  source: 'USD',
90
153
  target: 'KZT',
91
- rate: 454.98,
154
+ rate: 447.14,
92
155
  rate_type: 'reference',
93
156
  derived: false,
94
157
  method: 'published',
@@ -113,9 +176,9 @@ console.log(table.rate_date, table.rates.length);
113
176
  {
114
177
  bank: 'nbk',
115
178
  name: 'National Bank of Kazakhstan',
116
- rate_date: '2026-10-06',
179
+ rate_date: '2026-10-08',
117
180
  rates: [
118
- { "base": "USD", "quote": "KZT", "type": "reference", "value": 454.98 },
181
+ { "base": "USD", "quote": "KZT", "type": "reference", "value": 447.14 },
119
182
  // โ€ฆ the rest of the published table (48 currencies vs KZT)
120
183
  ],
121
184
  disclaimer: 'โ€ฆ'
@@ -155,7 +218,7 @@ Paid plans. One resolved rate per publication date โ€” ready for charting, reval
155
218
  import { getHistory } from '@allratestoday/nbk-exchange-rate';
156
219
 
157
220
  const series = await getHistory(
158
- { source: 'USD', target: 'KZT', from: '2026-01-01', to: '2026-10-06' },
221
+ { source: 'USD', target: 'KZT', from: '2026-01-01', to: '2026-10-08' },
159
222
  { apiKey: 'art_live_...' }
160
223
  );
161
224
  ```
@@ -168,11 +231,11 @@ const series = await getHistory(
168
231
  source: 'USD',
169
232
  target: 'KZT',
170
233
  from: '2026-01-01',
171
- to: '2026-10-06',
234
+ to: '2026-10-08',
172
235
  count: 152,
173
236
  rates: [
174
237
  // one entry per publication date
175
- { date: '2026-10-06', rate: 454.98, rate_type: 'reference', derived: false, method: 'published' },
238
+ { date: '2026-10-08', rate: 447.14, rate_type: 'reference', derived: false, method: 'published' },
176
239
  // โ€ฆ
177
240
  ],
178
241
  disclaimer: 'โ€ฆ'
@@ -221,6 +284,7 @@ curl "https://allratestoday.com/api/v1/central-bank/nbk/latest?format=xml&api_ke
221
284
 
222
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
223
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('nbk')` 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
+ - 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 nbk ...` command
224
288
  - Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) ยท [for-ai-agents](https://allratestoday.com/for-ai-agents/)
225
289
 
226
290
  ## โš–๏ธ Published vs derived rates
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allratestoday/nbk-exchange-rate",
3
- "version": "1.3.5",
3
+ "version": "1.3.7",
4
4
  "description": "Official National Bank of Kazakhstan (Kazakhstan) daily exchange rates โ€” 48 currencies vs KZT, history since 2016. Zero-dependency Node.js/TypeScript client.",
5
5
  "keywords": [
6
6
  "nbk",