Ruby Exchange Rate API Documentation

How To Use Our Ruby Exchange Rates API

We offer an easy to use, accurate and reliable exchange rates API for Ruby that's perfect for both personal and professional use.

Fetching exchange rates using our Ruby currency conversion API is as easy as making GET requests. This means you can easily integrate our API into your Ruby on Rails project however you'd prefer.

For more details on the different types of request we support please see our Main Documentation.

Alternatively simply use the Ruby library code below to get started with our exchange rate data as fast as you can copy & paste!

You'll need a free API key to access our service. Visit this page to create a free account and get started right away.

Simple Ruby on Rails Currency Conversion Example


require 'net/http'
require 'json'

# Setting URL
url = "https://v6.exchangerate-api.com/v6/YOUR-API-KEY/latest/USD"
uri = URI(url)
response = Net::HTTP.get(uri)
response_obj = JSON.parse(response)

# Getting a rate
rate = response_obj['conversion_rates']['EUR']
							

This will return the exchange rates from USD to all other currencies we support:

{
	"result": "success",
	"documentation": "https://www.exchangerate-api.com/docs",
	"terms_of_use": "https://www.exchangerate-api.com/terms",
	"time_last_update_unix": 1585267200,
	"time_last_update_utc": "Fri, 27 Mar 2020 00:00:00 +0000",
	"time_next_update_unix": 1585353700,
	"time_next_update_utc": "Sat, 28 Mar 2020 00:00:00 +0000",
	"base_code": "USD",
	"conversion_rates": {
		"USD": 1,
		"AUD": 1.4817,
		"BGN": 1.7741,
		"CAD": 1.3168,
		"CHF": 0.9774,
		"CNY": 6.9454,
		"EGP": 15.7361,
		"EUR": 0.9013,
		"GBP": 0.7679,
		"...": 7.8536,
		"...": 1.3127,
		"...": 7.4722, etc. etc.
	}
}

Eloquent Studio has also released a Ruby gem library for ExchangeRate-API. It's MIT Licensed and available here.

Please see our main documentation for further information on this query type & error response details.

Please email us if you'd like to submit a code example.