Dollar to Shekel Converter

Purpose: This tool provides a reliable USD to ILS currency conversion for individuals and organizations performing budgeting, pricing, or travel planning. It serves travelers, exporters, freelancers, small businesses, and e-commerce operators who need quick, precise exchange figures without reliance on manual rate lookups. The converter handles two currencies (USD and ILS) but is designed to scale to additional pairs in future iterations. It returns the equivalent amount in ILS by applying the latest available rate, rounded consistently to two decimals for straightforward accounting and reporting. Core Logic & Features: The system retrieves a live USD/ILS rate from a reputable FX data feed, optionally using a historical date to fetch a rate for past days. It computes: amount_in_ILS = amount_in_USD * rate_USD_to_ILS, then formats the result with two decimals and includes the rate used and timestamp in outputs. It validates inputs (non-negative numeric amount) and handles missing or stale data by reporting rate unavailability. The tool does not add fees or spreads, delivering a clean mid-market rate for transparency. Inputs & Outputs: Required inputs include amount_usd (number, USD) and optional date (ISO 8601) to fetch historical rate; outputs include converted_ils (number, ILS), rate_used (number), and timestamp (ISO 8601). Optional localization flag may control formatting. Algorithms & Calculations: Uses a standard multiplicative conversion with rate_usd_to_ils from a live FX feed. If a date is provided, a historical rate is retrieved; otherwise the latest rate is used. Rounding is to two decimals. Error & Edge Cases: If amount is invalid or rate data is unavailable, the tool returns a structured error with a code and suggested retry window. Negative amounts are rejected with a validation error; historical date requests must be within supported history window. Industry/Region & Localization: ISO 4217 currency codes USD and ILS; formatting uses two decimals and locale-aware thousands separators when applicable. Assumptions & Exclusions: Assumes rate data reflects mid-market values without fees or markups; historic rates are sample for past days only if supported by data provider; not a financial advisory tool.