Tools/currency

Currency Rates

Active

Models guess exchange rates from old training data; this returns reference rates for any date.

4 tools

Foreign-exchange reference rates: convert between currencies, look up a historical rate for any date, or pull a time series. Sourced from European Central Bank reference rates.

Finance & Marketscurrencyexchange-ratesforexfxconversion

Tools (4)

▶historical

Exchange rates as published on a specific past date.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“What was the USD to EUR rate on 2024-01-02?”
“Convert 500 GBP to USD at the 2023-06-15 rate”
“Historical EUR to JPY rate for 2022-12-30”

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.

API Usage

curl -X POST "https://skill.askfaro.com/skills/currency/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "What was the USD to EUR rate on 2024-01-02?"
  }
}'

CLI Usage

askfaro describe currency/historical

Install pip install askfaro-cli, then askfaro auth login.

▶currencies

List every supported currency and its full name.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“What currencies are supported?”
“List all available currency codes”
“Is the Thai baht supported?”

API Usage

curl -X POST "https://skill.askfaro.com/skills/currency/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "What currencies are supported?"
  }
}'

CLI Usage

askfaro describe currency/currencies

Install pip install askfaro-cli, then askfaro auth login.

▶latest

Latest exchange rates for one base currency against one or more target currencies.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Convert 100 USD to EUR”
“What's the current GBP to JPY exchange rate?”
“Show me USD rates against EUR, GBP, and CHF”
“How many euros is 250 dollars?”

Parameters

basestringoptionaldefault: "EUR"

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

amountnumberoptionaldefault: 1

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

symbolsstringoptional

Comma-separated target currencies, ISO 4217 (e.g. "EUR,GBP,JPY"). Omit for all.

API Usage

curl -X POST "https://skill.askfaro.com/skills/currency/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Convert 100 USD to EUR"
  }
}'

CLI Usage

askfaro describe currency/latest

Install pip install askfaro-cli, then askfaro auth login.

▶timeseries

Daily exchange rates across a date range, for charting or trend analysis.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Show the USD to EUR rate for January 2024”
“How did GBP to USD move between 2023-01-01 and 2023-03-31?”
“Daily EUR to JPY rates for the last quarter”

Parameters

endstringrequired

Range end date, YYYY-MM-DD.

basestringoptionaldefault: "EUR"

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

startstringrequired

Range start date, YYYY-MM-DD.

symbolsstringoptional

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

API Usage

curl -X POST "https://skill.askfaro.com/skills/currency/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Show the USD to EUR rate for January 2024"
  }
}'

CLI Usage

askfaro describe currency/timeseries

Install pip install askfaro-cli, then askfaro auth login.