Project

nordea

0.01
Repository is archived
No commit activity in last 3 years
No release in over 3 years
A Money.gem compatible currency exchange rate implementation for Nordea Bank
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
~> 2.14.1
>= 0

Runtime

>= 5.1.1
>= 0.3.38
 Project Readme

The Nordea Gem

Build Status Code Climate Gem Version

Exchange rates from Nordea Bank.

Installation

Just like any other gem:

gem install nordea

Usage

With the Money gem

The Money gem integration works in a similar way to the eu_central_bank library, mostly because I referenced that gem while building this one. A couple of the methods in the Nordea::Bank class are pretty much identical to those in the eu_central_bank gem.

nordea_bank = Nordea::Bank.new
Money.default_bank =  nordea_bank

# Exchange 100 EUR to USD
nordea_bank.exchange(100, "EUR", "USD")

# Exchange 100 USD to South African rands
Money.us_dollar(100).exchange_to("ZAR")

# Exchange 100 Canadian dollars to US dollars
nordea_bank.exchange_with(Money.new(100, "CAD"), "USD")

# Update the forex rates
nordea_bank.update_rates

Without the Money gem

exchange_rates = Nordea::ExchangeRates.new

exchange_rates.currencies
  #=> returns a hash of currencies

exchange_rates.currencies(true)
  #=> returns a hash of currencies, but forces a data update

exchange_rates.headers
  #=> returns a hash of the data headers from Nordea

For more information, read the documentation.

Ruby compatibility

The gem should work with Ruby 1.9.3, Ruby 2.0.0, jRuby, and Rubinius (only Ruby 1.9 is actively targetted).

About the data and data source

Nordea quotes exchange rates on national banking days at least three times a day:

  • in the morning at 8.00,
  • at noon at 12.15 and
  • in the afternoon at 16.15 (approximate times).

Useful links:

Disclaimer

  • This is not an official gem from Nordea.
  • I have no affiliation to any entity connected to Nordea Bank.
  • I do not have any control over the exchange rate data provided, and you use this gem entirely at your own risk.

License

MIT License. Copyright 2011-2013 Matias Korhonen.

See the LICENSE file for more details.