USD to EUR Converter

Purpose & User Intent: This tool provides precise USD-to-EUR conversions using real-time or historical FX data. It serves pricing, budgeting, invoicing, treasury, and software integration use cases where EUR amounts must be derived from USD values. Typical users include pricing analysts, ecommerce teams, travel planners, accountants, and developers embedding currency conversion into financial workflows.
Core Logic & Features: Required inputs are amount_usd (numeric, USD), target_currency (EUR), rate_source (latest or historical), and optional date (YYYY-MM-DD for historical). Outputs are converted_amount (EUR) and rate_used (EUR per USD) plus a timestamp. Advanced capabilities include optional support for additional currencies in future and rate caching. Validation enforces amount > 0 and that target_currency is EUR. If rate_source is latest, the latest available EUR/USD rate is retrieved; if historical, the rate for the given date is used. If the rate cannot be retrieved, the tool returns an error and may fall back to the last known rate when available.
Inputs & Outputs: inputs include amount_usd, target_currency, rate_source, and date; outputs include converted_amount, rate_used, timestamp. Algorithms & Calculations: The conversion uses rate_used from fetch_rate(currency='EUR', date=provided OR latest); converted_amount = amount_usd * rate_used; outputs are rounded to two decimals for amount and four decimals for rate. Error & Edge Cases: Missing or invalid inputs yield validation errors; negative amounts are rejected; historical date in the future or invalid format triggers validation error; rate fetch failures degrade gracefully with an error code and optional fallback to last known rate. Industry/Region & Localization: ISO codes USD and EUR are used; rates are typically EUR per USD; outputs use two decimals; UTC reference; no regional UI assumptions. Assumptions & Exclusions: Assumes a trusted FX data source; excludes conversion fees, cross-border taxes, and multi-currency quotes beyond USD/EUR in this version; not responsible for settlement rules.