Loading
Loading
Retrieve day-by-day historical exchange rates for a custom date range. Returns a list of daily rate snapshots for all requested currency symbols, ordered chronologically.
startDate is required (YYYY-MM-DD). endDate defaults to yesterday if omitted. Pass symbols to filter specific currencies and base to change the base currency (default: USD).
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
startDate is required. All other parameters are optional. The maximum date range is 1 year (365 days).
formatoptionalStringdefault: jsonResponse format: `json` (default) or `xml`.
startDaterequiredStringStart date in `YYYY-MM-DD` format. Required. Must be on or before yesterday.
endDateoptionalStringdefault: YesterdayEnd date in `YYYY-MM-DD` format. Defaults to yesterday. Maximum range is 1 year (365 days).
baseoptionalStringdefault: USDBase currency code. Defaults to `USD`. Supports fiat, crypto, and metals.
symbolsoptionalArrayComma-separated currency codes. Omit to get all available rates.
A successful request returns 200 OK with a chronological list of daily exchange rate snapshots.
startDateStart date of the time series interval (YYYY-MM-DD).
endDateEnd date of the time series interval (YYYY-MM-DD).
baseBase currency code. Always uppercase.
date (String), rates (Object)
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
You can only retrieve time series data for a maximum interval of 1 Year
Starting date cannot be after current date or ending date
Provided Dates are in Invalid Format. Dates must be in a valid format YYYY-MM-DD!
Rates of provided base and symbols are not found for given intervals.