bna-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.
Files changed (2) hide show
  1. package/README.md +17 -9
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -70,10 +70,10 @@ const pair = await getRate('USD', 'AOA', { apiKey: 'art_live_...' });
70
70
  {
71
71
  bank: 'bna',
72
72
  name: 'National Bank of Angola',
73
- rate_date: '2026-08-21', // National Bank of Angola's own publication date
73
+ rate_date: '2026-09-09', // National Bank of Angola's own publication date
74
74
  source: 'USD',
75
75
  target: 'AOA',
76
- rate: 912.799,
76
+ rate: 912.843,
77
77
  rate_type: 'reference',
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: 'bna',
100
100
  name: 'National Bank of Angola',
101
- rate_date: '2026-08-21',
101
+ rate_date: '2026-09-09',
102
102
  rates: [
103
- { "base": "USD", "quote": "AOA", "type": "reference", "value": 912.799 },
104
- { "base": "USD", "quote": "AOA", "type": "sell", "value": 912.799 },
105
- { "base": "USD", "quote": "AOA", "type": "buy", "value": 912.799 },
103
+ { "base": "USD", "quote": "AOA", "type": "reference", "value": 912.843 },
104
+ { "base": "USD", "quote": "AOA", "type": "sell", "value": 912.843 },
105
+ { "base": "USD", "quote": "AOA", "type": "buy", "value": 912.843 },
106
106
  // … the rest of the published table (70 currencies vs AOA)
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 'bna-exchange-rate';
143
143
 
144
144
  const series = await getHistory(
145
- { source: 'USD', target: 'AOA', from: '2026-01-01', to: '2026-08-21' },
145
+ { source: 'USD', target: 'AOA', 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: 'AOA',
157
157
  from: '2026-01-01',
158
- to: '2026-08-21',
158
+ to: '2026-09-09',
159
159
  count: 152,
160
160
  rates: [
161
161
  // one entry per publication date
162
- { date: '2026-08-21', rate: 912.799, rate_type: 'reference', derived: false, method: 'published' },
162
+ { date: '2026-09-09', rate: 912.843, rate_type: 'reference', derived: false, method: 'published' },
163
163
  // …
164
164
  ],
165
165
  disclaimer: '…'
@@ -238,6 +238,14 @@ getRate('USD', 'AOA', { 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 1999 |
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/bna.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/bna/latest.json`
248
+
241
249
  ## 🔗 Links
242
250
 
243
251
  - [National Bank of Angola rates page](https://allratestoday.com/central-bank-rates-api/bna/) — live table, publication cadence, FAQ
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bna-exchange-rate",
3
- "version": "1.2.7",
3
+ "version": "1.3.0",
4
4
  "description": "Official National Bank of Angola (Angola) daily exchange rates — 70 currencies vs AOA, history since 1999. Zero-dependency Node.js/TypeScript client.",
5
5
  "keywords": [
6
6
  "bna",