fx_convert
Convert one amount with ECB reference rates and explicit date resolution.
Description
Convert one amount with ECB reference rates and explicit date resolution.
Choose this for one amount on one requested or latest date; use
fx_get_rates for fixing history or a rate series. Example:
fx_convert(amount="1000", from_currency="USD", to_currency="EUR", date="2026-08-07").
EUR pairs use the published fixing directly (or its inverse); currency
cross-rates triangulate through EUR and are flagged derived: true.
The scalar envelope echoes amount/currencies/requested_date/rate_date,
exact rate, six-decimal converted amount, units, currency, as_of, ECB
attribution and derivation statement. Errors use bad_parameter or
out_of_coverage. ECB reference rates are published for information
purposes only; using them for transaction purposes is strongly
discouraged. They are not transaction or execution prices.
Parameters
Input schema advertised to MCP clients and mirrored by the REST query string.
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| amount | number | string | Yes | — | — | Exact decimal amount to convert; never parsed as a float. |
| from_currency | string | Yes | — | — | ISO 4217 source currency. |
| to_currency | string | Yes | — | — | ISO 4217 destination currency. |
| date | string (date) | null | No | null | — | Requested fixing date. A weekend or holiday resolves to the newest prior fixing and the payload echoes requested_date and rate_date. Omit for latest. |
Provenance
Sources behind every value this tool returns.
- ecbEuropean Central Bank
Dataset registry: fx_rates