Skip to main content
GET
Get historical exchange rates
The historical endpoint is in closed beta. Access depends on beta enrollment, and available dates depend on stored rates.

Getting started

Base URL

Validation endpoint

The base currency represents the source currency, while target currencies indicate the destination currencies for conversion. When no target currencies are specified, all available currencies are returned. View the complete list of supported currencies in Currency symbols.
The response contains the base currency, the date, and the requested rates available for that date.

Request parameters

String
required
Your unique API key. Note that each user has unique API keys for each of Cleariflow APIs, so your Exchange Rates API key will not work for your IP Geolocation API, for example.
String
required
The base currency used to get the latest exchange rate(s) for. Uses the ISO 4217 currency standard (e.g., USD for United States Dollars), like all currency parameters in this API.
String
required
The historical date you’d like to get rates from, in the format of YYYY-MM-DD.
String
The target currency or currencies to get the exchange rate of versus the base currency. Like the base parameters, any currency passed here follows the ISO 4217 standard. If multiple currencies are passed in the target, they should be separated by commas (e.g., &target=EUR,CAD,AUD).

Response parameters

The API response is returned in a universal and lightweight JSON format.
String
The base currency used to get the exchange rates.
String
The date the currencies were pulled from, per the successful request.
Object
A JSON Object containing each of the target currency as the key and its exchange rate versus the base currency as that key’s value.

Query Parameters

api_key
string
required

Your unique API key for authentication

base
string
default:EUR

The base currency used to get the latest exchange rate(s) for. Uses the ISO 4217 currency standard

target
string

The target currency or currencies to get the exchange rate of versus the base currency. Multiple currencies should be separated by commas. If not specified, all available currencies will be returned.

date
string<date>
required

The historical date you'd like to get rates from, in the format of YYYY-MM-DD

Response

Successful response

base
string
required

The base currency used to get the exchange rates

Example:

"EUR"

date
string<date>
required

The date the currencies were pulled from

Example:

"2024-01-01"

exchange_rates
object
required

A JSON Object containing each of the target currency as the key and its exchange rate versus the base currency as that key's value

Example: