bcrp-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 +18 -10
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -70,10 +70,10 @@ const pair = await getRate('USD', 'PEN', { apiKey: 'art_live_...' });
|
|
|
70
70
|
{
|
|
71
71
|
bank: 'bcrp',
|
|
72
72
|
name: 'Central Reserve Bank of Peru',
|
|
73
|
-
rate_date: '2026-
|
|
73
|
+
rate_date: '2026-09-07', // Central Reserve Bank of Peru's own publication date
|
|
74
74
|
source: 'USD',
|
|
75
75
|
target: 'PEN',
|
|
76
|
-
rate: 3.
|
|
76
|
+
rate: 3.372,
|
|
77
77
|
rate_type: 'sell',
|
|
78
78
|
derived: false,
|
|
79
79
|
method: 'published',
|
|
@@ -98,10 +98,10 @@ console.log(table.rate_date, table.rates.length);
|
|
|
98
98
|
{
|
|
99
99
|
bank: 'bcrp',
|
|
100
100
|
name: 'Central Reserve Bank of Peru',
|
|
101
|
-
rate_date: '2026-
|
|
101
|
+
rate_date: '2026-09-07',
|
|
102
102
|
rates: [
|
|
103
|
-
{ "base": "USD", "quote": "PEN", "type": "sell", "value": 3.
|
|
104
|
-
{ "base": "USD", "quote": "PEN", "type": "buy", "value": 3.
|
|
103
|
+
{ "base": "USD", "quote": "PEN", "type": "sell", "value": 3.372 },
|
|
104
|
+
{ "base": "USD", "quote": "PEN", "type": "buy", "value": 3.351 },
|
|
105
105
|
// … the rest of the published table (2 currencies vs PEN)
|
|
106
106
|
],
|
|
107
107
|
disclaimer: '…'
|
|
@@ -141,7 +141,7 @@ Paid plans. One resolved rate per publication date — ready for charting, reval
|
|
|
141
141
|
import { getHistory } from 'bcrp-exchange-rate';
|
|
142
142
|
|
|
143
143
|
const series = await getHistory(
|
|
144
|
-
{ source: 'USD', target: 'PEN', from: '2026-01-01', to: '2026-
|
|
144
|
+
{ source: 'USD', target: 'PEN', from: '2026-01-01', to: '2026-09-07' },
|
|
145
145
|
{ apiKey: 'art_live_...' }
|
|
146
146
|
);
|
|
147
147
|
```
|
|
@@ -154,11 +154,11 @@ const series = await getHistory(
|
|
|
154
154
|
source: 'USD',
|
|
155
155
|
target: 'PEN',
|
|
156
156
|
from: '2026-01-01',
|
|
157
|
-
to: '2026-
|
|
157
|
+
to: '2026-09-07',
|
|
158
158
|
count: 152,
|
|
159
159
|
rates: [
|
|
160
160
|
// one entry per publication date
|
|
161
|
-
{ date: '2026-
|
|
161
|
+
{ date: '2026-09-07', rate: 3.372, rate_type: 'sell', derived: false, method: 'published' },
|
|
162
162
|
// …
|
|
163
163
|
],
|
|
164
164
|
disclaimer: '…'
|
|
@@ -171,9 +171,9 @@ Pass `{ symbol: 'USD' }` instead of `source`/`target` to get the raw published r
|
|
|
171
171
|
|
|
172
172
|
## 🗺️ Currencies covered
|
|
173
173
|
|
|
174
|
-
Central Reserve Bank of Peru currently publishes rates covering **
|
|
174
|
+
Central Reserve Bank of Peru currently publishes rates covering **2 currencies** against the PEN (as of the latest table):
|
|
175
175
|
|
|
176
|
-
`EUR` ·
|
|
176
|
+
🇪🇺 `EUR` · 🇺🇸 `USD`
|
|
177
177
|
|
|
178
178
|
## ⚖️ Published vs derived rates
|
|
179
179
|
|
|
@@ -237,6 +237,14 @@ getRate('USD', 'PEN', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
|
|
|
237
237
|
| `getRatesForDate(date, { apiKey, source?, target? })` | Paid | The official table (or one pair) for a YYYY-MM-DD date |
|
|
238
238
|
| `getHistory({ symbol \| source+target, from?, to? }, { apiKey })` | Paid | Daily series since 2016 |
|
|
239
239
|
|
|
240
|
+
## 📥 Bulk data (no key)
|
|
241
|
+
|
|
242
|
+
Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
|
|
243
|
+
|
|
244
|
+
- Hugging Face: [AllRates/central-bank-exchange-rates](https://huggingface.co/datasets/AllRates/central-bank-exchange-rates) — one CSV per institution (`rates/bcrp.csv`)
|
|
245
|
+
- Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
|
|
246
|
+
- CDN JSON: `https://cdn.jsdelivr.net/gh/AllRates-Today/central-bank-exchange-rates@main/data/bcrp/latest.json`
|
|
247
|
+
|
|
240
248
|
## 🔗 Links
|
|
241
249
|
|
|
242
250
|
- [Central Reserve Bank of Peru rates page](https://allratestoday.com/central-bank-rates-api/bcrp/) — live table, publication cadence, FAQ
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "bcrp-exchange-rate",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.3.0",
|
|
4
4
|
"description": "Official Central Reserve Bank of Peru (Peru) daily exchange rates — 2 currencies vs PEN, history since 2016. Zero-dependency Node.js/TypeScript client.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"bcrp",
|