Loading
Loading
Retrieve exchange rates for any past date for 171+ fiat currencies and 830+ cryptocurrencies. Pass a specific date along with optional base and symbol filters.
The date parameter is required in YYYY-MM-DD format and must fall within the supported historical data range. Use base to change the base currency (default: USD) and symbols to filter specific currencies.
Authorize every request with your API key, passed either as a header or as a query parameter:
X-apiKeyapiKeyThis is version v1.0 of the API.
date is required. All other parameters are optional.
formatoptionalStringdefault: jsonResponse format: `json` (default) or `xml`.
baseoptionalStringdefault: USDBase currency code. Defaults to `USD`. Supports fiat, crypto, and metals.
symbolsoptionalArrayComma-separated currency codes. Omit to get all available rates.
daterequiredStringHistorical date in `YYYY-MM-DD` format. Must fall within the supported data range.
A successful request returns 200 OK with exchange rates for the requested date.
dateHistorical date in `YYYY-MM-DD` format.
baseBase currency code. Always uppercase.
Map of currency codes to exchange rate strings for the requested date.
Besides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.
X-Concurrent-Threadsheaderconcurrency-limited endpointsSpecifies the maximum number of concurrent requests allowed.
X-Concurrent-Threads-Activeheaderconcurrency-limited endpointsIndicates the number of active concurrent requests being processed.
X-AF-Credits-Costheaderall responsesSpecifies the number of credits consumed by the current request.
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
Provided Date [DATE] is in invalid format. It should be like YYYY-MM-DD!
Rates of provided date [DATE] are not available in our database.
Rates of provided currency [CURRENCY_CODE] are not available in our database!
Rates of provided Symbols are not available in our database!