Convert currency
convert_currencyUse this when the user wants a currency converter or the currency exchange rate today, for example to convert usd to eur, euro to dollar, or the rate on date for any day back to 1999-01-04. It uses the European Central Bank euro reference rates (published on working days around 16:00 CET) and returns the converted amount, the rate, the inverse rate and the actual rate date, for up to 10 target currencies. Rates are indicative mid-market rates, not a bank or card rate, and there is no cryptocurrency. Do not use for crypto, metals or live market quotes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | One to ten ISO 4217 currency codes to convert to, separated by commas. Example: EUR or EUR,JPY,GBP. | |
| date | No | Optional rate date as YYYY-MM-DD (1999-01-04 or later, not in the future). Example: 2026-10-16. Omit for the latest published rate. | |
| from | Yes | The ISO 4217 currency code to convert from, e.g. USD. | |
| amount | Yes | The amount of money to convert, greater than 0 and up to 1e12, with at most 2 decimals. Example: 100.50. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | ||
| from | Yes | ||
| notes | Yes | ||
| rates | Yes | ||
| amount | Yes | ||
| source | Yes | ||
| decimals | Yes | ||
| converted | Yes | ||
| rate_date | Yes | ||
| source_url | Yes | ||
| inverse_rates | Yes | ||
| retrieved_utc | Yes | ||
| date_requested | Yes |