Skip to main content
GET
historical
/
{date}
Historical rates
curl --request GET \
  --url https://api.xchangeapi.com/historical/{date} \
  --header 'api-key: <api-key>'
{
  "timestamp": "<string>",
  "base": "<string>",
  "rates": {}
}

Documentation Index

Fetch the complete documentation index at: https://xchangeapi.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve historical exchange rates for a specific date. This endpoint allows you to access past market data for all available currencies, which is essential for auditing, backtesting trading strategies, or historical analysis. The returned data reflects the market state at the close of the requested day.

​
Query parameters

​
date
string
required
The requested date in YYYY-MM-DD format (e.g., 2023-12-25).
​
base
string
The currency code of the base currency to quote rates against (e.g., USD). If not provided, defaults to the system base currency.
​
symbols
string
A comma-separated list of currency codes to limit the response to (e.g., EUR,GBP,JPY). If omitted, all available currencies are returned.

​
Response

​
timestamp
string
required
The Unix timestamp (epoch) for the returned data.
​
base
string
required
The base currency used for the exchange rates.
​
rates
object
required
An object containing key-value pairs of currency codes and their corresponding exchange rates.