bct-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 +15 -7
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -70,10 +70,10 @@ const pair = await getRate('USD', 'TND', { apiKey: 'art_live_...' });
70
70
  {
71
71
  bank: 'bct',
72
72
  name: 'Central Bank of Tunisia',
73
- rate_date: '2026-08-20', // Central Bank of Tunisia's own publication date
73
+ rate_date: '2026-09-08', // Central Bank of Tunisia's own publication date
74
74
  source: 'USD',
75
75
  target: 'TND',
76
- rate: 2.9036,
76
+ rate: 2.9158,
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: 'bct',
100
100
  name: 'Central Bank of Tunisia',
101
- rate_date: '2026-08-20',
101
+ rate_date: '2026-09-08',
102
102
  rates: [
103
- { "base": "USD", "quote": "TND", "type": "reference", "value": 2.9036 },
103
+ { "base": "USD", "quote": "TND", "type": "reference", "value": 2.9158 },
104
104
  // … the rest of the published table (20 currencies vs TND)
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 'bct-exchange-rate';
141
141
 
142
142
  const series = await getHistory(
143
- { source: 'USD', target: 'TND', from: '2026-01-01', to: '2026-08-20' },
143
+ { source: 'USD', target: 'TND', 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: 'USD',
154
154
  target: 'TND',
155
155
  from: '2026-01-01',
156
- to: '2026-08-20',
156
+ to: '2026-09-08',
157
157
  count: 152,
158
158
  rates: [
159
159
  // one entry per publication date
160
- { date: '2026-08-20', rate: 2.9036, rate_type: 'reference', derived: false, method: 'published' },
160
+ { date: '2026-09-08', rate: 2.9158, rate_type: 'reference', derived: false, method: 'published' },
161
161
  // …
162
162
  ],
163
163
  disclaimer: '…'
@@ -236,6 +236,14 @@ getRate('USD', 'TND', { 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 2004 |
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/bct.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/bct/latest.json`
246
+
239
247
  ## 🔗 Links
240
248
 
241
249
  - [Central Bank of Tunisia rates page](https://allratestoday.com/central-bank-rates-api/bct/) — live table, publication cadence, FAQ
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bct-exchange-rate",
3
- "version": "1.2.7",
3
+ "version": "1.3.0",
4
4
  "description": "Official Central Bank of Tunisia (Tunisia) daily exchange rates — 20 currencies vs TND, history since 2004. Zero-dependency Node.js/TypeScript client.",
5
5
  "keywords": [
6
6
  "bct",