# Historical Exchange Rates

Returns exchange rates for a specific date. Generally, we provide data going back to 1999.

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

# Request Parameters

Parameter Type Mandatory Description
apikey string Your API Key
date string Date to retrieve historical rates from (format: 2021-12-31)
Must be at least one day in the past and not before 1999-01-01, otherwise the request fails with a 422 validation error
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-separated currency codes which you want to get (EUR,USD,CAD)
The array form currencies[]=EUR&currencies[]=USD is also accepted
By default all available currencies will be shown
type string Filter the returned currencies by type
Possible Values: fiat, metal, crypto
By default currencies of all types are returned

# 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"
    }
}