banguat-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('USD', 'GTQ', { apiKey: 'art_live_...' });
|
|
|
70
70
|
{
|
|
71
71
|
bank: 'banguat',
|
|
72
72
|
name: 'Banco de Guatemala',
|
|
73
|
-
rate_date: '2026-
|
|
73
|
+
rate_date: '2026-09-09', // Banco de Guatemala's own publication date
|
|
74
74
|
source: 'USD',
|
|
75
75
|
target: 'GTQ',
|
|
76
|
-
rate: 7.
|
|
76
|
+
rate: 7.6273,
|
|
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: 'banguat',
|
|
100
100
|
name: 'Banco de Guatemala',
|
|
101
|
-
rate_date: '2026-
|
|
101
|
+
rate_date: '2026-09-09',
|
|
102
102
|
rates: [
|
|
103
|
-
{ "base": "USD", "quote": "GTQ", "type": "reference", "value": 7.
|
|
103
|
+
{ "base": "USD", "quote": "GTQ", "type": "reference", "value": 7.6273 },
|
|
104
104
|
// … the rest of the published table (26 currencies vs GTQ)
|
|
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 'banguat-exchange-rate';
|
|
141
141
|
|
|
142
142
|
const series = await getHistory(
|
|
143
|
-
{ source: 'USD', target: 'GTQ', from: '2026-01-01', to: '2026-
|
|
143
|
+
{ source: 'USD', target: 'GTQ', from: '2026-01-01', to: '2026-09-09' },
|
|
144
144
|
{ apiKey: 'art_live_...' }
|
|
145
145
|
);
|
|
146
146
|
```
|
|
@@ -153,11 +153,11 @@ const series = await getHistory(
|
|
|
153
153
|
source: 'USD',
|
|
154
154
|
target: 'GTQ',
|
|
155
155
|
from: '2026-01-01',
|
|
156
|
-
to: '2026-
|
|
156
|
+
to: '2026-09-09',
|
|
157
157
|
count: 152,
|
|
158
158
|
rates: [
|
|
159
159
|
// one entry per publication date
|
|
160
|
-
{ date: '2026-
|
|
160
|
+
{ date: '2026-09-09', rate: 7.6273, 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
|
-
Banco de Guatemala currently publishes rates covering **
|
|
173
|
+
Banco de Guatemala currently publishes rates covering **26 currencies** against the GTQ (as of the latest table):
|
|
174
174
|
|
|
175
|
-
`ARS` · `BRL` · `CAD` · `CHF` · `CNY` · `COP` · `CRC` · `DKK` · `DOP` · `EUR` · `GBP` ·
|
|
175
|
+
🇦🇷 `ARS` · 🇧🇷 `BRL` · 🇨🇦 `CAD` · 🇨🇭 `CHF` · 🇨🇳 `CNY` · 🇨🇴 `COP` · 🇨🇷 `CRC` · 🇩🇰 `DKK` · 🇩🇴 `DOP` · 🇪🇺 `EUR` · 🇬🇧 `GBP` · 🇭🇰 `HKD` · 🇭🇳 `HNL` · 🇮🇳 `INR` · 🇯🇵 `JPY` · 🇰🇷 `KRW` · 🇲🇽 `MXN` · 🇲🇾 `MYR` · 🇳🇮 `NIO` · 🇳🇴 `NOK` · 🇵🇰 `PKR` · 🇸🇪 `SEK` · 🇸🇻 `SVC` · 🇹🇼 `TWD` · 🇺🇸 `USD` · `XDR`
|
|
176
176
|
|
|
177
177
|
## ⚖️ Published vs derived rates
|
|
178
178
|
|
|
@@ -236,6 +236,14 @@ getRate('USD', 'GTQ', { 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/banguat.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/banguat/latest.json`
|
|
246
|
+
|
|
239
247
|
## 🔗 Links
|
|
240
248
|
|
|
241
249
|
- [Banco de Guatemala rates page](https://allratestoday.com/central-bank-rates-api/banguat/) — live table, publication cadence, FAQ
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "banguat-exchange-rate",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.3.0",
|
|
4
4
|
"description": "Official Banco de Guatemala (Guatemala) daily exchange rates — 26 currencies vs GTQ, history since 2004. Zero-dependency Node.js/TypeScript client.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"banguat",
|