Skip to content

Latest commit

 

History

History
101 lines (81 loc) · 3.72 KB

README.md

File metadata and controls

101 lines (81 loc) · 3.72 KB
Raw

EuropeanCentralBank.ExchangeRates

European CentralBank ExchangeRates Api Client for C# / uses the European Central Bank's daily feed for accuracy

AutoLoad

Build status CodeFactor License: MIT NuGet NuGet

Port of https://github.com/facundofarias/ecb-exchange-rates

For : https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html

Installation

To Install from the Nuget Package Manager Console

PM > Install-Package EuropeanCentralBank.ExchangeRates
NET CLI - dotnet add package EuropeanCentralBank.ExchangeRates
paket paket add EuropeanCentralBank.ExchangeRates

Available here https://www.nuget.org/packages/EuropeanCentralBank.ExchangeRates/#

Usage

Using the libary should be straight forward

Get Currencies information (Interfaces can be mocked for testing purpose)

    IExchangeRatesSource source = new ExchangeRatesSource();
    var rates = await source.GetCurrenciesAsync();

Currencies conversion (always using Euro as a base) Using double rule of 3 for calculation with a non euro base conversion.

    
    IExchangeRatesCalculator calculator = new ExchangeRatesCalculator(source); // will take any IExchangeRatesSource

    double originalAmount = 40;
    var amountInEuros = await calculator.Calculate(Currencies.USDollar, Currencies.Euro, originalAmount);
    Console.WriteLine($"You spent {originalAmount} US and it is equals to {amountInEuros} in EU");

    // from chf to dollar
    originalAmount = 100;
    var amountInDollars = await calculator.Calculate(Currencies.SwissFranc, Currencies.USDollar, originalAmount);
    Console.WriteLine($"You spent {originalAmount} CHF and it is equals to {amountInDollars} in USD");

Sample here

Supported Currencies

  • AUD - Australian Dollar
  • BGN - Bulgarian Lev
  • BRL - Brazilian Real
  • CAD - Canadian Dollar
  • CHF - Swiss Franc
  • CNY - Chinese Yuan
  • CZK - Czech Koruna
  • DKK - Danish Krone
  • EUR - Euro
  • GBP - British Pound
  • HKD - Hong Kong Dollar
  • HRK - Croatian Kuna
  • HUF - Hungarian Forint
  • IDR - Indonesian Rupiah
  • ILS - Israeli New Shekel
  • INR - Indian Rupee
  • JPY - Japanese Yen
  • KRW - South Korean Won
  • LTL - Lithuanian Litas
  • LVL - Latvian Lats
  • MXN - Mexian Peso
  • MYR - Malaysian Ringgit
  • NOK - Norwegian Krone
  • NZD - New Zealand Dollar
  • PHP - Phillippine Peso
  • PLN - Polish Zloty
  • RON - Romanian New Leu
  • RUB - Russian Rouble
  • SEK - Swedish Krona
  • SGD - Singapore Dollar
  • THB - Thai Baht
  • TRY - Turkish Lira
  • USD - US Dollar
  • ZAR - South African Rand

Disclaimer ECB Api may remove some of the supported currencies, the library is ready to don't break in that case but nothing will be retrieved for that currency, for more information please see : https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html

Icon

Created by Mariana Alemanno

Made with ❤ in DGENIX