v1.0.2

Signed-off-by: Finbarrs Oketunji <f@finbarrs.eu>

Author: 0xnu

README.md

@@ -65,6 +65,14 @@ $baseCurrency = 'GBP';
 $targetCurrency = 'EUR';
 $amount = 1000;
 
+// Set the date for which you want to retrieve the currencies
+$day = '05';
+$month = '04';
+$year = '2023';
+
+// Set the UUID of the currency you want to retrieve
+$uuid = 'currency_uuid';
+
 // Call the convert method to perform the currency conversion
 $conversionResult = $currensees->convert($date, $baseCurrency, $targetCurrency, $amount);
 if ($conversionResult) {
@@ -82,14 +90,6 @@ if ($convertAllResult) {
     echo "Conversion to all currencies failed: " . $convertAllResult['error'] . "\n";
 }
 
-// Set the date for which you want to retrieve the currencies
-$day = '02';
-$month = '04';
-$year = '2023';
-
-// Set the UUID of the currency you want to retrieve
-$uuid = 'currency_uuid';
-
 // Call the getCurrencies method to get the available currencies for the given date
 $currenciesResult = $currensees->getCurrencies($username, $day, $month, $year);
 if ($currenciesResult) {
@@ -107,6 +107,24 @@ if ($currencyResult) {
 } else {
     echo "Failed to retrieve currency details for the given date.\n";
 }
+
+// Call the getHistoricalData method to get historical data for all currencies for the given date
+$historicalDataResult = $currensees->getHistoricalData($username, $date, $day, $month, $year);
+if ($historicalDataResult) {
+    echo "Historical data for " . $date . ":\n";
+    echo json_encode($historicalDataResult) . "\n";
+} else {
+    echo "Failed to retrieve historical data for the given date.\n";
+}
+
+// Call the getHistoricalDataForCurrency method to get historical data for a specific currency
+$historicalDataForCurrencyResult = $currensees->getHistoricalDataForCurrency($uuid, $username, $day, $month, $year, $date);
+if ($historicalDataForCurrencyResult) {
+    echo "Historical data for currency " . $uuid . " on " . $date . ":\n";
+    echo json_encode($historicalDataForCurrencyResult) . "\n";
+} else {
+    echo "Failed to retrieve historical data for the given currency and date.\n";
+}
 ?>
 ```
 

example.php

@@ -25,6 +25,14 @@
 $targetCurrency = 'EUR';
 $amount = 1000;
 
+// Set the date for which you want to retrieve the currencies
+$day = '05';
+$month = '04';
+$year = '2023';
+
+// Set the UUID of the currency you want to retrieve
+$uuid = 'currency_uuid';
+
 // Call the convert method to perform the currency conversion
 $conversionResult = $currensees->convert($date, $baseCurrency, $targetCurrency, $amount);
 if ($conversionResult) {
@@ -42,14 +50,6 @@
     echo "Conversion to all currencies failed: " . $convertAllResult['error'] . "\n";
 }
 
-// Set the date for which you want to retrieve the currencies
-$day = '02';
-$month = '04';
-$year = '2023';
-
-// Set the UUID of the currency you want to retrieve
-$uuid = 'currency_uuid';
-
 // Call the getCurrencies method to get the available currencies for the given date
 $currenciesResult = $currensees->getCurrencies($username, $day, $month, $year);
 if ($currenciesResult) {
@@ -68,4 +68,21 @@
     echo "Failed to retrieve currency details for the given date.\n";
 }
 
+// Call the getHistoricalData method to get historical data for all currencies for the given date
+$historicalDataResult = $currensees->getHistoricalData($username, $date, $day, $month, $year);
+if ($historicalDataResult) {
+    echo "Historical data for " . $date . ":\n";
+    echo json_encode($historicalDataResult) . "\n";
+} else {
+    echo "Failed to retrieve historical data for the given date.\n";
+}
+
+// Call the getHistoricalDataForCurrency method to get historical data for a specific currency
+$historicalDataForCurrencyResult = $currensees->getHistoricalDataForCurrency($uuid, $username, $day, $month, $year, $date);
+if ($historicalDataForCurrencyResult) {
+    echo "Historical data for currency " . $uuid . " on " . $date . ":\n";
+    echo json_encode($historicalDataForCurrencyResult) . "\n";
+} else {
+    echo "Failed to retrieve historical data for the given currency and date.\n";
+}
 ?>

src/currensees.php

@@ -108,5 +108,39 @@ public function getCurrency($uuid, $username, $day, $month, $year)
             return false;
         }
     }
+
+    public function getHistoricalData($username, $date, $day, $month, $year)
+    {
+        $client = new Client();
+        $headers = [
+            'Accept' => 'application/json'
+        ];
+        $url = 'https://currensees.com/v1/historical?username=' . $username . '&date=' . $date . '&day=' . $day . '&month=' . $month . '&year=' . $year;
+        $request = new Request('GET', $url, $headers);
+        $res = $client->sendAsync($request)->wait();
+    
+        if ($res->getStatusCode() == 200) {
+            return json_decode($res->getBody(), true);
+        } else {
+            return false;
+        }
+    }    
+
+    public function getHistoricalDataForCurrency($uuid, $username, $day, $month, $year, $date)
+    {
+        $client = new Client();
+        $headers = [
+            'Accept' => 'application/json'
+        ];
+        $url = 'https://currensees.com/v1/historical/' . $uuid . '?username=' . $username . '&day=' . $day . '&month=' . $month . '&year=' . $year . '&date_string=' . $date;
+        $request = new Request('GET', $url, $headers);
+        $res = $client->sendAsync($request)->wait();
+    
+        if ($res->getStatusCode() == 200) {
+            return json_decode($res->getBody(), true);
+        } else {
+            return false;
+        }
+    }    
 
 }

tests/CurrenseesTest.php

@@ -26,7 +26,7 @@ public function testLogin()
 
     public function testConvert()
     {
-        $date = '2023_04_03';
+        $date = '2023_04_05';
         $baseCurrency = 'GBP';
         $targetCurrency = 'EUR';
         $amount = 1000;
@@ -39,7 +39,7 @@ public function testConvertAll()
     {
         $baseCurrency = 'GBP';
         $amount = 1000;
-        $date = '2023_04_03';
+        $date = '2023_04_05';
 
         $result = $this->currensees->convertAll($baseCurrency, $amount, $date);
         $this->assertTrue(is_array($result));
@@ -48,7 +48,7 @@ public function testConvertAll()
     public function testGetCurrencies()
     {
         $username = 'your_username';
-        $day = '02';
+        $day = '05';
         $month = '04';
         $year = '2023';
 
@@ -60,11 +60,36 @@ public function testGetCurrency()
     {
         $uuid = 'currency_uuid';
         $username = 'your_username';
-        $day = '02';
+        $day = '05';
         $month = '04';
         $year = '2023';
 
         $result = $this->currensees->getCurrency($uuid, $username, $day, $month, $year);
         $this->assertTrue(is_array($result));
     }
+
+    public function testGetHistoricalData()
+    {
+        $username = 'your_username';
+        $date = '2023_04_05';
+        $day = '05';
+        $month = '04';
+        $year = '2023';
+
+        $result = $this->currensees->getHistoricalData($username, $date, $day, $month, $year);
+        $this->assertTrue(is_array($result));
+    }
+
+    public function testGetHistoricalDataForCurrency()
+    {
+        $uuid = 'currency_uuid';
+        $username = 'your_username';
+        $day = '05';
+        $month = '04';
+        $year = '2023';
+        $date = '2023_04_05';
+
+        $result = $this->currensees->getHistoricalDataForCurrency($uuid, $username, $day, $month, $year, $date);
+        $this->assertTrue(is_array($result));
+    }
 }