Exchange rate history
rate_historyUse this when the user asks for an exchange rate history or a historical exchange rate, or the conversion of currency data over a date range, or wants a CSV of rates. It returns the daily European Central Bank euro reference rates for up to 5 quote currencies over at most 366 days, with min, max, average and the first-to-last change in percent, plus a CSV download and a line chart in the widget. It shows published working days only (no weekends or ECB holidays) and is not financial advice. Do not use for stocks, crypto or commodity prices.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"base": "<base>",
"quote": "<quote>",
"start": "<start>",
"end": "<end>"
},
"name": "rate_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | The last date of the range as YYYY-MM-DD, at most 366 days after start. Example: 2026-03-31. | |
| base | Yes | The ISO 4217 code of the base currency, e.g. USD. Rates are per 1 unit of this currency. | |
| quote | Yes | One to five ISO 4217 quote currency codes, separated by commas. Example: EUR or EUR,JPY. | |
| start | Yes | The first date of the range as YYYY-MM-DD. Example: 2026-01-01. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | ||
| base | Yes | ||
| notes | Yes | ||
| start | Yes | ||
| stats | Yes | ||
| quotes | Yes | ||
| source | Yes | ||
| downloads | Yes | ||
| source_url | Yes | ||
| preview_rows | Yes | ||
| retrieved_utc | Yes | ||
| published_days | Yes |