Loading
Loading
Convert currency amounts using exchange rates from a specific historical date. Ideal for backdated financial calculations, accounting reconciliation, and tax reporting.
from, to, and date are required. The amount parameter defaults to 1. Date must be in YYYY-MM-DD format.
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.
from, to, and date are required. Amount is optional.
formatoptionalStringdefault: jsonResponse format: `json` (default) or `xml`.
fromrequiredStringSource currency code. Required. Supports fiat, crypto, and metals.
torequiredStringTarget currency code. Required. Supports fiat, crypto, and metals.
amountoptionalStringdefault: 1Amount to convert as a positive decimal. Defaults to `1`.
daterequiredStringHistorical date in `YYYY-MM-DD` format. Required. Must fall within the supported data range.
A successful request returns 200 OK with the converted amount using rates from the specified date.
dateTimestamp of when the rate was recorded (UTC, with timezone offset).
fromSource currency code.
toTarget currency code.
rateExchange rate from the source to the target currency.
givenAmountThe amount provided for conversion (as string).
convertedAmountThe converted amount in the target currency.
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.
Invalid Amount. Please provide amount in decimal format and greater than 0!
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!