# Currency Rates

> Skill `currency` on Faro. 4 sub-skills.

Converts amounts between currencies and retrieves published reference exchange rates. Covers major and minor fiat currencies with rates sourced once per working day. Supports single conversions, historical lookups, and multi-day series for charting or trend analysis.

**Category:** Finance & Markets  
**Tags:** currency, exchange-rates, forex, fx, conversion  
**Use when:** You need an exchange rate or a currency conversion grounded in published reference rates instead of a guessed number.  
**Not for:** Live trading or dealer spreads, crypto prices, intraday or real-time tick rates, or rates for currencies outside the supported list.  
**Returns:** information — Returns the converted amounts or rates with the actual publication date they came from, which may be an earlier working day than the date you asked for. Not a downloadable file.

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/currency/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"What currencies can you convert?"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run currency "What currencies can you convert?"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- What currencies can you convert?
- How much is 1000 USD in EUR right now?
- What was 500 USD worth in EUR on March 15, 2023?
- Show me the EUR to USD rate every day last month.

## Sub-skills

### List currencies

Lists every supported currency and its full name.

**Cost:** 0.1 credits / request

**Use when:** You want to see which currencies can be converted, or to check a code is valid before converting.

**Details:** https://askfaro.com/llms/skills/currency/list_currencies.md

---

### Convert at the latest rate

Converts an amount between currencies at the latest rate, or returns a board of latest rates.

**Cost:** 0.1 credits / request

**Use when:** You want today's rate or a conversion at the most recent published rate.

**Details:** https://askfaro.com/llms/skills/currency/convert.md

---

### Rate on a past date

Converts an amount or reads the rate exactly as published on a specific past date.

**Cost:** 0.1 credits / request

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

**Details:** https://askfaro.com/llms/skills/currency/historical.md

---

### Rate over a date range

Pulls a daily rate series across a date range for charting or trend analysis.

**Cost:** 0.1 credits / request

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

**Details:** https://askfaro.com/llms/skills/currency/timeseries.md

---

---
On the web: https://askfaro.com/search/currency