Get Instant Access to our Exchange Rates API

Get access instantly - 1000 requests free p/m.


Historical Exchange Rate Data

Our service offers historical currency conversion data from 1990 to the current day. Only 35 currencies are supported at the moment but we're working to add more.

Usage Notes

  • This data is for illustrative purposes only - it doesn't reflect actual buy/sell spreads that were historically available. We blend data from different sources to reduce inaccuracies & provide one mid-rate for each calendar day.
  • Historical exchange rates are only accessible by paid accounts.
  • Data for some currencies is only available for certain time periods - for instance a number of currencies were replaced with the Euro from 1999 onwards.

Supported Currencies

We have past exchange rates for the following currency codes:

AUD ATS BEF BRL CAD CHF CNY DEM
DKK ESP EUR FIM FRF GBP GRD HKD
IEP INR IRR ITL JPY KRW LKR MXN
MYR NGK NLG NZD PTE SEK SGD THB
TWD USD ZAR

API Endpoint Documentation

Please see an example GET request below. Replace USD with your chosen currency code and replace 2005/4/28 with your chosen date in YYYY/M/D format.

https://v3.exchangerate-api.com/archive/YOUR_KEY/USD/2005/4/28

This will return exchange rates from your chosen base currency to all the other currencies we have data for on the date you requested:

{
	"result": "success",
	"from": "USD",
	"year": 2005,
	"month": 4,
	"day": 28,
	"rates": {
		"USD": 1,
		"AUD": 1.28287364,
		"BRL": 2.523,
		"CAD": 1.2508,
		"CHF": 1.1918,
		"...": 7.473, etc. etc.
	}
}

Error Responses

{
	"result": "failed",
	"error": "unknown-code"
}

Where "error" can be any of the following:

  • "invalid-key" for a key that isn't active or doesn't exist (get a key here...)
  • "malformed-request" when your request doesn't follow the structure above
  • "no-data" when we don't have data for the currency & date pair you requested
  • "not-paid-account" when a user with a free account tries to access historical rate data

If you have any queries about the above please don't hesitate to email us!