# fx_get_rates Get daily ECB euro reference rates or EUR-triangulated cross-rates. | Field | Value | | --- | --- | | Category | Foreign Exchange (`fx`) | | Exposure | public | | MCP tool | `fx_get_rates` | | Documentation | https://www.agentdatasets.com/docs/tools/fx_get_rates | ## Description Get daily ECB euro reference rates or EUR-triangulated cross-rates. Choose this for fixing history or a rate series; use `fx_convert` to convert one amount on one requested or latest date. `data` carries `base`, `quote`, `unit`, `currency`, and `rates`; each rate has `date`, exact Decimal-string `value`, observation `as_of`, and `derived`. `meta` carries `source`, page-level `as_of`, ECB `attribution`, and nullable `derived_method`; `pagination` carries `limit`, `has_more`, and `next_cursor`. Published EUR pairs have `derived: false`; non-EUR pairs use `quote_per_eur / base_per_eur`, are flagged `derived: true`, and name the method in `meta.derived_method`. The default is 100 rates and the maximum is 500. Pass `pagination.next_cursor` back as `cursor`; stop when `pagination.has_more` is false. `bad_parameter` covers an unsupported currency, reversed date window, out-of-range limit, or malformed cursor. Example: `fx_get_rates(base="EUR", quote="USD", start="2026-08-01", end="2026-08-07", limit=100)`. 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 | | --- | --- | --- | --- | --- | --- | --- | | quote | input | `string` | yes | — | — | Required ISO 4217 quote currency, e.g. USD or GBP. | | base | input | `string` | no | "EUR" | — | ISO 4217 base currency. Defaults to EUR. | | start | input | `string (date) \| null` | no | null | — | Inclusive first fixing date; omit for full available history. | | end | input | `string (date) \| null` | no | null | — | Inclusive last fixing date; omit for the latest fixing. | | limit | input | `integer` | no | 100 | min 1, max 500 | Rates, newest first (1–500). | | cursor | input | `string \| null` | no | null | — | Opaque pagination.next_cursor from the previous response. | ## 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`.