Fork me on GitHub

Project Notes

xe_currency

Using the Xe Currency Data API from Ruby and with curl.

Notes

Xe have been a trusted currency data source for over 25 years. They provide an API for programmatic access to current and historical exchange rates. It is a paid service, but a limited-time free trial is available.

curl and bash example

The xe.sh script is a simple bash script example of calling the API with curl.

$ ./xe.sh account_info
######################################################################## 100.0%
{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx",
  "organization": "xxxxxxxxxxxx",
  "package": "FREETRIAL_DAILY_REAL_DATA",
  "service_start_timestamp": "2023-07-14T00:00:00Z",
  "service_end_timestamp": "2023-07-22T00:00:00Z",
  "package_limit": 10000,
  "package_limit_remaining": 9995
}

$ ./xe.sh currencies | more
######################################################################## 100.0%
{
  "terms": "http://www.xe.com/legal/dfs.php",
  "privacy": "http://www.xe.com/privacy.php",
  "currencies": [
    {
      "iso": "AED",
      "currency_name": "Emirati Dirham",
      "is_obsolete": false
    },
    {
      "iso": "AFN",
      "currency_name": "Afghan Afghani",
      "is_obsolete": false
    },
    {
      "iso": "ALL",
      "currency_name": "Albanian Lek",
      "is_obsolete": false
    },
    {
      "iso": "AMD",
      "currency_name": "Armenian Dram",
      "is_obsolete": false
    },
...

Single currency conversion:

$ ./xe.sh SGD to USD
######################################################################## 100.0%
{
  "terms": "http://www.xe.com/legal/dfs.php",
  "privacy": "http://www.xe.com/privacy.php",
  "to": "USD",
  "amount": 1,
  "timestamp": "2023-07-14T00:00:00Z",
  "from": [
    {
      "quotecurrency": "SGD",
      "mid": 1.32262978
    }
  ]
}

$ ./xe.sh USD to SGD
######################################################################## 100.0%
{
  "terms": "http://www.xe.com/legal/dfs.php",
  "privacy": "http://www.xe.com/privacy.php",
  "to": "SGD",
  "amount": 1,
  "timestamp": "2023-07-14T00:00:00Z",
  "from": [
    {
      "quotecurrency": "USD",
      "mid": 0.7560694725
    }
  ]
}

xe_currency gem

The xe_currency gem provides a simple interface for querying current exchange rates. It does not support access to historic rates or other api features.

The example uses the currently unpublished 0.0.2 version of the gem (installed via bundler):

$ bundle install
....
$ bundle exec ./xe_currency_example.rb USD to SGD
0.7560694725e0
$ bundle exec ./xe_currency_example.rb SGD to USD
0.132262978e1

Credits and References

About LCK#256 ruby
Project Source on GitHub Return to the Project Catalog

This page is a web-friendly rendering of my project notes shared in the LittleCodingKata GitHub repository.

LittleCodingKata is my collection of programming exercises, research and code toys broadly spanning things that relate to programming and software development (languages, frameworks and tools).

These range from the trivial to the complex and serious. Many are inspired by existing work and I'll note credits and references where applicable. The focus is quite scattered, as I variously work on things new and important in the moment, or go back to revisit things from the past.

This is primarily a personal collection for my own edification and learning, but anyone who stumbles by is welcome to borrow, steal or reference the work here. And if you spot errors or issues I'd really appreciate some feedback - create an issue, send me an email or even send a pull-request.