fx_get_rates

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.