boe-exchange-rate 1.2.2 → 1.3.0
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.
- package/README.md +17 -9
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -70,10 +70,10 @@ const pair = await getRate('GBP', 'USD', { apiKey: 'art_live_...' });
|
|
|
70
70
|
{
|
|
71
71
|
bank: 'boe',
|
|
72
72
|
name: 'Bank of England',
|
|
73
|
-
rate_date: '2026-08
|
|
73
|
+
rate_date: '2026-09-08', // Bank of England's own publication date
|
|
74
74
|
source: 'GBP',
|
|
75
75
|
target: 'USD',
|
|
76
|
-
rate: 1.
|
|
76
|
+
rate: 1.3553,
|
|
77
77
|
rate_type: 'reference',
|
|
78
78
|
derived: false,
|
|
79
79
|
method: 'published',
|
|
@@ -98,9 +98,9 @@ console.log(table.rate_date, table.rates.length);
|
|
|
98
98
|
{
|
|
99
99
|
bank: 'boe',
|
|
100
100
|
name: 'Bank of England',
|
|
101
|
-
rate_date: '2026-08
|
|
101
|
+
rate_date: '2026-09-08',
|
|
102
102
|
rates: [
|
|
103
|
-
{ "base": "GBP", "quote": "USD", "type": "reference", "value": 1.
|
|
103
|
+
{ "base": "GBP", "quote": "USD", "type": "reference", "value": 1.3553 },
|
|
104
104
|
// … the rest of the published table (23 currencies vs GBP)
|
|
105
105
|
],
|
|
106
106
|
disclaimer: '…'
|
|
@@ -140,7 +140,7 @@ Paid plans. One resolved rate per publication date — ready for charting, reval
|
|
|
140
140
|
import { getHistory } from 'boe-exchange-rate';
|
|
141
141
|
|
|
142
142
|
const series = await getHistory(
|
|
143
|
-
{ source: 'GBP', target: 'USD', from: '2026-01-01', to: '2026-08
|
|
143
|
+
{ source: 'GBP', target: 'USD', from: '2026-01-01', to: '2026-09-08' },
|
|
144
144
|
{ apiKey: 'art_live_...' }
|
|
145
145
|
);
|
|
146
146
|
```
|
|
@@ -153,11 +153,11 @@ const series = await getHistory(
|
|
|
153
153
|
source: 'GBP',
|
|
154
154
|
target: 'USD',
|
|
155
155
|
from: '2026-01-01',
|
|
156
|
-
to: '2026-08
|
|
156
|
+
to: '2026-09-08',
|
|
157
157
|
count: 152,
|
|
158
158
|
rates: [
|
|
159
159
|
// one entry per publication date
|
|
160
|
-
{ date: '2026-08
|
|
160
|
+
{ date: '2026-09-08', rate: 1.3553, rate_type: 'reference', derived: false, method: 'published' },
|
|
161
161
|
// …
|
|
162
162
|
],
|
|
163
163
|
disclaimer: '…'
|
|
@@ -170,9 +170,9 @@ Pass `{ symbol: 'USD' }` instead of `source`/`target` to get the raw published r
|
|
|
170
170
|
|
|
171
171
|
## 🗺️ Currencies covered
|
|
172
172
|
|
|
173
|
-
Bank of England currently publishes rates covering **
|
|
173
|
+
Bank of England currently publishes rates covering **23 currencies** against the GBP (as of the latest table):
|
|
174
174
|
|
|
175
|
-
`AUD` · `CAD` · `CHF` · `CNY` · `DKK` · `EUR` ·
|
|
175
|
+
🇦🇺 `AUD` · 🇨🇦 `CAD` · 🇨🇭 `CHF` · 🇨🇳 `CNY` · 🇩🇰 `DKK` · 🇪🇺 `EUR` · 🇭🇰 `HKD` · 🇮🇱 `ILS` · 🇮🇳 `INR` · 🇯🇵 `JPY` · 🇰🇷 `KRW` · 🇲🇾 `MYR` · 🇳🇴 `NOK` · 🇳🇿 `NZD` · 🇵🇱 `PLN` · 🇸🇦 `SAR` · 🇸🇪 `SEK` · 🇸🇬 `SGD` · 🇹🇭 `THB` · 🇹🇷 `TRY` · 🇹🇼 `TWD` · 🇺🇸 `USD` · 🇿🇦 `ZAR`
|
|
176
176
|
|
|
177
177
|
## ⚖️ Published vs derived rates
|
|
178
178
|
|
|
@@ -236,6 +236,14 @@ getRate('GBP', 'USD', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
|
|
|
236
236
|
| `getRatesForDate(date, { apiKey, source?, target? })` | Paid | The official table (or one pair) for a YYYY-MM-DD date |
|
|
237
237
|
| `getHistory({ symbol \| source+target, from?, to? }, { apiKey })` | Paid | Daily series since 2016 |
|
|
238
238
|
|
|
239
|
+
## 📥 Bulk data (no key)
|
|
240
|
+
|
|
241
|
+
Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
|
|
242
|
+
|
|
243
|
+
- Hugging Face: [AllRates/central-bank-exchange-rates](https://huggingface.co/datasets/AllRates/central-bank-exchange-rates) — one CSV per institution (`rates/boe.csv`)
|
|
244
|
+
- Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
|
|
245
|
+
- CDN JSON: `https://cdn.jsdelivr.net/gh/AllRates-Today/central-bank-exchange-rates@main/data/boe/latest.json`
|
|
246
|
+
|
|
239
247
|
## 🔗 Links
|
|
240
248
|
|
|
241
249
|
- [Bank of England rates page](https://allratestoday.com/central-bank-rates-api/boe/) — live table, publication cadence, FAQ
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "boe-exchange-rate",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.3.0",
|
|
4
4
|
"description": "Official Bank of England (United Kingdom) daily exchange rates — 23 currencies vs GBP, history since 2016. Zero-dependency Node.js/TypeScript client.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"boe",
|