# fx_convert Convert one amount with ECB reference rates and explicit date resolution. | Field | Value | | --- | --- | | Category | Foreign Exchange (`fx`) | | Exposure | public | | MCP tool | `fx_convert` | | Documentation | https://www.agentdatasets.com/docs/tools/fx_convert | ## 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. | Parameter | In | Type | Required | Default | Constraints | Description | | --- | --- | --- | --- | --- | --- | --- | | amount | input | `number \| string` | yes | — | — | Exact decimal amount to convert; never parsed as a float. | | from_currency | input | `string` | yes | — | — | ISO 4217 source currency. | | to_currency | input | `string` | yes | — | — | ISO 4217 destination currency. | | date | input | `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 - `ecb` — European Central Bank, Ten curated ECB key-interest-rate, €STR, and euro-area AAA central-government yield-curve spot-rate series (ECB information reuse terms (ecb-reuse)). See https://www.agentdatasets.com/docs/attribution.md Dataset registry: `fx_rates`.