Fx Convert Currency
fx_convert_currencyConvert an amount between any two currencies at the latest or a historical rate. Returns the converted amount, the rate used, the actual rate date, and whether the date was snapped to the prior published date. Cross-rates are triangulated through EUR automatically.
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_currency": "<base_currency>",
"quote_currency": "<quote_currency>",
"amount": "<amount>"
},
"name": "fx_convert_currency"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | ISO 8601 date (YYYY-MM-DD) for a historical rate. Omit for the latest available rate. Frankfurter v1 data starts 1999-01-04. Future dates are not supported. | |
| amount | Yes | Amount in the base currency to convert. Must be greater than zero. | |
| base_currency | Yes | ISO 4217 source currency code (e.g. USD). Call fx_list_currencies to get valid codes. | |
| quote_currency | Yes | ISO 4217 target currency code (e.g. EUR). The amount will be expressed in this currency. Call fx_list_currencies to get valid codes. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rate | No | Exchange rate used: units of quote currency per 1 unit of base currency. | |
| error | No | Present when the call failed. Absent on success. | |
| source | No | Always "Frankfurter v1" — the upstream data provider. | |
| rate_date | No | Actual date of the rate used for conversion. | |
| rate_type | No | Always "Daily rate (Frankfurter v1)" — these are reference rates, not tradeable bid/ask. | |
| base_amount | No | The input amount in the base currency. | |
| date_snapped | No | True when rate_date differs from the requested date: the requested date was a weekend or holiday, or its daily fix was not yet published. Frankfurter v1 snaps such requests to the prior published date. Always false when date is omitted. | |
| quote_amount | No | The unrounded amount × rate product in the quote currency, using JavaScript floating-point precision; no currency minor-unit rounding policy is applied. | |
| base_currency | No | Source currency code. | |
| quote_currency | No | Target currency code. |