npm - @allratestoday/sama-exchange-rate - Versions diffs - 1.3.19 → 1.3.22 - Mend

@allratestoday/sama-exchange-rate 1.3.19 → 1.3.22

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

package/README.md +80 -44
package/package.json +2 -2

package/README.md CHANGED Viewed

@@ -7,7 +7,7 @@
 [![EUR/SAR today](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fallratestoday.com%2Fapi%2Fopen%2Fcentral-bank%2Fsama%3Fsource%3DEUR%26target%3DSAR&query=%24.rate&label=EUR%2FSAR%20published%20by%20Saudi%20Central%20Bank%20(SAMA)&color=0A7E8C&cacheSeconds=3600)](https://allratestoday.com/central-bank-rates-api/sama/)
 [![rate date](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fallratestoday.com%2Fapi%2Fopen%2Fcentral-bank%2Fsama%3Fsource%3DEUR%26target%3DSAR&query=%24.rate_date&label=rate%20date&color=555&cacheSeconds=3600)](https://allratestoday.com/central-bank-rates-api/sama/)
-**Official Saudi Central Bank (SAMA) (Saudi Arabia) monthly exchange rates for Node.js and TypeScript. The published central bank rates behind tax filings, customs valuations, audits, and compliant invoicing — not market estimates, but the numbers Saudi Central Bank (SAMA) itself prints, every month.**
+**Official Saudi Central Bank (SAMA) (Saudi Arabia) daily exchange rates for Node.js and TypeScript. The published central bank rates behind tax filings, customs valuations, audits, and compliant invoicing — not market estimates, but the numbers Saudi Central Bank (SAMA) itself prints, every business day.**
 ## 🚀 Why this client?
@@ -47,38 +47,74 @@ The image is rendered live from the keyless endpoint above, so it follows the ce
 <!-- daily-table:start -->
 <details>
-<summary>Table as text: published 2026-07-31 by Saudi Central Bank (SAMA) (the API currently flags this table as stale) — 24 rates. Updated 2026-10-27.</summary>
+<summary>Table as text: published 2026-10-28 by Saudi Central Bank (SAMA) — 66 rates, first 60 shown. Updated 2026-10-29.</summary>
 | Base | Quote | Type | Rate |
 | --- | --- | --- | ---: |
-| AUD | SAR | close | 2.6305805 |
-| AUD | SAR | monthly_average | 2.6118306 |
-| BRL | SAR | close | 0.73916558 |
-| BRL | SAR | monthly_average | 0.73401057 |
-| CHF | SAR | close | 4.6253694 |
-| CHF | SAR | monthly_average | 4.6229663 |
-| CNY | SAR | close | 0.55461841 |
-| CNY | SAR | monthly_average | 0.55337878 |
-| EUR | SAR | close | 4.2976014 |
-| EUR | SAR | monthly_average | 4.2804897 |
-| GBP | SAR | close | 5.030462 |
-| GBP | SAR | monthly_average | 5.0133182 |
-| INR | SAR | close | 0.039235708 |
-| INR | SAR | monthly_average | 0.039136208 |
-| JPY | SAR | close | 0.023293968 |
-| JPY | SAR | monthly_average | 0.023059174 |
-| KRW | SAR | close | 0.0025965805 |
-| KRW | SAR | monthly_average | 0.0025093839 |
-| THB | SAR | close | 0.11198406 |
-| THB | SAR | monthly_average | 0.11192007 |
-| TRY | SAR | close | 0.078847735 |
-| TRY | SAR | monthly_average | 0.079760374 |
-| USD | SAR | close | 3.75 |
-| USD | SAR | monthly_average | 3.75 |
+| AED | SAR | reference | 1.02094 |
+| AFN | SAR | reference | 0.05771 |
+| ALL | SAR | reference | 0.04603 |
+| ARS | SAR | reference | 0.00243 |
+| AUD | SAR | reference | 2.63812 |
+| BAM | SAR | reference | 2.13681 |
+| BDT | SAR | reference | 0.03022 |
+| BGN | SAR | reference | 2.13681 |
+| BHD | SAR | reference | 9.9364 |
+| BND | SAR | reference | 2.92762 |
+| BRL | SAR | reference | 0.70221 |
+| CAD | SAR | reference | 2.67141 |
+| CHF | SAR | reference | 4.52515 |
+| CLP | SAR | reference | 0.00382 |
+| CNY | SAR | reference | 0.56239 |
+| COP | SAR | reference | 0.00118 |
+| CUP | SAR | reference | 0.15625 |
+| CZK | SAR | reference | 0.17182 |
+| DJF | SAR | reference | 0.02109 |
+| DKK | SAR | reference | 0.55915 |
+| DZD | SAR | reference | 0.02772 |
+| EGP | SAR | reference | 0.06684 |
+| ETB | SAR | reference | 0.02305 |
+| EUR | SAR | reference | 4.17918 |
+| GBP | SAR | reference | 4.99237 |
+| HKD | SAR | reference | 0.47801 |
+| HUF | SAR | reference | 0.0114 |
+| INR | SAR | reference | 0.03942 |
+| ISK | SAR | reference | 0.03063 |
+| JOD | SAR | reference | 5.28913 |
+| JPY | SAR | reference | 0.02375 |
+| KES | SAR | reference | 0.02886 |
+| KRW | SAR | reference | 0.00283 |
+| KWD | SAR | reference | 12.04625 |
+| LKR | SAR | reference | 0.01127 |
+| LYD | SAR | reference | 0.58387 |
+| MAD | SAR | reference | 0.38059 |
+| MMK | SAR | reference | 0.00178 |
+| MUR | SAR | reference | 0.07919 |
+| MXN | SAR | reference | 0.20119 |
+| MYR | SAR | reference | 0.91709 |
+| NGN | SAR | reference | 0.00275 |
+| NOK | SAR | reference | 0.40185 |
+| NZD | SAR | reference | 2.13487 |
+| OMR | SAR | reference | 9.74025 |
+| PHP | SAR | reference | 0.05842 |
+| PKR | SAR | reference | 0.01355 |
+| PLN | SAR | reference | 0.95057 |
+| QAR | SAR | reference | 1.02993 |
+| RON | SAR | reference | 0.78111 |
+| RUB | SAR | reference | 0.04655 |
+| SEK | SAR | reference | 0.37751 |
+| SGD | SAR | reference | 2.92808 |
+| SOS | SAR | reference | 0.00659 |
+| THB | SAR | reference | 0.11107 |
+| TJS | SAR | reference | 0.40725 |
+| TND | SAR | reference | 1.24642 |
+| TRY | SAR | reference | 0.07532 |
+| TWD | SAR | reference | 0.11546 |
+| TZS | SAR | reference | 0.00141 |
 </details>
-Source: [Official rates published by SAMA, served by AllRatesToday](https://allratestoday.com/central-bank-rates-api/sama/). Rates are as printed by the central bank; AllRatesToday is not affiliated with it.
+[Full table on the Saudi Central Bank (SAMA) rates page](https://allratestoday.com/central-bank-rates-api/sama/) · Source: [Official rates published by SAMA, served by AllRatesToday](https://allratestoday.com/central-bank-rates-api/sama/). Rates are as printed by the central bank; AllRatesToday is not affiliated with it.
 <!-- daily-table:end -->
 ## 📦 Installation
@@ -129,11 +165,11 @@ const pair = await getRate('EUR', 'SAR', { apiKey: 'art_live_...' });
 {
   bank: 'sama',
   name: 'Saudi Central Bank (SAMA)',
-  rate_date: '2026-07-31',   // Saudi Central Bank (SAMA)'s own publication date
+  rate_date: '2026-10-27',   // Saudi Central Bank (SAMA)'s own publication date
   source: 'EUR',
   target: 'SAR',
-  rate: 4.2976014,
-  rate_type: 'close',
+  rate: 4.2015,
+  rate_type: 'reference',
   derived: false,
   method: 'published',
   disclaimer: 'Official rates as published by the named central bank. On weekends/holidays the most recent published rate_date is returned.'
@@ -157,11 +193,10 @@ console.log(table.rate_date, table.rates.length);
 {
   bank: 'sama',
   name: 'Saudi Central Bank (SAMA)',
-  rate_date: '2026-07-31',
+  rate_date: '2026-10-27',
   rates: [
-    { "base": "EUR", "quote": "SAR", "type": "close", "value": 4.2976014 },
-    { "base": "EUR", "quote": "SAR", "type": "monthly_average", "value": 4.2804897 },
-    // … the rest of the published table (12 currencies vs SAR)
+    { "base": "EUR", "quote": "SAR", "type": "reference", "value": 4.2015 },
+    // … the rest of the published table (66 currencies vs SAR)
   ],
   disclaimer: '…'
 }
@@ -200,7 +235,7 @@ Paid plans. One resolved rate per publication date — ready for charting, reval
 import { getHistory } from '@allratestoday/sama-exchange-rate';
 const series = await getHistory(
-  { source: 'EUR', target: 'SAR', from: '2026-01-01', to: '2026-07-31' },
+  { source: 'EUR', target: 'SAR', from: '2026-01-01', to: '2026-10-27' },
   { apiKey: 'art_live_...' }
 );
 ```
@@ -213,11 +248,11 @@ const series = await getHistory(
   source: 'EUR',
   target: 'SAR',
   from: '2026-01-01',
-  to: '2026-07-31',
+  to: '2026-10-27',
   count: 152,
   rates: [
     // one entry per publication date
-    { date: '2026-07-31', rate: 4.2976014, rate_type: 'close', derived: false, method: 'published' },
+    { date: '2026-10-27', rate: 4.2015, rate_type: 'reference', derived: false, method: 'published' },
     // …
   ],
   disclaimer: '…'
@@ -230,16 +265,17 @@ Pass `{ symbol: 'EUR' }` instead of `source`/`target` to get the raw published r
 ## 🗺️ Currencies covered
-Saudi Central Bank (SAMA) currently publishes rates covering **12 currencies** against the SAR (as of the latest table):
+Saudi Central Bank (SAMA) currently publishes rates covering **66 currencies** against the SAR (as of the latest table):
-🇦🇺 `AUD` · 🇧🇷 `BRL` · 🇨🇭 `CHF` · 🇨🇳 `CNY` · 🇪🇺 `EUR` · 🇬🇧 `GBP` · 🇮🇳 `INR` · 🇯🇵 `JPY` · 🇰🇷 `KRW` · 🇹🇭 `THB` · 🇹🇷 `TRY` · 🇺🇸 `USD`
+🇦🇪 `AED` · 🇦🇫 `AFN` · 🇦🇱 `ALL` · 🇦🇷 `ARS` · 🇦🇺 `AUD` · 🇧🇦 `BAM` · 🇧🇩 `BDT` · 🇧🇬 `BGN` · 🇧🇭 `BHD` · 🇧🇳 `BND` · 🇧🇷 `BRL` · 🇨🇦 `CAD` · 🇨🇭 `CHF` · 🇨🇱 `CLP` · 🇨🇳 `CNY` · 🇨🇴 `COP` · 🇨🇺 `CUP` · 🇨🇿 `CZK` · 🇩🇯 `DJF` · 🇩🇰 `DKK` · 🇩🇿 `DZD` · 🇪🇬 `EGP` · 🇪🇹 `ETB` · 🇪🇺 `EUR` · 🇬🇧 `GBP` · 🇭🇰 `HKD` · 🇭🇺 `HUF` · 🇮🇳 `INR` · 🇮🇸 `ISK` · 🇯🇴 `JOD` · 🇯🇵 `JPY` · 🇰🇪 `KES` · 🇰🇷 `KRW` · 🇰🇼 `KWD` · 🇱🇰 `LKR` · 🇱🇾 `LYD` · 🇲🇦 `MAD` · 🇲🇲 `MMK` · 🇲🇺 `MUR` · 🇲🇽 `MXN` · 🇲🇾 `MYR` · 🇳🇬 `NGN` · 🇳🇴 `NOK` · 🇳🇿 `NZD` · 🇴🇲 `OMR` · 🇵🇭 `PHP` · 🇵🇰 `PKR` · 🇵🇱 `PLN` · 🇶🇦 `QAR` · 🇷🇴 `RON` · 🇷🇺 `RUB` · 🇸🇪 `SEK` · 🇸🇬 `SGD` · 🇸🇴 `SOS` · 🇹🇭 `THB` · 🇹🇯 `TJS` · 🇹🇳 `TND` · 🇹🇷 `TRY` · 🇹🇼 `TWD` · 🇹🇿 `TZS` · 🇺🇸 `USD` · `XAF` · `XDR` · `XOF` · 🇾🇪 `YER` · 🇿🇦 `ZAR`
 ## 🏛️ Source
-The Saudi Central Bank (SAMA) publishes riyal exchange rates monthly — period averages and end-of-period values for 12 currencies — with the riyal itself pegged to the US dollar at 3.75 since 1986. SAMA offers no machine-readable feed of its own, so this series is sourced from the KAPSARC open-data mirror of SAMA’s table and typically trails the calendar by about two months.
+The Saudi Central Bank (SAMA) publishes a riyal exchange-rate table every day — 60+ currencies, seven days a week — with the riyal itself pegged to the US dollar at 3.75 since 1986. This series comes straight from SAMA’s own exchange-rate page, with daily history from April 2021 and SAMA’s monthly period averages for 12 currencies back to 2009.
-- Publisher's own page: [Exchange rates — KAPSARC open-data mirror](https://datasource.kapsarc.org/explore/dataset/exchange-rate/) · [www.sama.gov.sa](https://www.sama.gov.sa)
-- Publication: every month; the exact schedule, freshness status and any current delay are on the [Saudi Central Bank (SAMA) rates page](https://allratestoday.com/central-bank-rates-api/sama/)
+- Publisher's own page: [Exchange rates — sama.gov.sa](https://www.sama.gov.sa/en-US/Currency/FinExc/Pages/Currency.aspx) · [www.sama.gov.sa](https://www.sama.gov.sa)
+- Publication: every business day; the exact schedule, freshness status and any current delay are on the [Saudi Central Bank (SAMA) rates page](https://allratestoday.com/central-bank-rates-api/sama/)
+- In the API: usually by **17:15 UTC** (measured over the last 14 publications). Schedule a sync at or after that time and retry hourly until `rate_date` moves; every response carries the same figure as `available_by_utc` — see [when to poll](https://allratestoday.com/docs/#when-to-poll)
 - Values are stored unmodified, with the publisher's own `rate_date` on every row — see the [methodology](https://allratestoday.com/official-rates-methodology/)
 ## 🧭 Reading the numbers
@@ -247,7 +283,7 @@ The Saudi Central Bank (SAMA) publishes riyal exchange rates monthly — period
 - `value` is always **quote currency per 1 unit of base currency** (`base: "EUR", quote: "USD", value: 1.15` means 1 EUR = 1.15 USD).
 - Saudi Central Bank (SAMA) quotes **SAR per 1 unit of foreign currency** (e.g. `base: "USD", quote: "SAR"` means SAR per one US dollar).
 - Need the other way round? Ask `getRate(target, source)` and the API inverts or crosses for you, flagged `derived: true` — never divide a published rate yourself in a compliance workflow.
-- `rate_type` tells you which of the central bank's series a row belongs to (`close` here); some publishers print buy/sell or several fixings for the same pair.
+- `rate_type` tells you which of the central bank's series a row belongs to (`reference` here); some publishers print buy/sell or several fixings for the same pair.
 ## 🧩 ERP & accounting systems
@@ -320,7 +356,7 @@ getRate('EUR', 'SAR', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
 ## 💡 Quota tips
-- Rates change once a month — cache the published table locally and a small monthly quota goes a long way.
+- Rates change once per business day — cache the published table locally and a small monthly quota goes a long way.
 - Every request counts toward your AllRatesToday quota, shared across all AllRatesToday endpoints on your key.
 ## 📖 Methods reference

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@allratestoday/sama-exchange-rate",
-  "version": "1.3.19",
-  "description": "Official Saudi Central Bank (SAMA) (Saudi Arabia) monthly exchange rates — 12 currencies vs SAR, history since 2009. Zero-dependency Node.js/TypeScript client.",
+  "version": "1.3.22",
+  "description": "Official Saudi Central Bank (SAMA) (Saudi Arabia) daily exchange rates — 66 currencies vs SAR, history since 2009. Zero-dependency Node.js/TypeScript client.",
   "keywords": [
     "sama",
     "saudi-central-bank-sama",