bcra-exchange-rate 1.2.0 → 1.3.0

package/README.md

@@ -16,6 +16,8 @@
 - 🔷 **Type-safe** — full TypeScript definitions shipped with the package
 - 🧾 **Compliance-grade metadata** — `rate_type`, publication date, and source disclaimer on every response
 
+> **Official rate, not mid-market:** every value here is a number Central Bank of Argentina itself published, fixed once printed and carrying the central bank's own `rate_date` — what filings and audits require. Need the live interbank midpoint for pricing or display instead? Use the [mid-market API](https://allratestoday.com/docs/) or [`@allratestoday/sdk`](https://www.npmjs.com/package/@allratestoday/sdk). The two can diverge by several percent.
+
 ## 🔑 Get your API key
 
 Get a free API key at [allratestoday.com/register](https://allratestoday.com/register) — no credit card required. Latest rates are on every plan, including free.
@@ -68,10 +70,10 @@ const pair = await getRate('USD', 'ARS', { apiKey: 'art_live_...' });
 {
   bank: 'bcra',
   name: 'Central Bank of Argentina',
-  rate_date: '2026-08-10',   // Central Bank of Argentina's own publication date
+  rate_date: '2026-09-08',   // Central Bank of Argentina's own publication date
   source: 'USD',
   target: 'ARS',
-  rate: 1495.5,
+  rate: 1512,
   rate_type: 'reference',
   derived: false,
   method: 'published',
@@ -96,9 +98,9 @@ console.log(table.rate_date, table.rates.length);
 {
   bank: 'bcra',
   name: 'Central Bank of Argentina',
-  rate_date: '2026-08-10',
+  rate_date: '2026-09-08',
   rates: [
-    { "base": "USD", "quote": "ARS", "type": "reference", "value": 1495.5 },
+    { "base": "USD", "quote": "ARS", "type": "reference", "value": 1512 },
     // … the rest of the published table (35 currencies vs ARS)
   ],
   disclaimer: '…'
@@ -138,7 +140,7 @@ Paid plans. One resolved rate per publication date — ready for charting, reval
 import { getHistory } from 'bcra-exchange-rate';
 
 const series = await getHistory(
-  { source: 'USD', target: 'ARS', from: '2026-01-01', to: '2026-08-10' },
+  { source: 'USD', target: 'ARS', from: '2026-01-01', to: '2026-09-08' },
   { apiKey: 'art_live_...' }
 );
 ```
@@ -151,11 +153,11 @@ const series = await getHistory(
   source: 'USD',
   target: 'ARS',
   from: '2026-01-01',
-  to: '2026-08-10',
+  to: '2026-09-08',
   count: 152,
   rates: [
     // one entry per publication date
-    { date: '2026-08-10', rate: 1495.5, rate_type: 'reference', derived: false, method: 'published' },
+    { date: '2026-09-08', rate: 1512, rate_type: 'reference', derived: false, method: 'published' },
     // …
   ],
   disclaimer: '…'
@@ -168,9 +170,9 @@ Pass `{ symbol: 'USD' }` instead of `source`/`target` to get the raw published r
 
 ## 🗺️ Currencies covered
 
-Central Bank of Argentina currently publishes rates covering **36 currencies** (as of the latest table):
+Central Bank of Argentina currently publishes rates covering **35 currencies** against the ARS (as of the latest table):
 
-`ARS` · `AUD` · `AWG` · `BOB` · `BRL` · `CAD` · `CHF` · `CLP` · `CNH` · `CNY` · `COP` · `CZK` · `DKK` · `EUR` · `GBP` · `HKD` · `ILS` · `INR` · `JPY` · `MXP` · `NIO` · `NOK` · `NZD` · `PEN` · `PYG` · `RSD` · `RUB` · `SEK` · `SGD` · `TRY` · `USD` · `UYU` · `VEB` · `VND` · `XDR` · `ZAR`
+🇦🇺 `AUD` · 🇦🇼 `AWG` · 🇧🇴 `BOB` · 🇧🇷 `BRL` · 🇨🇦 `CAD` · 🇨🇭 `CHF` · 🇨🇱 `CLP` · 🇨🇳 `CNH` · 🇨🇳 `CNY` · 🇨🇴 `COP` · 🇨🇿 `CZK` · 🇩🇰 `DKK` · 🇪🇺 `EUR` · 🇬🇧 `GBP` · 🇭🇰 `HKD` · 🇮🇱 `ILS` · 🇮🇳 `INR` · 🇯🇵 `JPY` · 🇲🇽 `MXP` · 🇳🇮 `NIO` · 🇳🇴 `NOK` · 🇳🇿 `NZD` · 🇵🇪 `PEN` · 🇵🇾 `PYG` · 🇷🇸 `RSD` · 🇷🇺 `RUB` · 🇸🇪 `SEK` · 🇸🇬 `SGD` · 🇹🇷 `TRY` · 🇺🇸 `USD` · 🇺🇾 `UYU` · 🇻🇪 `VEB` · 🇻🇳 `VND` · `XDR` · 🇿🇦 `ZAR`
 
 ## ⚖️ Published vs derived rates
 
@@ -234,6 +236,14 @@ getRate('USD', 'ARS', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
 | `getRatesForDate(date, { apiKey, source?, target? })` | Paid | The official table (or one pair) for a YYYY-MM-DD date |
 | `getHistory({ symbol \| source+target, from?, to? }, { apiKey })` | Paid | Daily series since 2000 |
 
+## 📥 Bulk data (no key)
+
+Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
+
+- Hugging Face: [AllRates/central-bank-exchange-rates](https://huggingface.co/datasets/AllRates/central-bank-exchange-rates) — one CSV per institution (`rates/bcra.csv`)
+- Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
+- CDN JSON: `https://cdn.jsdelivr.net/gh/AllRates-Today/central-bank-exchange-rates@main/data/bcra/latest.json`
+
 ## 🔗 Links
 
 - [Central Bank of Argentina rates page](https://allratestoday.com/central-bank-rates-api/bcra/) — live table, publication cadence, FAQ

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bcra-exchange-rate",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Official Central Bank of Argentina (Argentina) daily exchange rates — 35 currencies vs ARS, history since 2000. Zero-dependency Node.js/TypeScript client.",
   "keywords": [
     "bcra",