xchange-rates 2025.8.17-2 → 2025.8.17-4

package/README.md

@@ -0,0 +1,349 @@
+# 📈 xchange-rates
+
+[![View on npm](https://img.shields.io/badge/npm-xchange--rates-red?logo=npm)](https://www.npmjs.com/package/xchange-rates)
+[![npm version](https://img.shields.io/npm/v/xchange-rates)](https://www.npmjs.com/package/xchange-rates)
+[![npm downloads](https://img.shields.io/npm/dm/xchange-rates)](https://www.npmjs.com/package/xchange-rates)
+
+A lightweight Node.js package and CLI tool to fetch **real-time currency exchange rates** between any two currencies.
+Exchange rate data is updated daily and served directly via **CDN** for **fast and reliable access**.
+
+---
+
+☕ _This package runs on caffeine. If it helped you, consider buying me a coffee._
+
+<a href="https://www.buymeacoffee.com/jayadevpanthaplavil" target="_blank">
+  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height:60px;width:auto;">
+</a>
+
+---
+
+## ✨ Features
+
+- Fetch live exchange rates between **any two supported currencies**
+- Data refreshed **daily** via CDN
+- Works both as **Node.js library** and **CLI tool**
+- Simple, lightweight, no API key required 🚀
+- Unlimited data fetches
+
+---
+
+## 📦 Installation
+
+```bash
+npm install xchange-rates
+```
+
+Or with yarn:
+
+```bash
+yarn add xchange-rates
+```
+
+---
+
+## 🚀 Usage
+
+### In Node.js
+
+```js
+import { xchangerate } from "xchange-rates";
+
+(async () => {
+  const result = await xchangerate("USD", "INR");
+  console.log(result);
+})();
+```
+
+**Output:**
+
+```json
+{
+  "date": "2025-08-17",
+  "base": "USD",
+  "target": "INR",
+  "rate": 87.51385
+}
+```
+
+---
+
+### In CLI
+
+```bash
+xchangerate USD INR
+```
+
+**Output:**
+
+```json
+{
+  "date": "2025-08-17",
+  "base": "USD",
+  "target": "INR",
+  "rate": 87.51385
+}
+```
+
+---
+
+## 🌍 Supported Currencies
+
+This package supports **~180 currency codes** including **official national currencies, regional currencies, financial instruments, precious metals, and cryptocurrencies**.
+
+## 📊 At a Glance
+
+- **🌐 Total codes listed:** ~180
+- **🏳️ Country & territory currencies:** ~150
+- **🤝 Regional/shared currencies:** 5+
+- **💰 Precious metals / commodities:** 3 (Gold, Silver, etc.)
+- **₿ Cryptocurrencies:** 1 (Bitcoin)
+- **🏦 Supranational / financial instruments:** 1 (IMF SDR)
+- **📜 Obsolete / replaced codes:** 5+
+
+---
+
+## 🏳️ National & Territory Currencies
+
+Most of the list are official national or territory currencies. Examples:
+
+- **USD** – United States Dollar 🇺🇸
+- **INR** – Indian Rupee 🇮🇳
+- **JPY** – Japanese Yen 🇯🇵
+- **GBP** – British Pound Sterling 🇬🇧
+- **AUD** – Australian Dollar 🇦🇺
+- **CAD** – Canadian Dollar 🇨🇦
+- …and 140+ more, including currencies of smaller nations and overseas territories (e.g., **AWG** – Aruban Florin, **FKP** – Falkland Islands Pound).
+
+---
+
+## 🤝 Regional / Shared Currencies
+
+- **EUR** – Euro (27 EU countries and territories) 🇪🇺
+- **XAF** – CFA Franc BEAC (Central Africa)
+- **XOF** – CFA Franc BCEAO (West Africa)
+- **XPF** – CFP Franc (French overseas territories)
+- **XCD** – East Caribbean Dollar
+
+---
+
+## 💰 Precious Metals / Commodities
+
+- **XAU** – Gold (troy ounce)
+- **XAG** – Silver (troy ounce)
+- **XDR** – IMF Special Drawing Rights (supranational reserve asset)
+
+---
+
+## ₿ Cryptocurrency
+
+- **BTC** – Bitcoin
+
+---
+
+## 📜 Obsolete / Replaced
+
+Some codes are obsolete or updated:
+
+- **BYR** – Old Belarusian Ruble → replaced by **BYN**
+- **STD** – Old São Tomé and Príncipe Dobra → replaced by **STN**
+- **ZMK** – Old Zambian Kwacha → replaced by **ZMW**
+- **SLL** – Old Sierra Leonean Leone → replaced by **SLE**
+- **PEN** – Nuevo Sol → now **Sol**, still uses PEN
+
+---
+
+## 📖 Standard Reference
+
+All codes follow **ISO 4217**:
+
+- 3-letter codes (e.g., **USD, INR, EUR**).
+- The first two letters usually represent the country (per ISO 3166), and the third the currency (e.g., **IN** + **R** = INR).
+- Codes beginning with **X** are reserved for **non-sovereign currencies, precious metals, supranational assets, or crypto**.
+
+---
+
+<details>
+<summary>Click to expand</summary>
+
+**AED** – United Arab Emirates Dirham  
+**AFN** – Afghan Afghani  
+**ALL** – Albanian Lek  
+**AMD** – Armenian Dram  
+**ANG** – Netherlands Antillean Guilder  
+**AOA** – Angolan Kwanza  
+**ARS** – Argentine Peso  
+**AUD** – Australian Dollar  
+**AWG** – Aruban Florin  
+**AZN** – Azerbaijani Manat  
+**BAM** – Bosnia-Herzegovina Convertible Mark  
+**BBD** – Barbadian Dollar  
+**BDT** – Bangladeshi Taka  
+**BGN** – Bulgarian Lev  
+**BHD** – Bahraini Dinar  
+**BIF** – Burundian Franc  
+**BMD** – Bermudan Dollar  
+**BND** – Brunei Dollar  
+**BOB** – Bolivian Boliviano  
+**BRL** – Brazilian Real  
+**BSD** – Bahamian Dollar  
+**BTC** – Bitcoin  
+**BTN** – Bhutanese Ngultrum  
+**BWP** – Botswanan Pula  
+**BYN** – New Belarusian Ruble  
+**BYR** – Belarusian Ruble  
+**BZD** – Belize Dollar  
+**CAD** – Canadian Dollar  
+**CDF** – Congolese Franc  
+**CHF** – Swiss Franc  
+**CLF** – Chilean Unit of Account (UF)  
+**CLP** – Chilean Peso  
+**CNY** – Chinese Yuan  
+**CNH** – Chinese Yuan Offshore  
+**COP** – Colombian Peso  
+**CRC** – Costa Rican Colón  
+**CUC** – Cuban Convertible Peso  
+**CUP** – Cuban Peso  
+**CVE** – Cape Verdean Escudo  
+**CZK** – Czech Republic Koruna  
+**DJF** – Djiboutian Franc  
+**DKK** – Danish Krone  
+**DOP** – Dominican Peso  
+**DZD** – Algerian Dinar  
+**EGP** – Egyptian Pound  
+**ERN** – Eritrean Nakfa  
+**ETB** – Ethiopian Birr  
+**EUR** – Euro  
+**FJD** – Fijian Dollar  
+**FKP** – Falkland Islands Pound  
+**GBP** – British Pound Sterling  
+**GEL** – Georgian Lari  
+**GGP** – Guernsey Pound  
+**GHS** – Ghanaian Cedi  
+**GIP** – Gibraltar Pound  
+**GMD** – Gambian Dalasi  
+**GNF** – Guinean Franc  
+**GTQ** – Guatemalan Quetzal  
+**GYD** – Guyanese Dollar  
+**HKD** – Hong Kong Dollar  
+**HNL** – Honduran Lempira  
+**HRK** – Croatian Kuna  
+**HTG** – Haitian Gourde  
+**HUF** – Hungarian Forint  
+**IDR** – Indonesian Rupiah  
+**ILS** – Israeli New Sheqel  
+**IMP** – Manx Pound  
+**INR** – Indian Rupee  
+**IQD** – Iraqi Dinar  
+**IRR** – Iranian Rial  
+**ISK** – Icelandic Króna  
+**JEP** – Jersey Pound  
+**JMD** – Jamaican Dollar  
+**JOD** – Jordanian Dinar  
+**JPY** – Japanese Yen  
+**KES** – Kenyan Shilling  
+**KGS** – Kyrgystani Som  
+**KHR** – Cambodian Riel  
+**KMF** – Comorian Franc  
+**KPW** – North Korean Won  
+**KRW** – South Korean Won  
+**KWD** – Kuwaiti Dinar  
+**KYD** – Cayman Islands Dollar  
+**KZT** – Kazakhstani Tenge  
+**LAK** – Laotian Kip  
+**LBP** – Lebanese Pound  
+**LKR** – Sri Lankan Rupee  
+**LRD** – Liberian Dollar  
+**LSL** – Lesotho Loti  
+**LYD** – Libyan Dinar  
+**MAD** – Moroccan Dirham  
+**MDL** – Moldovan Leu  
+**MGA** – Malagasy Ariary  
+**MKD** – Macedonian Denar  
+**MMK** – Myanma Kyat  
+**MNT** – Mongolian Tugrik  
+**MOP** – Macanese Pataca  
+**MRU** – Mauritanian Ouguiya  
+**MUR** – Mauritian Rupee  
+**MVR** – Maldivian Rufiyaa  
+**MWK** – Malawian Kwacha  
+**MXN** – Mexican Peso  
+**MYR** – Malaysian Ringgit  
+**MZN** – Mozambican Metical  
+**NAD** – Namibian Dollar  
+**NGN** – Nigerian Naira  
+**NIO** – Nicaraguan Córdoba  
+**NOK** – Norwegian Krone  
+**NPR** – Nepalese Rupee  
+**NZD** – New Zealand Dollar  
+**OMR** – Omani Rial  
+**PAB** – Panamanian Balboa  
+**PEN** – Peruvian Nuevo Sol  
+**PGK** – Papua New Guinean Kina  
+**PHP** – Philippine Peso  
+**PKR** – Pakistani Rupee  
+**PLN** – Polish Zloty  
+**PYG** – Paraguayan Guarani  
+**QAR** – Qatari Rial  
+**RON** – Romanian Leu  
+**RSD** – Serbian Dinar  
+**RUB** – Russian Ruble  
+**RWF** – Rwandan Franc  
+**SAR** – Saudi Riyal  
+**SBD** – Solomon Islands Dollar  
+**SCR** – Seychellois Rupee  
+**SDG** – South Sudanese Pound  
+**SEK** – Swedish Krona  
+**SGD** – Singapore Dollar  
+**SHP** – Saint Helena Pound  
+**SLE / SLL** – Sierra Leonean Leone  
+**SOS** – Somali Shilling  
+**SRD** – Surinamese Dollar  
+**STD / STN** – São Tomé and Príncipe Dobra  
+**SVC** – Salvadoran Colón  
+**SYP** – Syrian Pound  
+**SZL** – Swazi Lilangeni  
+**THB** – Thai Baht  
+**TJS** – Tajikistani Somoni  
+**TMT** – Turkmenistani Manat  
+**TND** – Tunisian Dinar  
+**TOP** – Tongan Paʻanga  
+**TRY** – Turkish Lira  
+**TTD** – Trinidad and Tobago Dollar  
+**TWD** – New Taiwan Dollar  
+**TZS** – Tanzanian Shilling  
+**UAH** – Ukrainian Hryvnia  
+**UGX** – Ugandan Shilling  
+**USD** – United States Dollar  
+**UYU** – Uruguayan Peso  
+**UZS** – Uzbekistan Som  
+**VES** – Sovereign Bolivar  
+**VND** – Vietnamese Dong  
+**VUV** – Vanuatu Vatu  
+**WST** – Samoan Tala  
+**XAF** – CFA Franc BEAC  
+**XAG** – Silver (troy ounce)  
+**XAU** – Gold (troy ounce)  
+**XCD** – East Caribbean Dollar  
+**XCG** – Caribbean Guilder  
+**XDR** – Special Drawing Rights  
+**XOF** – CFA Franc BCEAO  
+**XPF** – CFP Franc  
+**YER** – Yemeni Rial  
+**ZAR** – South African Rand  
+**ZMK / ZMW** – Zambian Kwacha  
+**ZWL** – Zimbabwean Dollar
+
+</details>
+
+---
+
+## 🔗 Data Source
+
+All exchange rates are updated daily and served from CDN:  
+👉 [https://cdn.jsdelivr.net/npm/xchange-rates@latest/v1/currencies.json](https://cdn.jsdelivr.net/npm/xchange-rates@latest/v1/currencies.json)
+
+---
+
+## 📜 License
+
+[ISC](./LICENSE) – © Jayadev Panthaplavil

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xchange-rates",
-  "version": "2025.8.17-2",
+  "version": "2025.8.17-4",
   "description": "A lightweight Node.js package to get real-time currency exchange rates for any base currency using a pivot currency, fetched directly from a CDN for fast and reliable access.",
   "main": "index.js",
   "type": "module",
@@ -11,7 +11,32 @@
     "update": "node scripts/updateRates.js",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
+  "keywords": [
+    "exchange",
+    "currency",
+    "currency-converter",
+    "forex",
+    "fx",
+    "exchange-rate",
+    "money",
+    "finance",
+    "international",
+    "currency-rates",
+    "forex-rates",
+    "financial-api",
+    "exchange-api",
+    "fx-rates",
+    "real-time",
+    "currency-conversion"
+  ],
   "author": "Jayadev Panthaplavil",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jayadevpanthaplavil/xchange-rates.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jayadevpanthaplavil/xchange-rates/issues"
+  },
   "license": "ISC",
   "dependencies": {
     "date-fns": "^4.1.0",

package/v1/currencies.json

@@ -1,177 +1,177 @@
 {
-  "timestamp": 1755421206,
+  "timestamp": 1755453602,
   "base": "USD",
   "rates": {
-    "AED": 3.67295,
-    "AFN": 69,
-    "ALL": 83.8,
-    "AMD": 383.1,
+    "AED": 3.6725,
+    "AFN": 68.253087,
+    "ALL": 83.111893,
+    "AMD": 382.193341,
     "ANG": 1.79,
     "AOA": 917,
-    "ARS": 1297.537602,
-    "AUD": 1.537043,
+    "ARS": 1296.544535,
+    "AUD": 1.528585,
     "AWG": 1.80075,
     "AZN": 1.7,
     "BAM": 1.673054,
     "BBD": 2,
     "BDT": 121.454217,
-    "BGN": 1.67146,
-    "BHD": 0.376789,
-    "BIF": 2960,
+    "BGN": 1.671124,
+    "BHD": 0.376469,
+    "BIF": 2977.661689,
     "BMD": 1,
-    "BND": 1.281694,
-    "BOB": 6.907525,
-    "BRL": 5.4013,
+    "BND": 1.280215,
+    "BOB": 6.899645,
+    "BRL": 5.40085,
     "BSD": 1,
-    "BTC": 0.000008445528,
-    "BTN": 87.426851,
-    "BWP": 13.378101,
-    "BYN": 3.334902,
-    "BZD": 2.00793,
+    "BTC": 0.00000847672,
+    "BTN": 87.326024,
+    "BWP": 13.36267,
+    "BYN": 3.331055,
+    "BZD": 2.005639,
     "CAD": 1.38215,
-    "CDF": 2895,
+    "CDF": 2908.105664,
     "CHF": 0.806593,
-    "CLF": 0.024552,
-    "CLP": 963.17,
+    "CLF": 0.024576,
+    "CLP": 964.09621,
     "CNH": 7.1854,
     "CNY": 7.1821,
-    "COP": 4046.904675,
-    "CRC": 505.132789,
+    "COP": 4046.90905,
+    "CRC": 504.549833,
     "CUC": 1,
     "CUP": 25.75,
-    "CVE": 94.9,
+    "CVE": 94.215386,
     "CZK": 20.9044,
-    "DJF": 177.827972,
+    "DJF": 177.810054,
     "DKK": 6.37675,
-    "DOP": 61.725,
-    "DZD": 129.567225,
+    "DOP": 61.460243,
+    "DZD": 129.58598,
     "EGP": 48.265049,
     "ERN": 15,
-    "ETB": 141.15,
-    "EUR": 0.854348,
+    "ETB": 140.628796,
+    "EUR": 0.855066,
     "FJD": 2.2559,
     "FKP": 0.73749,
     "GBP": 0.73749,
     "GEL": 2.69,
     "GGP": 0.73749,
-    "GHS": 10.65,
+    "GHS": 10.833511,
     "GIP": 0.73749,
     "GMD": 72.499999,
-    "GNF": 8677.5,
-    "GTQ": 7.667237,
-    "GYD": 209.056268,
-    "HKD": 7.82445,
-    "HNL": 26.4,
+    "GNF": 8657.218616,
+    "GTQ": 7.658393,
+    "GYD": 208.817951,
+    "HKD": 7.8239,
+    "HNL": 26.13748,
     "HRK": 6.43702,
-    "HTG": 130.80408,
-    "HUF": 337.8,
+    "HTG": 130.653232,
+    "HUF": 337.591434,
     "IDR": 16203,
-    "ILS": 3.37948,
+    "ILS": 3.375315,
     "IMP": 0.73749,
-    "INR": 87.51385,
+    "INR": 87.5135,
     "IQD": 1310,
     "IRR": 42112.5,
-    "ISK": 122.38,
+    "ISK": 122.356558,
     "JEP": 0.73749,
-    "JMD": 159.957172,
+    "JMD": 159.772666,
     "JOD": 0.709,
-    "JPY": 147.09494849,
+    "JPY": 147.015,
     "KES": 129.5,
     "KGS": 87.3788,
-    "KHR": 4005,
+    "KHR": 3999.662829,
     "KMF": 420.499968,
     "KPW": 900,
     "KRW": 1388.97,
-    "KWD": 0.305303,
+    "KWD": 0.305324,
     "KYD": 0.83302,
     "KZT": 541.496827,
-    "LAK": 21600,
-    "LBP": 89181.146416,
+    "LAK": 21611.756746,
+    "LBP": 89410.301799,
     "LKR": 300.889726,
-    "LRD": 201.499983,
-    "LSL": 17.59,
-    "LYD": 5.415,
-    "MAD": 9.0095,
+    "LRD": 200.19652,
+    "LSL": 17.559107,
+    "LYD": 5.400094,
+    "MAD": 8.995173,
     "MDL": 16.598984,
-    "MGA": 4440,
+    "MGA": 4442.225512,
     "MKD": 52.634726,
     "MMK": 2099,
     "MNT": 3592.646,
     "MOP": 8.055945,
-    "MRU": 39.95,
-    "MUR": 45.58,
+    "MRU": 39.940189,
+    "MUR": 45.639997,
     "MVR": 15.41,
-    "MWK": 1735,
-    "MXN": 18.7435,
+    "MWK": 1731.365517,
+    "MXN": 18.875,
     "MYR": 4.213,
     "MZN": 63.899993,
     "NAD": 17.59,
     "NGN": 1532.72,
-    "NIO": 36.76,
+    "NIO": 36.741144,
     "NOK": 10.19562,
-    "NPR": 139.882797,
-    "NZD": 1.688049,
-    "OMR": 0.384284,
+    "NPR": 139.721457,
+    "NZD": 1.680249,
+    "OMR": 0.384218,
     "PAB": 1,
     "PEN": 3.56,
-    "PGK": 4.14,
+    "PGK": 4.154313,
     "PHP": 56.553002,
-    "PKR": 282.05,
-    "PLN": 3.638739,
-    "PYG": 7320.89017,
-    "QAR": 3.6406,
+    "PKR": 283.287617,
+    "PLN": 3.644209,
+    "PYG": 7312.384171,
+    "QAR": 3.640364,
     "RON": 4.3258,
     "RSD": 100.188013,
-    "RUB": 80.100406,
-    "RWF": 1445,
-    "SAR": 3.752253,
+    "RUB": 79.719745,
+    "RWF": 1445.806454,
+    "SAR": 3.7525,
     "SBD": 8.223773,
-    "SCR": 14.145453,
+    "SCR": 14.949545,
     "SDG": 600.5,
     "SEK": 9.5588,
-    "SGD": 1.280713,
+    "SGD": 1.2772,
     "SHP": 0.73749,
     "SLE": 23.3,
     "SLL": 20969.5,
-    "SOS": 571.5,
+    "SOS": 570.598769,
     "SRD": 37.56,
     "SSP": 130.26,
     "STD": 22281.8,
-    "STN": 21.3,
+    "STN": 20.933909,
     "SVC": 8.746792,
     "SYP": 13002,
-    "SZL": 17.59,
-    "THB": 32.426198,
+    "SZL": 17.553723,
+    "THB": 32.392019,
     "TJS": 9.321609,
     "TMT": 3.51,
-    "TND": 2.921557,
+    "TND": 2.918187,
     "TOP": 2.40776,
     "TRY": 40.799999,
     "TTD": 6.782633,
     "TWD": 30.0325,
-    "TZS": 2611.496551,
-    "UAH": 41.258598,
-    "UGX": 3558.612919,
+    "TZS": 2608.534737,
+    "UAH": 41.211007,
+    "UGX": 3554.505441,
     "USD": 1,
-    "UYU": 40.070284,
+    "UYU": 39.945314,
     "UZS": 12550,
     "VES": 135.470356,
     "VND": 26270.889205,
     "VUV": 119.1167,
     "WST": 2.7716,
-    "XAF": 560.415306,
+    "XAF": 560.886708,
     "XAG": 0.0263091,
     "XAU": 0.00029985,
     "XCD": 2.70255,
     "XCG": 1.801625,
-    "XDR": 0.704914,
-    "XOF": 560.415306,
+    "XDR": 0.697056,
+    "XOF": 560.886708,
     "XPD": 0.00089865,
-    "XPF": 101.950791,
+    "XPF": 102.036548,
     "XPT": 0.0007475,
     "YER": 240.27495,
-    "ZAR": 17.595245,
-    "ZMW": 23.166511,
+    "ZAR": 17.615,
+    "ZMW": 23.140087,
     "ZWG": 26.78,
     "ZWL": 322
   },