boz-exchange-rate 1.2.7 → 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('USD', 'ZMW', { apiKey: 'art_live_...' });
|
|
|
70
70
|
{
|
|
71
71
|
bank: 'boz',
|
|
72
72
|
name: 'Bank of Zambia',
|
|
73
|
-
rate_date: '2026-
|
|
73
|
+
rate_date: '2026-09-09', // Bank of Zambia's own publication date
|
|
74
74
|
source: 'USD',
|
|
75
75
|
target: 'ZMW',
|
|
76
|
-
rate: 19.
|
|
76
|
+
rate: 19.2646,
|
|
77
77
|
rate_type: 'middle',
|
|
78
78
|
derived: false,
|
|
79
79
|
method: 'published',
|
|
@@ -98,11 +98,11 @@ console.log(table.rate_date, table.rates.length);
|
|
|
98
98
|
{
|
|
99
99
|
bank: 'boz',
|
|
100
100
|
name: 'Bank of Zambia',
|
|
101
|
-
rate_date: '2026-
|
|
101
|
+
rate_date: '2026-09-09',
|
|
102
102
|
rates: [
|
|
103
|
-
{ "base": "USD", "quote": "ZMW", "type": "middle", "value": 19.
|
|
104
|
-
{ "base": "USD", "quote": "ZMW", "type": "sell", "value": 19.
|
|
105
|
-
{ "base": "USD", "quote": "ZMW", "type": "buy", "value":
|
|
103
|
+
{ "base": "USD", "quote": "ZMW", "type": "middle", "value": 19.2646 },
|
|
104
|
+
{ "base": "USD", "quote": "ZMW", "type": "sell", "value": 19.2896 },
|
|
105
|
+
{ "base": "USD", "quote": "ZMW", "type": "buy", "value": 19.2396 },
|
|
106
106
|
// … the rest of the published table (2 currencies vs ZMW)
|
|
107
107
|
],
|
|
108
108
|
disclaimer: '…'
|
|
@@ -142,7 +142,7 @@ Paid plans. One resolved rate per publication date — ready for charting, reval
|
|
|
142
142
|
import { getHistory } from 'boz-exchange-rate';
|
|
143
143
|
|
|
144
144
|
const series = await getHistory(
|
|
145
|
-
{ source: 'USD', target: 'ZMW', from: '2026-01-01', to: '2026-
|
|
145
|
+
{ source: 'USD', target: 'ZMW', from: '2026-01-01', to: '2026-09-09' },
|
|
146
146
|
{ apiKey: 'art_live_...' }
|
|
147
147
|
);
|
|
148
148
|
```
|
|
@@ -155,11 +155,11 @@ const series = await getHistory(
|
|
|
155
155
|
source: 'USD',
|
|
156
156
|
target: 'ZMW',
|
|
157
157
|
from: '2026-01-01',
|
|
158
|
-
to: '2026-
|
|
158
|
+
to: '2026-09-09',
|
|
159
159
|
count: 152,
|
|
160
160
|
rates: [
|
|
161
161
|
// one entry per publication date
|
|
162
|
-
{ date: '2026-
|
|
162
|
+
{ date: '2026-09-09', rate: 19.2646, rate_type: 'middle', derived: false, method: 'published' },
|
|
163
163
|
// …
|
|
164
164
|
],
|
|
165
165
|
disclaimer: '…'
|
|
@@ -238,6 +238,14 @@ getRate('USD', 'ZMW', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
|
|
|
238
238
|
| `getRatesForDate(date, { apiKey, source?, target? })` | Paid | The official table (or one pair) for a YYYY-MM-DD date |
|
|
239
239
|
| `getHistory({ symbol \| source+target, from?, to? }, { apiKey })` | Paid | Daily series since 2026 |
|
|
240
240
|
|
|
241
|
+
## 📥 Bulk data (no key)
|
|
242
|
+
|
|
243
|
+
Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
|
|
244
|
+
|
|
245
|
+
- Hugging Face: [AllRates/central-bank-exchange-rates](https://huggingface.co/datasets/AllRates/central-bank-exchange-rates) — one CSV per institution (`rates/boz.csv`)
|
|
246
|
+
- Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
|
|
247
|
+
- CDN JSON: `https://cdn.jsdelivr.net/gh/AllRates-Today/central-bank-exchange-rates@main/data/boz/latest.json`
|
|
248
|
+
|
|
241
249
|
## 🔗 Links
|
|
242
250
|
|
|
243
251
|
- [Bank of Zambia rates page](https://allratestoday.com/central-bank-rates-api/boz/) — live table, publication cadence, FAQ
|
package/package.json
CHANGED