Currency Conversion- Using CurrencyFreaks API (#2639)

* Create README.md

* Create script.js

* Update script.js

* Update README.md

* rename the folder

Author: NayeemKaka

Integration/RESTMessageV2/Currency Conversion - Using CurrencyFreaks API/README.md

@@ -0,0 +1,19 @@
+# Currency Conversion- Using CurrencyFreaks API
+## Overview
+This API allows to convert an amount from USD to any selected currency in real-time using live exchange rates fetched from the CurrencyFreaks API.
+
+## Configuration Steps
+### Get Your CurrencyFreaks API Key
+1. Go to https://currencyfreaks.com
+2. Sign up for a free account.
+3. Navigate to Dasboard ->API Keys.
+4. Copy your API key - you'll need it in ServiceNow.
+
+### Create a REST Message in ServiceNow
+- Name: CurrencyFreaks API
+- Endpoint: https://api.currencyfreaks.com/v2.0/rates/latest?apikey=${apikey}&symbols=${symbols}
+- HTTP Method: GET
+
+### Example Response
+```json
+{"date":"2025-10-30 00:00:00+00","base":"USD","rates":{"EUR":"0.861846","SAR":"3.7502","KWD":"0.30678","INR":"88.4075"}}

Integration/RESTMessageV2/Currency Conversion - Using CurrencyFreaks API/script.js

@@ -0,0 +1,22 @@
+var symbols ="INR,EUR,KWD,SAR"; //Enter symbol name like SAR,AED
+var apiKey =""; // Paste your CurrencyFreaks APIKEY here
+getExchangeReate(apiKey, symbols);
+
+function getExchangeReate(apiKey,symbols){
+	try { 
+	
+ var r = new sn_ws.RESTMessageV2('ExchangeRate API', 'Default GET');
+ r.setStringParameterNoEscape('symbols', symbols);
+ r.setStringParameterNoEscape('apikey', apiKey);
+
+
+ var response = r.execute();
+ var responseBody = response.getBody();
+ var httpStatus = response.getStatusCode();
+ gs.print("Status: " +httpStatus);
+ gs.print("Result:" +responseBody); //It will show conversion from USD the selected currency 
+}
+catch(ex) {
+ var message = ex.message;
+}
+}