Skills/Currency Rates/Rate over a date range

Rate over a date range

0.1 credits / request

Retrieves a daily sequence of reference rates for a currency pair across a date range, suitable for charting exchange rate movements or computing averages, highs, and lows over a period. Only working days are included; weekends and holidays are absent from the series.

Use when

You want to chart a currency pair, or compute averages, highs, or lows across a period.

Not for

A single rate on one date (use a conversion operation), which is far smaller.

Cost

0.1 credits / request

What it accepts

Set these inside the intent when you run it.

start_daterequired

The start of the date range in year-month-day format.

end_daterequired

The end of the date range in year-month-day format.

from_currencyoptional

The ISO 4217 base currency code the series is quoted against. Defaults to EUR.

to_currencyoptional

One or more ISO 4217 target currency codes to include. Strongly recommended to keep the response compact.

What you get back

A date-keyed series of daily unit rates for the requested currency pair across the specified date range.

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":"timeseries","start_date":"2024-01-01","end_date":"2024-03-31","from_currency":"USD","to_currency":"GBP"}}'

Example requests

  • Show me the EUR to USD rate every day last month.
  • How did the GBP to JPY rate move in Q1 2024?
  • What were the daily USD to CHF rates from January to March 2023?