cbn-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 +19 -11
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -70,10 +70,10 @@ const pair = await getRate('USD', 'NGN', { apiKey: 'art_live_...' });
|
|
|
70
70
|
{
|
|
71
71
|
bank: 'cbn',
|
|
72
72
|
name: 'Central Bank of Nigeria',
|
|
73
|
-
rate_date: '2026-
|
|
73
|
+
rate_date: '2026-09-09', // Central Bank of Nigeria's own publication date
|
|
74
74
|
source: 'USD',
|
|
75
75
|
target: 'NGN',
|
|
76
|
-
rate:
|
|
76
|
+
rate: 1328.7129,
|
|
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: 'cbn',
|
|
100
100
|
name: 'Central Bank of Nigeria',
|
|
101
|
-
rate_date: '2026-
|
|
101
|
+
rate_date: '2026-09-09',
|
|
102
102
|
rates: [
|
|
103
|
-
{ "base": "USD", "quote": "NGN", "type": "middle", "value":
|
|
104
|
-
{ "base": "USD", "quote": "NGN", "type": "sell", "value":
|
|
105
|
-
{ "base": "USD", "quote": "NGN", "type": "buy", "value":
|
|
103
|
+
{ "base": "USD", "quote": "NGN", "type": "middle", "value": 1328.7129 },
|
|
104
|
+
{ "base": "USD", "quote": "NGN", "type": "sell", "value": 1329.2129 },
|
|
105
|
+
{ "base": "USD", "quote": "NGN", "type": "buy", "value": 1328.2129 },
|
|
106
106
|
// … the rest of the published table (13 currencies vs NGN)
|
|
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 'cbn-exchange-rate';
|
|
143
143
|
|
|
144
144
|
const series = await getHistory(
|
|
145
|
-
{ source: 'USD', target: 'NGN', from: '2026-01-01', to: '2026-
|
|
145
|
+
{ source: 'USD', target: 'NGN', 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: 'NGN',
|
|
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: 1328.7129, rate_type: 'middle', derived: false, method: 'published' },
|
|
163
163
|
// …
|
|
164
164
|
],
|
|
165
165
|
disclaimer: '…'
|
|
@@ -172,9 +172,9 @@ Pass `{ symbol: 'USD' }` instead of `source`/`target` to get the raw published r
|
|
|
172
172
|
|
|
173
173
|
## 🗺️ Currencies covered
|
|
174
174
|
|
|
175
|
-
Central Bank of Nigeria currently publishes rates covering **
|
|
175
|
+
Central Bank of Nigeria currently publishes rates covering **13 currencies** against the NGN (as of the latest table):
|
|
176
176
|
|
|
177
|
-
`AED` · `CHF` · `CNY` · `DKK` · `EUR` · `GBP` · `JPY` ·
|
|
177
|
+
🇦🇪 `AED` · 🇨🇭 `CHF` · 🇨🇳 `CNY` · 🇩🇰 `DKK` · 🇪🇺 `EUR` · 🇬🇧 `GBP` · 🇯🇵 `JPY` · 🇸🇦 `SAR` · 🇺🇸 `USD` · `XDR` · `XOF` · `XUA` · 🇿🇦 `ZAR`
|
|
178
178
|
|
|
179
179
|
## ⚖️ Published vs derived rates
|
|
180
180
|
|
|
@@ -238,6 +238,14 @@ getRate('USD', 'NGN', { 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 2001 |
|
|
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/cbn.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/cbn/latest.json`
|
|
248
|
+
|
|
241
249
|
## 🔗 Links
|
|
242
250
|
|
|
243
251
|
- [Central Bank of Nigeria rates page](https://allratestoday.com/central-bank-rates-api/cbn/) — live table, publication cadence, FAQ
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "cbn-exchange-rate",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.3.0",
|
|
4
4
|
"description": "Official Central Bank of Nigeria (Nigeria) daily exchange rates — 13 currencies vs NGN, history since 2001. Zero-dependency Node.js/TypeScript client.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"cbn",
|