Fx Get Rate
fx_get_rateGet the exchange rate for a currency pair on a given date (default: latest). Returns the rate, the actual rate date (the prior published date when none was published for the requested date), and source provenance. Cross-rates are triangulated through EUR automatically. A same-currency pair returns a rate of 1, dated to the same publication day any other pair would report for that date. Use fx_convert_currency when you want the converted amount; use this tool when you only need the rate number.
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>"
},
"name": "fx_get_rate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | ISO 8601 date (YYYY-MM-DD). Omit for the latest available rate. Frankfurter v1 data starts 1999-01-04. Future dates are not supported. | |
| base_currency | Yes | ISO 4217 base currency code (e.g. USD). Call fx_list_currencies to get valid codes. | |
| quote_currency | Yes | ISO 4217 quote currency code (e.g. EUR). The rate is expressed as "how many quote units per 1 base unit". Call fx_list_currencies to get valid codes. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rate | No | Exchange rate: 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 returned. | |
| rate_type | No | Always "Daily rate (Frankfurter v1)" — these are reference rates, not tradeable bid/ask. | |
| 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. | |
| base_currency | No | The base currency code. | |
| quote_currency | No | The quote currency code. |