@allratestoday/bnb-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 +43 -40
  2. package/package.json +11 -1
package/README.md CHANGED
@@ -37,42 +37,44 @@ 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 Bulgarian National Bank 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 Bulgarian National Bank table](https://allratestoday.com/api/open/central-bank/bnb/table.svg)](https://allratestoday.com/central-bank-rates-api/bnb/)
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 Bulgarian National Bank โ€” 29 rates. Updated 2026-10-08.
45
+ Published **2026-10-13** by Bulgarian National Bank โ€” 29 rates. Updated 2026-10-14.
44
46
 
45
47
  | Base | Quote | Type | Rate |
46
48
  | --- | --- | --- | ---: |
47
- | EUR | AUD | reference | 1.611 |
48
- | EUR | BRL | reference | 5.6118 |
49
- | EUR | CAD | reference | 1.5953 |
50
- | EUR | CHF | reference | 0.9326 |
51
- | EUR | CNY | reference | 7.4972 |
52
- | EUR | CZK | reference | 24.403 |
53
- | EUR | DKK | reference | 7.4739 |
54
- | EUR | GBP | reference | 0.84698 |
55
- | EUR | HKD | reference | 8.7783 |
56
- | EUR | HUF | reference | 366.25 |
57
- | EUR | IDR | reference | 20045.31 |
58
- | EUR | ILS | reference | 3.4423 |
59
- | EUR | INR | reference | 108.2635 |
60
- | EUR | ISK | reference | 137 |
61
- | EUR | JPY | reference | 177.05 |
62
- | EUR | KRW | reference | 1502.79 |
63
- | EUR | MXN | reference | 20.1486 |
64
- | EUR | MYR | reference | 4.5768 |
65
- | EUR | NOK | reference | 10.717 |
66
- | EUR | NZD | reference | 2.0014 |
67
- | EUR | PHP | reference | 70.475 |
68
- | EUR | PLN | reference | 4.3753 |
69
- | EUR | RON | reference | 5.3434 |
70
- | EUR | SEK | reference | 11.194 |
71
- | EUR | SGD | reference | 1.434 |
72
- | EUR | THB | reference | 37.68 |
73
- | EUR | TRY | reference | 55.0523 |
74
- | EUR | USD | reference | 1.1186 |
75
- | EUR | ZAR | reference | 18.6252 |
49
+ | EUR | AUD | reference | 1.6033 |
50
+ | EUR | BRL | reference | 5.6125 |
51
+ | EUR | CAD | reference | 1.5933 |
52
+ | EUR | CHF | reference | 0.9312 |
53
+ | EUR | CNY | reference | 7.489 |
54
+ | EUR | CZK | reference | 24.368 |
55
+ | EUR | DKK | reference | 7.4753 |
56
+ | EUR | GBP | reference | 0.8446 |
57
+ | EUR | HKD | reference | 8.7802 |
58
+ | EUR | HUF | reference | 364.31 |
59
+ | EUR | IDR | reference | 20004.87 |
60
+ | EUR | ILS | reference | 3.4404 |
61
+ | EUR | INR | reference | 106.6 |
62
+ | EUR | ISK | reference | 136.2 |
63
+ | EUR | JPY | reference | 176.91 |
64
+ | EUR | KRW | reference | 1500.81 |
65
+ | EUR | MXN | reference | 20.5126 |
66
+ | EUR | MYR | reference | 4.5714 |
67
+ | EUR | NOK | reference | 10.6685 |
68
+ | EUR | NZD | reference | 1.9931 |
69
+ | EUR | PHP | reference | 70.225 |
70
+ | EUR | PLN | reference | 4.3768 |
71
+ | EUR | RON | reference | 5.3363 |
72
+ | EUR | SEK | reference | 11.1698 |
73
+ | EUR | SGD | reference | 1.4319 |
74
+ | EUR | THB | reference | 37.58 |
75
+ | EUR | TRY | reference | 55.2325 |
76
+ | EUR | USD | reference | 1.1188 |
77
+ | EUR | ZAR | reference | 18.4561 |
76
78
 
77
79
  Source: [Official rates published by BNB, served by AllRatesToday](https://allratestoday.com/central-bank-rates-api/bnb/). Rates are as printed by the central bank; AllRatesToday is not affiliated with it.
78
80
  <!-- daily-table:end -->
@@ -129,10 +131,10 @@ const pair = await getRate('EUR', 'USD', { apiKey: 'art_live_...' });
129
131
  {
130
132
  bank: 'bnb',
131
133
  name: 'Bulgarian National Bank',
132
- rate_date: '2026-10-08', // Bulgarian National Bank's own publication date
134
+ rate_date: '2026-10-13', // Bulgarian National Bank's own publication date
133
135
  source: 'EUR',
134
136
  target: 'USD',
135
- rate: 1.1186,
137
+ rate: 1.1188,
136
138
  rate_type: 'reference',
137
139
  derived: false,
138
140
  method: 'published',
@@ -157,9 +159,9 @@ console.log(table.rate_date, table.rates.length);
157
159
  {
158
160
  bank: 'bnb',
159
161
  name: 'Bulgarian National Bank',
160
- rate_date: '2026-10-08',
162
+ rate_date: '2026-10-13',
161
163
  rates: [
162
- { "base": "EUR", "quote": "USD", "type": "reference", "value": 1.1186 },
164
+ { "base": "EUR", "quote": "USD", "type": "reference", "value": 1.1188 },
163
165
  // โ€ฆ the rest of the published table (29 currencies vs EUR)
164
166
  ],
165
167
  disclaimer: 'โ€ฆ'
@@ -199,7 +201,7 @@ Paid plans. One resolved rate per publication date โ€” ready for charting, reval
199
201
  import { getHistory } from '@allratestoday/bnb-exchange-rate';
200
202
 
201
203
  const series = await getHistory(
202
- { source: 'EUR', target: 'USD', from: '2026-01-01', to: '2026-10-08' },
204
+ { source: 'EUR', target: 'USD', from: '2026-01-01', to: '2026-10-13' },
203
205
  { apiKey: 'art_live_...' }
204
206
  );
205
207
  ```
@@ -212,11 +214,11 @@ const series = await getHistory(
212
214
  source: 'EUR',
213
215
  target: 'USD',
214
216
  from: '2026-01-01',
215
- to: '2026-10-08',
217
+ to: '2026-10-13',
216
218
  count: 152,
217
219
  rates: [
218
220
  // one entry per publication date
219
- { date: '2026-10-08', rate: 1.1186, rate_type: 'reference', derived: false, method: 'published' },
221
+ { date: '2026-10-13', rate: 1.1188, rate_type: 'reference', derived: false, method: 'published' },
220
222
  // โ€ฆ
221
223
  ],
222
224
  disclaimer: 'โ€ฆ'
@@ -266,6 +268,7 @@ curl "https://allratestoday.com/api/v1/central-bank/bnb/latest?format=xml&api_ke
266
268
  - 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
267
269
  - 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('bnb')` 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
268
270
  - 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 bnb ...` command
271
+ - 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`
269
272
  - Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) ยท [for-ai-agents](https://allratestoday.com/for-ai-agents/)
270
273
 
271
274
  ## โš–๏ธ Published vs derived rates
@@ -334,9 +337,9 @@ getRate('EUR', 'USD', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
334
337
 
335
338
  Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
336
339
 
337
- - Hugging Face: [AllRates/central-bank-exchange-rates](https://huggingface.co/datasets/AllRates/central-bank-exchange-rates) โ€” one CSV per institution (`rates/bnb.csv`)
340
+ - Hugging Face: [AllRatesToday/central-bank-exchange-rates](https://huggingface.co/datasets/AllRatesToday/central-bank-exchange-rates) โ€” one CSV per institution (`rates/bnb.csv`)
338
341
  - Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
339
- - CDN JSON: `https://cdn.jsdelivr.net/gh/AllRates-Today/central-bank-exchange-rates@main/data/bnb/latest.json`
342
+ - Raw JSON on GitHub: `https://raw.githubusercontent.com/AllRates-Today/central-bank-exchange-rates/main/data/bnb/latest.json`
340
343
 
341
344
  ## ๐Ÿ”— Links
342
345
 
package/package.json CHANGED
@@ -1,18 +1,28 @@
1
1
  {
2
2
  "name": "@allratestoday/bnb-exchange-rate",
3
- "version": "1.3.7",
3
+ "version": "1.3.13",
4
4
  "description": "Official Bulgarian National Bank (Bulgaria) daily exchange rates โ€” 29 currencies vs EUR, history since 2016. Zero-dependency Node.js/TypeScript client.",
5
5
  "keywords": [
6
6
  "bnb",
7
+ "bulgarian-national-bank",
7
8
  "bulgarian",
8
9
  "national",
9
10
  "bank",
10
11
  "exchange-rate",
11
12
  "exchange-rates",
13
+ "exchangerate",
14
+ "exchange rate",
15
+ "eur-exchange-rate",
12
16
  "currency",
13
17
  "forex",
14
18
  "fx",
15
19
  "eur",
20
+ "currency-api",
21
+ "currency-exchange-rates",
22
+ "forex-api",
23
+ "currency-conversion",
24
+ "currency-exchange",
25
+ "currency-rates",
16
26
  "central-bank",
17
27
  "official-rates",
18
28
  "bulgaria",