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