IDR Currency Converter

The tool converts Indonesian Rupiah (IDR) to other currencies using live exchange rates, enabling quick pricing, budgeting, invoicing, and travel planning for individuals, freelancers, small businesses, and cross-border sellers. Users typically need a local IDR figure converted to USD, EUR, SGD, JPY, or other currencies for quotes, client billing, or cost projections.

The system relies on live market rates to compute cross-currency amounts from IDR. Required inputs: amount_in_idr (number, non-negative), target_currency (string, ISO 4217). Optional inputs: date (ISO 8601) for a historical rate, locale (string) for formatting, and include_fees (boolean) to indicate whether to apply or display margins (default false). Features include real-time rate lookup; cross-rate computation when no direct IDR→T pair exists via a common base currency; two-decimal precision by default; locale-aware formatting when locale is provided; and a simple, export-ready result containing the numeric value, rate used, and timestamp. The tool handles multiple currencies in a single pass and supports reverse conversion if needed by swapping inputs. It also returns a formatted string suitable for quotes and invoices without exposing backend mechanics.

Algorithms and calculations use the mid-market rate IDR→T from a live feed. If no direct rate exists, a cross-rate via USD or another base currency is computed. The conversion is amount_in_idr × rate_IDR_T and is rounded to two decimals. Output formatting respects locale when provided; otherwise a standard two-decimal format is used.

Error handling covers missing inputs, invalid currency codes, rate outages with fallback to cached values within 24 hours, and validation of date or locale inputs. Assumptions include mid-market pricing and no inclusion of fees or taxes.