Tools/currency/historical

currency/historical

Exchange rates as published on a specific past date.

0.1 credits / call ($0.0001)
charged on success

What it does

Returns the foreign-exchange reference rates that were published on a given date, for a base currency against one or more targets.

Primary use cases

  • Valuing a past transaction at the rate that applied on its date.
  • Backfilling historical conversions for reports or reconciliations.
  • Answering "what was the rate on <date>" without manual lookups.

Good to know

Rates are published on working days only; requesting a weekend or holiday returns the most recent prior publication. History reaches back decades.

Parameters

basestringoptionaldefault: "EUR"

Base currency, ISO 4217 code (e.g. USD). Defaults to EUR.

datestringrequired

Date in YYYY-MM-DD format.

amountnumberoptionaldefault: 1

Amount of the base currency to convert. Defaults to 1.

symbolsstringoptional

Comma-separated target currencies, ISO 4217. Omit for all.

currency/historical — Faro