# Historical Exchange Rates

Returns exchange rates for a given time range. Generally, we provide data going back to 1999.

Request Method: GET
Request URL: https://api.currencyapi.com/v3/historical

# Request Parameters

Parameter Type Mandatory Description
apikey string Your API Key
date string 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.

{
    "meta": {
        "last_updated_at": "2022-01-01T23:59:59Z"
    },
    "data": {
        "AED": {
            "code": "AED",
            "value": 3.67306
        },
        "AFN": {
            "code": "AFN",
            "value": 91.80254
        },
        "ALL": {
            "code": "ALL",
            "value": 108.22904
        },
        "AMD": {
            "code": "AMD",
            "value": 480.41659
        },
        "...": "150+ more currencies"
    }
}