> ## 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.

# Historical rates

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

<ParamField path="date" type="string" required>
  The requested date in `YYYY-MM-DD` format (e.g., `2023-12-25`).
</ParamField>

<ParamField path="base" type="string" optional>
  The currency code of the base currency to quote rates against (e.g., `USD`). If not provided, defaults to the system base currency.
</ParamField>

<ParamField path="symbols" type="string" optional>
  A comma-separated list of currency codes to limit the response to (e.g., `EUR,GBP,JPY`). If omitted, all available currencies are returned.
</ParamField>

### Response

<ResponseField name="timestamp" type="string" required>
  The Unix timestamp (epoch) for the returned data.
</ResponseField>

<ResponseField name="base" type="string" required>
  The base currency used for the exchange rates.
</ResponseField>

<ResponseField name="rates" type="object" required>
  An object containing key-value pairs of currency codes and their corresponding exchange rates.
</ResponseField>