@allratestoday/bnb-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 +39 -39
  2. package/package.json +11 -1
package/README.md CHANGED
@@ -42,39 +42,39 @@ 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 Bulgarian National Bank — 29 rates. Updated 2026-10-12.
45
+ Published **2026-10-16** by Bulgarian National Bank — 29 rates. Updated 2026-10-16.
46
46
 
47
47
  | Base | Quote | Type | Rate |
48
48
  | --- | --- | --- | ---: |
49
- | EUR | AUD | reference | 1.6032 |
50
- | EUR | BRL | reference | 5.5819 |
51
- | EUR | CAD | reference | 1.5946 |
52
- | EUR | CHF | reference | 0.9312 |
53
- | EUR | CNY | reference | 7.4832 |
54
- | EUR | CZK | reference | 24.391 |
49
+ | EUR | AUD | reference | 1.6171 |
50
+ | EUR | BRL | reference | 5.7197 |
51
+ | EUR | CAD | reference | 1.5935 |
52
+ | EUR | CHF | reference | 0.9272 |
53
+ | EUR | CNY | reference | 7.524 |
54
+ | EUR | CZK | reference | 24.323 |
55
55
  | EUR | DKK | reference | 7.4748 |
56
- | EUR | GBP | reference | 0.84478 |
57
- | EUR | HKD | reference | 8.7743 |
58
- | EUR | HUF | reference | 365.13 |
59
- | EUR | IDR | reference | 20036.18 |
60
- | EUR | ILS | reference | 3.432 |
61
- | EUR | INR | reference | 107.086 |
62
- | EUR | ISK | reference | 136.4 |
63
- | EUR | JPY | reference | 177.33 |
64
- | EUR | KRW | reference | 1490.53 |
65
- | EUR | MXN | reference | 20.5081 |
66
- | EUR | MYR | reference | 4.5663 |
67
- | EUR | NOK | reference | 10.6955 |
68
- | EUR | NZD | reference | 1.9968 |
69
- | EUR | PHP | reference | 70.169 |
70
- | EUR | PLN | reference | 4.385 |
71
- | EUR | RON | reference | 5.337 |
72
- | EUR | SEK | reference | 11.1965 |
73
- | EUR | SGD | reference | 1.4314 |
74
- | EUR | THB | reference | 37.585 |
75
- | EUR | TRY | reference | 55.1635 |
76
- | EUR | USD | reference | 1.1181 |
77
- | EUR | ZAR | reference | 18.4945 |
56
+ | EUR | GBP | reference | 0.84385 |
57
+ | EUR | HKD | reference | 8.8316 |
58
+ | EUR | HUF | reference | 363.08 |
59
+ | EUR | IDR | reference | 20290.28 |
60
+ | EUR | ILS | reference | 3.4822 |
61
+ | EUR | INR | reference | 106.864 |
62
+ | EUR | ISK | reference | 136.2 |
63
+ | EUR | JPY | reference | 177.82 |
64
+ | EUR | KRW | reference | 1499.01 |
65
+ | EUR | MXN | reference | 20.6871 |
66
+ | EUR | MYR | reference | 4.5929 |
67
+ | EUR | NOK | reference | 10.624 |
68
+ | EUR | NZD | reference | 1.9868 |
69
+ | EUR | PHP | reference | 70.858 |
70
+ | EUR | PLN | reference | 4.37 |
71
+ | EUR | RON | reference | 5.331 |
72
+ | EUR | SEK | reference | 11.145 |
73
+ | EUR | SGD | reference | 1.4395 |
74
+ | EUR | THB | reference | 37.602 |
75
+ | EUR | TRY | reference | 55.7328 |
76
+ | EUR | USD | reference | 1.1253 |
77
+ | EUR | ZAR | reference | 18.493 |
78
78
 
79
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.
80
80
  <!-- daily-table:end -->
@@ -131,10 +131,10 @@ const pair = await getRate('EUR', 'USD', { apiKey: 'art_live_...' });
131
131
  {
132
132
  bank: 'bnb',
133
133
  name: 'Bulgarian National Bank',
134
- rate_date: '2026-10-12', // Bulgarian National Bank's own publication date
134
+ rate_date: '2026-10-13', // Bulgarian National Bank's own publication date
135
135
  source: 'EUR',
136
136
  target: 'USD',
137
- rate: 1.1181,
137
+ rate: 1.1188,
138
138
  rate_type: 'reference',
139
139
  derived: false,
140
140
  method: 'published',
@@ -159,9 +159,9 @@ console.log(table.rate_date, table.rates.length);
159
159
  {
160
160
  bank: 'bnb',
161
161
  name: 'Bulgarian National Bank',
162
- rate_date: '2026-10-12',
162
+ rate_date: '2026-10-13',
163
163
  rates: [
164
- { "base": "EUR", "quote": "USD", "type": "reference", "value": 1.1181 },
164
+ { "base": "EUR", "quote": "USD", "type": "reference", "value": 1.1188 },
165
165
  // … the rest of the published table (29 currencies vs EUR)
166
166
  ],
167
167
  disclaimer: '…'
@@ -201,7 +201,7 @@ Paid plans. One resolved rate per publication date — ready for charting, reval
201
201
  import { getHistory } from '@allratestoday/bnb-exchange-rate';
202
202
 
203
203
  const series = await getHistory(
204
- { source: 'EUR', target: 'USD', from: '2026-01-01', to: '2026-10-12' },
204
+ { source: 'EUR', target: 'USD', from: '2026-01-01', to: '2026-10-13' },
205
205
  { apiKey: 'art_live_...' }
206
206
  );
207
207
  ```
@@ -214,11 +214,11 @@ const series = await getHistory(
214
214
  source: 'EUR',
215
215
  target: 'USD',
216
216
  from: '2026-01-01',
217
- to: '2026-10-12',
217
+ to: '2026-10-13',
218
218
  count: 152,
219
219
  rates: [
220
220
  // one entry per publication date
221
- { date: '2026-10-12', rate: 1.1181, rate_type: 'reference', derived: false, method: 'published' },
221
+ { date: '2026-10-13', rate: 1.1188, rate_type: 'reference', derived: false, method: 'published' },
222
222
  // …
223
223
  ],
224
224
  disclaimer: '…'
@@ -268,7 +268,7 @@ curl "https://allratestoday.com/api/v1/central-bank/bnb/latest?format=xml&api_ke
268
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
269
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
270
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`
271
+ - 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`
272
272
  - Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) · [for-ai-agents](https://allratestoday.com/for-ai-agents/)
273
273
 
274
274
  ## ⚖️ Published vs derived rates
@@ -337,9 +337,9 @@ getRate('EUR', 'USD', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
337
337
 
338
338
  Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
339
339
 
340
- - 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`)
341
341
  - Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
342
- - 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`
343
343
 
344
344
  ## 🔗 Links
345
345
 
package/package.json CHANGED
@@ -1,18 +1,28 @@
1
1
  {
2
2
  "name": "@allratestoday/bnb-exchange-rate",
3
- "version": "1.3.9",
3
+ "version": "1.3.14",
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",