Skills/Currency Rates/Rate on a past date

Rate on a past date

0.1 credits / request

Returns the published reference rate or finished currency conversion for a specific past date. Useful for valuing historical transactions, auditing past invoices, or checking what a rate was on a particular day. If the requested date is a weekend or holiday, the closest prior working day's rate is returned along with its actual date.

Use when

You want to value a past transaction or look up the rate that applied on a given date.

Not for

The latest rate (use the conversion operation) or a series across many dates (use the time series).

Cost

0.1 credits / request

What it accepts

Set these inside the intent when you run it.

daterequired

The past date to look up, in year-month-day format.

from_currencyoptional

The ISO 4217 code of the source currency. Defaults to EUR.

to_currencyoptional

One or more ISO 4217 target currency codes. Omit to return all supported currencies.

amountoptional

The amount of the source currency to convert. Defaults to 1 (returns a unit rate).

What you get back

Converted amount or unit rates as published on the requested date (or the closest prior working day), with the actual publication date.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Currency Rates skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/currency/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"historical","date":"2024-01-15","from_currency":"USD","to_currency":"GBP","amount":500}}'

Example requests

›What was 500 USD worth in EUR on March 15, 2023?
›What was the GBP to USD rate on January 1, 2024?
›How much was 10000 JPY in CHF on the last day of 2022?

← Back to Currency Rates