GET
/
v1
/
historical
Historical exchange rates
curl --request GET \
  --url https://exchange-rates.abstractapi.com/v1/historical
{
    "base": "USD",
    "date": "2024-01-01",
    "exchange_rates": {
        "EUR": 0.912742,
        "JPY": 142.095655,
        "BGN": 1.785141,
        "CZK": 22.532859,
        "DKK": 6.804582,
        "GBP": 0.790845,
        "HUF": 348.758671,
        "PLN": 3.989412,
        "RON": 4.536783,
        "SEK": 10.181179,
        "CHF": 0.849306,
        "ISK": 137.550201,
        "NOK": 10.297097,
        "TRY": 29.726543,
        "AUD": 1.473804,
        "BRL": 4.888828,
        "CAD": 1.329409,
        "CNY": 7.143483,
        "HKD": 7.813892,
        "IDR": 15523.603505,
        "ILS": 3.624042,
        "INR": 83.319642,
        "KRW": 1313.234757,
        "MXN": 17.057959,
        "MYR": 4.602501,
        "NZD": 1.594651,
        "PHP": 55.659912,
        "SGD": 1.326488,
        "THB": 34.285323,
        "ZAR": 18.588536
    }
}
Note: the historical endpoint is currently in closed beta.

​
Getting started

​
Base URL

https://exchange-rates.abstractapi.com/v1/historical

​
Validation endpoint

The base currency is the currency you’re converting from, while the target currency or currencies are what you’re converting to. Also, if no target currency or currencies are specified, then all available currencies are returned. You can see a full list of supported currencies here. 
https://exchange-rates.abstractapi.com/v1/historical
? api_key = YOUR_UNIQUE_API_KEY
& base = USD
& date = 2024-01-01
This was a successful request, and because no target currency or currencies were included, the exchange rate of all available currencies were included in the response: 
{
    "base": "USD",
    "date": "2024-01-01",
    "exchange_rates": {
        "EUR": 0.912742,
        "JPY": 142.095655,
        "BGN": 1.785141,
        "CZK": 22.532859,
        "DKK": 6.804582,
        "GBP": 0.790845,
        "HUF": 348.758671,
        "PLN": 3.989412,
        "RON": 4.536783,
        "SEK": 10.181179,
        "CHF": 0.849306,
        "ISK": 137.550201,
        "NOK": 10.297097,
        "TRY": 29.726543,
        "AUD": 1.473804,
        "BRL": 4.888828,
        "CAD": 1.329409,
        "CNY": 7.143483,
        "HKD": 7.813892,
        "IDR": 15523.603505,
        "ILS": 3.624042,
        "INR": 83.319642,
        "KRW": 1313.234757,
        "MXN": 17.057959,
        "MYR": 4.602501,
        "NZD": 1.594651,
        "PHP": 55.659912,
        "SGD": 1.326488,
        "THB": 34.285323,
        "ZAR": 18.588536
    }
}

​
Request parameters

​
api_key
String
required
Your unique API key. Note that each user has unique API keys for each of Abstract’s APIs, so your Exchange Rates API key will not work for your IP Geolocation API, for example.
​
base
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.
​
date
String
required
The historical date you’d like to get rates from, in the format of YYYY-MM-DD.
​
target
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.
​
base
String
The base currency used to get the exchange rates.
​
date
String
The date the currencies were pulled from, per the successful request.
​
exchange_rates
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.