# Historical Exchange Rates

Returns exchange rates for a given date. Generally, we provide data going back to 1999. To get a range of historical data, please upgrade to currencyapi.com in your dashboard and use the /range endpoint (https://currencyapi.com/docs/range)

Request Method: GET
Request URL: https://api.freecurrencyapi.com/v1/historical

# Request Parameters

Parameter Type Mandatory Description
apikey string Your API Key
date string Start date to retrieve historical rates from (format: 2021-12-31)
base_currency string The base currency to which all results are behaving relative to
By default all values are based on USD
currencies string A list of comma seperated currency codes which you want to get (EUR,USD,CAD)
By default all available currencies will be shown

# Sample Response

The API response comes in easy-to-read JSON format and contains the end-of-day data for the provided date parameter for all currencies.

{
    "data": {
        "2022-01-01": {
            "AED": 3.67306,
            "AFN": 91.80254,
            "ALL": 108.22904,
            "AMD": 480.41659,
            "...": "150+ more currencies"
        }
    }
}